# Agilize Docs para IA - Página atual

Este arquivo contém uma versão focada e legível por IA da página aberta na documentação pública da Agilize.
Use esta versão quando a pergunta do usuário estiver restrita ao documento atual.

Última geração: 2026-05-28T23:50:58.661Z

## Página

- Título: Automações de CRM
- URL humana: https://agilize.app/docs/configuracao/fluxos-automacoes/automacoes-de-crm
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Como criar, testar, ativar, pausar e auditar automações de CRM para oportunidades, contatos, empresas, tarefas, tags, responsáveis e mensagens.

## Seções

- Premissas de disparo
- Onde configurar
- Quando usar
- Campos da automação
- Entidades e eventos
- Estrutura recomendada
- Condições
- Ações disponíveis

## Conteúdo da página

# Automações de CRM

Automações de CRM executam ações quando uma oportunidade, contato ou empresa é criada ou atualizada por uma origem válida. Elas ajudam a padronizar distribuição, tarefas, tags, mensagens, movimentação de etapa, integração com outros sistemas e acompanhamento comercial.

Use automações para reduzir trabalho repetitivo, não para compensar uma rotina mal definida. Antes de ativar qualquer regra, confirme o gatilho, a condição inicial, o registro afetado, o resultado esperado e a forma de auditoria.

## Premissas de disparo

Nem toda criação ou atualização de cadastro inicia uma automação. Para evitar disparos em massa e execuções em cascata, considere estas regras:

- importações em massa por planilha/CSV de contatos, oportunidades ou empresas não rodam fluxos de automação de CRM;
- uma automação de CRM não deve ser tratada como gatilho para outra automação de CRM;
- automações disparam a partir de ações manuais de usuários, ações executadas por fluxos do bot, ações executadas por webhooks de entrada ou ações realizadas via API;
- se uma base foi importada por CSV, valide os registros primeiro e só depois execute uma ação explícita que deva iniciar automação, quando aplicável.

Essa diferença é importante em implantações, migrações e campanhas. Importar uma base prepara os dados, mas não substitui uma ação operacional, um fluxo do bot, um webhook ou uma chamada de API que altera o registro dentro das regras de disparo.

---
title: "Ciclo seguro de uma automação"
caption: "A automação nasce de um gatilho válido, valida condições, executa ações e registra histórico para acompanhamento."
definition: |
  flowchart LR
    A[Ação válida cria ou atualiza registro] --> B[Automação ativa]
    B --> C[Condição inicial]
    C -->|Atendida| D[Ações do fluxo]
    C -->|Não atendida| E[Sem execução]
    D --> F{Precisa aguardar?}
    F -->|Sim| G[Aguardar prazo]
    G --> H[Revalidar condição]
    H --> D
    F -->|Não| I[Resultado no CRM, conversa ou integração]
    I --> J[Histórico de execução]
---

## Onde configurar

![Tela de automações de CRM para criar regras, eventos e ações automáticas](/docs/screenshots/config-automacoes-crm.png)

As automações ficam em [https://my.agilize.app/crm/automation](https://my.agilize.app/crm/automation).

Acesso pela tela: sidebar lateral > módulo **CRM/Hub** > **Configurações** > **Automações do CRM**.

Essa área é de configuração administrativa. Use-a para criar regras que afetam dados do CRM, distribuição de responsáveis, tarefas, mensagens e integrações. Depois de salvar uma automação, a tela permite revisar a configuração e acompanhar o histórico de execuções.

## Quando usar

Use uma automação quando o processo tem regra clara e repetível:

- distribuir oportunidade nova para um responsável ou equipe;
- criar tarefa quando um lead entra em determinada etapa;
- adicionar ou remover tags conforme origem, etapa, resposta ou classificação;
- alterar funil, etapa ou resultado de oportunidade;
- gerar contato, empresa ou oportunidade relacionada;
- enviar SMS ou template de WhatsApp;
- adicionar ou remover registros de listas de transmissão;
- registrar conversões em canais de mídia;
- enviar dados para outro sistema via webhook;
- concluir conversas associadas quando o processo permitir;
- vincular sala de conversa a item de pipeline.

Evite automatizar decisões sensíveis sem validação humana, como perda de oportunidade, cancelamento, mudança de responsável em contas estratégicas, mensagem para base grande ou encerramento de conversa em atendimento ativo.

## Campos da automação

| Campo | Como usar |
| --- | --- |
| Nome | Use um padrão que indique entidade, evento e objetivo. Exemplo: `Lead criado - distribuir SDR` ou `Lead em proposta - follow-up WhatsApp`. |
| Ativado | Mantenha desativado enquanto estiver desenhando e testando. Ative somente depois de validar caminho principal, exceções e auditoria. |
| Entidade | Define qual tipo de registro dispara a automação: oportunidade, contato ou empresa. |
| Evento | Define se a automação roda na criação ou na atualização do registro. |
| Permitir reexecução por entidade | Use com cuidado. O padrão seguro é deixar desligado para evitar execução duplicada no mesmo registro. |
| Fluxo | Construtor visual onde você adiciona condição inicial, ações, esperas e desvios. |

Depois que a automação é criada, entidade e evento ficam travados para preservar a coerência do histórico. Se precisar mudar o tipo de registro ou o gatilho, crie uma nova automação.

## Entidades e eventos

As automações podem ser associadas a três entidades principais:

| Entidade | Uso comum |
| --- | --- |
| Oportunidade | Distribuição comercial, mudança de etapa, criação de tarefa, envio de template, conversão, tags, listas e pós-venda. |
| Contato | Qualificação, criação de oportunidade, vínculo com empresa, tag, tarefa, mensagem e integração externa. |
| Empresa | Distribuição de conta, criação de contato ou oportunidade, tarefa, tag, webhook e acompanhamento de relacionamento. |

Os eventos disponíveis são:

| Evento | Quando dispara | Cuidados |
| --- | --- | --- |
| Criação | Quando um novo registro é criado. | Ideal para triagem inicial, distribuição, primeira tarefa e enriquecimento de cadastro. |
| Atualização | Quando um registro existente é alterado. | Exige condição inicial bem definida para não rodar em qualquer pequena edição. |

Esses eventos dependem da origem da ação. Criações e atualizações feitas por usuário, fluxo do bot, webhook de entrada ou API podem iniciar automação. Criações e atualizações vindas de importação em massa por CSV não iniciam fluxos de automação.

Em automações de atualização, a condição inicial é essencial. Ela impede que a regra rode por alterações irrelevantes, como correção de nome, telefone, observação ou outro campo que não deveria iniciar uma ação.

## Estrutura recomendada

Monte a automação nesta ordem:

1. **Condição inicial**: decide se a automação deve começar.
2. **Ação principal**: cria tarefa, altera responsável, move etapa, adiciona tag, envia mensagem ou integra sistema.
3. **Espera, quando necessário**: aguarda minutos, horas ou dias antes da próxima etapa.
4. **Revalidação**: confere se o registro ainda está no estado esperado antes de continuar.
5. **Ação complementar**: nova mensagem, tarefa, tag, distribuição, webhook ou encerramento.
6. **Saída segura**: encerra sem ação quando o registro mudou, respondeu, foi ganho/perdido ou deixou de atender à regra.

Um desenho seguro para follow-up costuma ser:

`Condição inicial -> Ação -> Aguardar prazo -> Avaliar condição -> Nova ação ou encerramento`

## Condições

Use condições para limitar a execução ao cenário correto. Elas podem considerar campos como etapa, funil, origem, responsável, tags, telefone, e-mail, empresa, contato vinculado, status comercial ou outro dado relevante do registro.

Boas práticas:

- Em criação, use condição inicial quando nem todo registro novo deve seguir a regra.
- Em atualização, sempre use condição inicial para restringir o disparo.
- Revalide depois de aguardar prazo.
- Crie saída de encerramento quando a condição não for mais verdadeira.
- Evite condições amplas demais, como “qualquer lead atualizado”.

## Ações disponíveis

As ações são configuradas por nodes. Use a referência de [Nodes de automação de CRM](/docs/configuracao/referencias/nodes-automacao-crm) para ver detalhes de cada um.

| Grupo | Nodes principais | Aplicação |
| --- | --- | --- |
| Controle | Condição Inicial, Avaliar Condição, Aguardar Prazo | Define entrada, desvios, revalidações e pausas. |
| Dados e CRM | Gerar Entidade, Setar Funil/Etapa Lead, Lead Ganhou ou Perdeu, Adicionar/Alterar Tags | Cria ou altera dados comerciais. |
| Responsáveis e tarefas | Atribuir/Distribuir Usuário, Criar Tarefa/Atividade, Alterar Usuário Retorno de Chat | Define dono, próxima ação e retorno de conversa. |
| Pipeline | Criar Item Pipeline, Mover Etapa Pipeline, Vincular Sala Pipeline | Usa automação para processos operacionais além da oportunidade tradicional. |
| Mensagens | Mensagem WhatsApp Template, Mensagem WhatsApp com Fluxo Template, Enviar SMS | Faz comunicação ativa com cliente quando há canal e conteúdo válidos. |
| Listas e campanhas | Operação em Lista de Transmissão | Mantém entrada e saída de listas conforme a jornada. |
| Integrações | Enviar Webhook HTTP, Enviar Conversões | Notifica sistemas externos e plataformas de mídia. |
| Conversas | Concluir Conversa | Encerra conversas associadas quando a regra operacional permite. |

## Exemplos práticos

### Distribuir oportunidade nova

Use quando todo lead criado por determinada origem precisa chegar ao time correto.

1. Entidade: oportunidade.
2. Evento: criação.
3. Condição inicial: origem, funil ou tag esperada.
4. Ação: atribuir usuário ou distribuir por equipe.
5. Ação: criar tarefa de primeiro contato.
6. Opcional: enviar template WhatsApp de confirmação.

Valide se o responsável recebeu a oportunidade, se a tarefa tem prazo e se a mensagem saiu com telefone e variáveis corretas.

### Follow-up de etapa

Use quando uma oportunidade parada em uma etapa precisa receber lembrete ou atividade.

1. Entidade: oportunidade.
2. Evento: atualização.
3. Condição inicial: etapa atual é a etapa desejada.
4. Ação: enviar mensagem ou criar tarefa.
5. Aguardar prazo.
6. Avaliar condição: oportunidade ainda está na mesma etapa e não foi concluída.
7. Se verdadeiro, executar novo follow-up ou criar atividade.
8. Se falso, encerrar sem nova ação.

Esse padrão evita mensagem fora de contexto depois que a oportunidade já avançou, foi perdida, foi ganha ou recebeu retorno humano.

### Fechamento ganho com pós-venda

Use quando a oportunidade ganha precisa iniciar ações de pós-venda e mensuração.

1. Entidade: oportunidade.
2. Evento: atualização.
3. Condição inicial: oportunidade entrou em etapa final de ganho.
4. Ação: marcar como ganho, se aplicável.
5. Ação: enviar conversão para mídia, quando configurado.
6. Ação: adicionar contato ou lead a lista de onboarding.
7. Ação: criar tarefa para responsável de implantação ou sucesso do cliente.
8. Opcional: definir usuário preferencial de retorno da conversa.

Valide a deduplicação de conversão, a lista correta e o responsável da próxima tarefa.

### Contato criado por integração

Use quando um contato novo precisa virar oportunidade ou tarefa de triagem.

1. Entidade: contato.
2. Evento: criação.
3. Condição inicial: contato tem telefone, e-mail, origem ou tag esperada.
4. Ação: gerar oportunidade, se houver intenção comercial.
5. Ação: criar tarefa para conferência.
6. Ação: adicionar tag de origem ou qualificação.

Evite criar oportunidade para todo contato novo sem critério. Isso aumenta volume no CRM sem indicar prioridade real.

### Empresa atualizada

Use quando mudanças em uma empresa devem acionar relacionamento ou tarefa de conta.

1. Entidade: empresa.
2. Evento: atualização.
3. Condição inicial: campo relevante mudou ou tag foi adicionada.
4. Ação: atribuir responsável.
5. Ação: criar tarefa de revisão.
6. Opcional: enviar webhook para sistema externo.

Use esse cenário para governança de contas, não para pequenas alterações cadastrais sem impacto comercial.

## Mensagens automáticas

Mensagens enviadas por automação precisam de cuidado extra porque chegam diretamente ao cliente.

Antes de ativar:

- confirme que o telefone está completo e com DDI;
- selecione o canal correto;
- use template WhatsApp aprovado quando necessário;
- preencha todas as variáveis do template;
- confira se a mensagem combina com o momento da jornada;
- evite múltiplos envios no mesmo dia sem necessidade;
- revalide a condição depois de qualquer espera.

Para WhatsApp, considere a [sessão de 24 horas](/docs/usuarios/flow-e-atendimento/sessao-de-24-horas-no-whatsapp) e o uso de [modelos de mensagem](/docs/configuracao/canais-whatsapp-integracoes/cadastro-de-modelos-de-mensagem-whatsapp).

## Reexecução por entidade

Por padrão, a automação deve executar uma vez por registro. Isso reduz duplicidade de tarefas, mensagens, tags, conversões e alterações de etapa.

Ative reexecução por entidade apenas quando a regra realmente precisa rodar novamente para o mesmo registro, como cadências controladas, reentrada em etapa, reativação por tag ou atualização recorrente. Mesmo nesses casos, use condição inicial, espera e revalidação para evitar loop.

Sinais de que a reexecução está perigosa:

- a mesma tarefa aparece várias vezes;
- o cliente recebe mensagens repetidas;
- a oportunidade troca de responsável sem motivo;
- tags são adicionadas e removidas em sequência;
- a automação volta a disparar ao alterar o próprio registro.

## Ativar, pausar e editar

Mantenha a automação desativada enquanto estiver montando.

Antes de ativar:

1. Teste com registro controlado.
2. Revise entidade e evento.
3. Confirme a condição inicial.
4. Valide todos os caminhos.
5. Verifique mensagens e variáveis.
6. Confira tarefas, responsáveis, tags e etapas.
7. Avise a equipe impactada.

Pause a automação quando houver erro recorrente, mensagem fora de contexto, duplicidade, integração falhando, regra de negócio em revisão ou mudança de funil. Uma automação pausada deixa de rodar para novos eventos e pode impedir a continuidade de execuções agendadas. Ao reativar, revise o histórico antes de assumir que tudo continuará do ponto certo.

Ao editar uma automação em produção, prefira:

- duplicar ou documentar o desenho atual;
- ajustar uma parte por vez;
- testar em registro controlado;
- ativar em horário de menor impacto;
- acompanhar o histórico nas primeiras execuções.

## Auditoria e histórico

Cada automação pode gerar histórico de execução. Use esse histórico para entender:

- se a automação executou;
- quando executou;
- se ficou agendada para continuar depois;
- qual foi o último node processado;
- se houve erro;
- em qual ponto o erro aconteceu;
- se a execução pode ser reprocessada.

Em falhas, filtre as execuções com erro e revise o node indicado. Quando houver opção de reprocessamento, use-a somente depois de corrigir a causa: template ausente, telefone inválido, condição incorreta, etapa inexistente, responsável indisponível ou integração externa falhando.

Histórico não substitui validação operacional. Depois de corrigir uma execução, confira o registro afetado no CRM, a conversa, as tarefas e eventuais sistemas externos.

## Checklist de teste

- [ ] A automação tem nome claro.
- [ ] Entidade e evento estão corretos.
- [ ] O status está desativado durante a montagem.
- [ ] A condição inicial restringe o cenário certo.
- [ ] O caminho falso não executa ações indevidas.
- [ ] Cada espera tem revalidação depois.
- [ ] Tarefas têm responsável, prazo e conteúdo útil.
- [ ] Mudanças de etapa respeitam funil e campos obrigatórios.
- [ ] Tags são necessárias para operação, relatório ou segmentação.
- [ ] Mensagens têm canal, telefone, template e variáveis válidas.
- [ ] Webhooks foram testados com endpoint preparado.
- [ ] Conversões foram testadas com deduplicação.
- [ ] A reexecução por entidade está desligada, salvo necessidade clara.
- [ ] O histórico mostra execução esperada em registro de teste.
- [ ] A equipe sabe qual resultado deve aparecer no CRM ou no Flow.

## Troubleshooting

| Sintoma | Causa provável | Correção |
| --- | --- | --- |
| Automação não executou | Status desligado, entidade errada, evento errado ou condição inicial não atendida. | Revise configuração, teste com registro novo ou atualização controlada e confira histórico. |
| Executou mais de uma vez | Reexecução ligada, condição ampla ou atualização causada pela própria automação. | Restrinja condição, desligue reexecução ou crie saída de parada. |
| Tarefa criada para pessoa errada | Usuário fixo, equipe ou regra de distribuição incorreta. | Ajuste responsável ou equipe e teste novamente. |
| Oportunidade mudou de etapa indevidamente | Condição inicial ou revalidação incompleta. | Inclua etapa/funil atual na condição e revalide depois de esperas. |
| Mensagem não foi enviada | Telefone ausente, canal incorreto, template inválido ou variável vazia. | Corrija dados, template e variáveis antes de reprocessar. |
| Conversão duplicada ou ausente | Evento de mídia, conta, valor ou deduplicação incorretos. | Revise configuração de conversão e teste com uma oportunidade controlada. |
| Webhook falhou | URL, método, payload ou sistema externo indisponível. | Corrija endpoint e reexecute apenas quando a integração estiver pronta. |
| Execução ficou parada | Há espera configurada ou erro em node posterior. | Verifique próxima data, último node e histórico de erro. |

## Guias relacionados

- [Nodes de automação de CRM](/docs/configuracao/referencias/nodes-automacao-crm)
- [Funis, etapas e origens](/docs/configuracao/crm-dados/funis-etapas-e-origens)
- [Campos e dados obrigatórios](/docs/configuracao/crm-dados/campos-e-dados-obrigatorios)
- [Regras de roteamento e distribuição](/docs/configuracao/roteamento-distribuicao/regras-de-roteamento-e-distribuicao)
- [Cadastro de modelos de mensagem WhatsApp](/docs/configuracao/canais-whatsapp-integracoes/cadastro-de-modelos-de-mensagem-whatsapp)
- [Sessão de 24 horas no WhatsApp](/docs/usuarios/flow-e-atendimento/sessao-de-24-horas-no-whatsapp)
- [Listas de transmissão](/docs/configuracao/canais-whatsapp-integracoes/listas-de-transmissao)
- [Automações e IA](/docs/usuarios/flow-e-atendimento/automacoes-e-ia)