> ## Documentation Index > Fetch the complete documentation index at: https://docs.crmspark.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Automações > Monte fluxos que rodam sozinhos quando algo acontece nas conversas: gatilhos, filtros, blocos do editor e como as automações convivem com o agente de IA. Uma automação é um fluxo que o Spark executa sozinho quando um evento acontece em uma conversa: um chat novo chega, o cliente manda mensagem, o atendimento é finalizado, o lead faz aniversário. O fluxo pode enviar mensagens, esperar a resposta do cliente, distribuir a conversa para alguém do time, mudar etiquetas e etapa do funil, entre outras ações. As automações ficam em [Automações](https://crmspark.com.br/dash/automations). Para cadências simples de reengajamento, medidas em dias, veja também [Follow-ups](https://docs.crmspark.com.br/conceitos/follow-ups.md). > [!NOTE] > > Criar, editar, ativar, desativar e remover automações exige o cargo de administrador na organização. Os demais membros podem abrir a lista e consultar os fluxos. ## Como uma automação é formada Toda automação tem três partes: 1. Gatilho: o evento que inicia o fluxo, como "Chat criado" ou "Mensagem recebida". Uma automação pode ter mais de um gatilho. 2. Filtros (opcionais): condições que a conversa precisa cumprir para o fluxo rodar, como "Plataforma do chat é WhatsApp Business" ou "Tags tem algum: VIP". 3. Fluxo: a sequência de blocos (nodes) ligados por setas, do bloco inicial até um bloco "Fim". Na tela de criação, essas partes ficam em duas abas: "Editor de fluxo" e "Gatilhos e filtros". ## Criar uma automação **1. Abra a criação** Em [Automações](https://crmspark.com.br/dash/automations), clique em "Criar automação". **2. Dê um nome** Preencha "Nome" (obrigatório, único na organização) e, se quiser, uma descrição para o time entender o objetivo do fluxo. **3. Monte o fluxo** Na aba "Editor de fluxo", arraste blocos do painel "Nodes" para a área de trabalho. Ligue a saída de um bloco (à direita) à entrada do próximo. Para configurar um bloco, clique no ícone de engrenagem dele. **4. Configure o gatilho** Na aba "Gatilhos e filtros", clique em "Adicionar gatilho", escolha o evento e indique em qual bloco o fluxo começa ("Node de início"). **5. Salve** Clique em "Salvar automação". Se houver algum problema na estrutura, o Spark mostra o erro acima das abas. A automação começa ativa assim que é salva. Para pausar, use o menu da linha na lista e escolha "Desativar". Desativar ou remover uma automação também cancela as execuções que estavam em andamento ou aguardando. > [!TIP] > > No editor, o botão "Gerar com IA" monta um fluxo a partir de uma descrição em texto ("Quando um chat novo chegar pelo Instagram, dar boas-vindas e distribuir entre Ana e Bruno"). Você pode limitar a quantidade de blocos e sugerir um evento. O resultado substitui o fluxo, os gatilhos e as conexões que estiverem no editor, e nada é salvo até você clicar em salvar. Revise o fluxo gerado antes de ativar. ## Gatilhos | Gatilho | Quando dispara | Opções | | - | - | - | | Mensagem recebida | Chega uma mensagem na conversa. | "Cooldown (minutos)": intervalo mínimo entre duas execuções na mesma conversa (padrão de 1 minuto). | | Chat criado | Uma conversa nova é criada. Roda uma vez por conversa. | "Tipo de chat": todos, só conversas individuais (DM) ou só grupos. | | Chat atualizado | Algum dado da conversa muda (etiquetas, etapa, responsável etc.). | — | | Chat finalizado | O status da conversa muda para "Concluído". | — | | Lead criado | Um contato novo é cadastrado. Roda para cada conversa individual desse contato. | — | | Inatividade | A conversa está "Em andamento", a última mensagem foi do time (ou de uma automação) e o cliente não respondeu dentro do tempo definido. | "Inatividade (min)", com mínimo de 5 minutos, e uma margem de tolerância opcional. | | Aniversário | No dia do aniversário do lead, ao meio-dia. Usa a conversa individual com mais mensagens em cada canal. | Ponto de entrada preferido. | Todo gatilho aceita "Executar após (opcional)": um atraso em minutos entre o evento e o início do fluxo, com máximo de 90 dias. É o que permite, por exemplo, mandar uma pesquisa de satisfação dois dias depois que o atendimento foi finalizado. Se o mesmo evento acontecer de novo antes do fluxo começar, a execução agendada é substituída pela mais recente. ### Filtros Clique em "Habilitar filtros" no gatilho, escolha se todas as condições precisam ser verdadeiras ("Todas as condições (E)") ou basta uma ("Qualquer condição (OU)") e adicione as regras. Você pode filtrar por plataforma, status, monetização, ponto de entrada (o número ou perfil conectado), etapa do funil, link de rastreamento, se é grupo, se já foi respondida, etiquetas, usuário atribuído, quantidade de participantes, contato, data de nascimento, data da última mensagem e data da última atualização. Os operadores mudam conforme o tipo do campo: texto aceita "Contém", "Começa com", "Está na lista" e outros; números e datas aceitam "Maior que", "Entre" e similares; etiquetas aceitam "Tem algum", "Tem todos" e "Não tem nenhum". ## Blocos do editor | Bloco | O que faz | Saídas | | - | - | - | | Mensagem | Envia um texto livre ou um [modelo de mensagem](https://docs.crmspark.com.br/conceitos/modelos-de-mensagem.md). Se o modelo tiver variáveis manuais, você preenche os valores no próprio bloco. | Uma | | Mensagem IA | A IA lê as últimas mensagens da conversa e escreve uma mensagem seguindo as instruções que você deu no bloco. | Uma | | Condição | Verifica um campo da conversa (mesmos campos e operadores dos filtros). | "Sucesso" e "Falha" | | Randomizador | Escolhe um dos caminhos ao acaso, com chances iguais. Útil para testar duas mensagens diferentes. | Uma por opção (mínimo de duas) | | Validação | Pausa o fluxo e espera a resposta do cliente. Cada resposta esperada ("1", "Sim", "Não") vira um caminho. | Uma por resposta esperada, mais "Falha" | | Roleta de Agentes | Atribui a conversa a uma pessoa do time. | Uma | | Espera | Aguarda um tempo antes de seguir, até 1 dia. | Uma | | Atualizar Chat | Muda dados da conversa: nome, status, monetização, ponto de entrada, funil e etapa, etiquetas, responsável e posição na lista. | Uma | | Fim | Encerra o fluxo. Todo fluxo precisa de pelo menos um. | Nenhuma | ### Validação: esperar a resposta do cliente O bloco Validação é o que permite montar menus simples ("Responda 1 para vendas ou 2 para suporte"). Na configuração você define: * As respostas esperadas, uma por caminho. * Se maiúsculas e minúsculas importam e se a resposta precisa ser exatamente igual ou só conter o texto. * Quanto tempo esperar (ou esperar sem limite). Sem resposta no prazo, o fluxo segue pela saída "Falha". * O que fazer com uma resposta inválida: seguir para "Falha" ou mandar uma mensagem de erro e esperar de novo. A resposta do cliente é capturada mesmo quando o [agente autônomo](https://docs.crmspark.com.br/spark-ia/agente.md) está ligado. Teste o menu com respostas reais antes de ativar: opções curtas e numeradas evitam ambiguidade. ### Roleta de Agentes: distribuir conversas No bloco você escolhe as pessoas que podem receber conversas e, opcionalmente, um agente de reserva. A conversa vai para quem tem menos chats atribuídos no dia. Se ninguém da lista estiver ativo, a conversa vai para o agente de reserva. O passo a passo completo está em [Receber chats, distribuir e filtrar](https://docs.crmspark.com.br/guia/atendimento-distribuicao-filtros.md). ### Janela de 24 horas No WhatsApp Business (API oficial) e no Instagram, mensagens de texto livre só saem se o cliente escreveu nas últimas 24 horas. Fora dessa janela, use um modelo oficial aprovado no bloco Mensagem. Veja [Modelos de mensagem](https://docs.crmspark.com.br/conceitos/modelos-de-mensagem.md). ## Regras de estrutura O Spark valida o fluxo ao salvar. Os erros mais comuns: * Falta um gatilho ou um bloco "Fim". * Algum bloco (exceto "Fim") ficou sem conexão de saída. * O gatilho começa direto em um bloco "Fim". * O fluxo tem um ciclo: uma seta volta para um bloco anterior. Loops não são permitidos. Use "Organizar fluxo" para reorganizar os blocos automaticamente quando o desenho ficar confuso. ## Como as execuções funcionam * O fluxo só roda se a automação estiver ativa, a organização tiver assinatura ativa e os filtros forem atendidos. * Uma conversa só tem uma execução por vez de cada automação e gatilho. Se o mesmo evento acontecer enquanto o fluxo ainda está rodando (ou esperando em uma Validação ou Espera), o novo evento é ignorado. * Entre execuções concluídas na mesma conversa há um intervalo mínimo. No gatilho "Mensagem recebida" é o cooldown que você configura; nos demais, o Spark aplica intervalos curtos para evitar disparos duplicados. ## Automações e o agente de IA Quando o [agente autônomo](https://docs.crmspark.com.br/spark-ia/agente.md) está ligado e assume a resposta a uma mensagem do cliente, as automações com gatilho "Mensagem recebida" não rodam para aquela mensagem. Isso evita que a IA e a automação respondam ao mesmo tempo. Os outros gatilhos (Chat criado, Inatividade, Chat finalizado etc.) continuam funcionando normalmente. Por isso, para distribuir conversas novas com o agente ligado, use o gatilho "Chat criado". > [!WARNING] > > Uma automação ativa age em todas as conversas que passam pelos filtros. Comece com filtros restritos (uma etiqueta de teste, por exemplo), confira o resultado em uma conversa real e só depois amplie. ## Exemplos > **Boas-vindas e distribuição** > > Gatilho "Chat criado" com "Tipo de chat: DM". Fluxo: Mensagem (boas-vindas) → Roleta de Agentes → Fim. > **Menu de atendimento** > > Gatilho "Chat criado". Fluxo: Mensagem ("Responda 1 para vendas ou 2 para suporte") → Validação com respostas "1" e "2". Caminho "1": Atualizar Chat (etiqueta Vendas, etapa do funil comercial) → Fim. Caminho "2": Atualizar Chat (etiqueta Suporte) → Roleta de Agentes com o time de suporte → Fim. Saída "Falha": Fim. > **Pesquisa depois do atendimento** > > Gatilho "Chat finalizado" com "Executar após" de 2880 minutos (dois dias). Fluxo: Mensagem com um modelo oficial de pesquisa → Fim. > **Lembrete para conversas paradas** > > Gatilho "Inatividade" de 240 minutos, com filtro "Status do chat: Em andamento". Fluxo: Mensagem IA ("Retome a conversa de forma educada, sem pressionar") → Fim. ## Relacionado * [Follow-ups](https://docs.crmspark.com.br/conceitos/follow-ups.md): cadências em dias, com respeito ao horário de atendimento. * [Receber chats, distribuir e filtrar](https://docs.crmspark.com.br/guia/atendimento-distribuicao-filtros.md): o fluxo de distribuição mais usado. * [Modelos de mensagem](https://docs.crmspark.com.br/conceitos/modelos-de-mensagem.md): conteúdo reaproveitável e variáveis. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.