Antes de publicar, você pode rodar a automação com uma conversa de verdade e ver, passo a passo, o que aconteceria, sem que nada seja enviado ou salvo. Depois de publicada, o próprio construtor mostra quantas pessoas passaram por cada passo, quem está esperando agora e onde as execuções falharam, com um botão para reprocessar.
O que é
Tudo acontece sobre o desenho da automação, no construtor. O seletor no topo tem três modos:
| Modo | Para que serve |
|---|---|
| Editar | Montar e configurar os passos |
| Testar | Simular com um contato, sem enviar nem salvar nada |
| Resultados | Ver os números reais de cada passo num período |
Além deles, o painel Execuções, no trilho à esquerda, lista quem passou pela automação. Na lista de Automações, o bloco Precisa de atenção e o diálogo No fluxo agora mostram o que pede ação sem abrir cada automação.
Como funciona
Testar: a simulação
Clique em Testar no topo do construtor, ou em Testar com um contato no menu da automação na lista. A automação precisa ter sido salva ao menos uma vez, e o modo só aparece para quem tem a permissão Editar automações.
A simulação começa com a conversa mais recente que você pode ver. A faixa no alto diz Simulando com [contato] e "nada é enviado nem salvo". Em Outro contato, você busca por nome, telefone ou e-mail, ou escolhe Contato de exemplo, com dados inventados e sem conversa de verdade. Conversas de grupo não entram na lista.
Cada passo no caminho ganha um selo, e o caminho seguido fica verde:
| Selo | O que quer dizer |
|---|---|
| Passaria | O passo rodaria normalmente |
| Esperaria | O fluxo pararia aqui: uma espera de tempo ou uma pergunta aguardando resposta |
| Pularia | A regra de "Só executa se" não passou, e o passo seria pulado |
| Falharia | O passo daria erro; abra o passo e leia o motivo |
O que mais a simulação faz:
- Mostra a mensagem como o cliente veria, no estilo do WhatsApp, com o texto já preenchido.
- Simula respostas. Numa pergunta com botões, toque no botão para simular a escolha do cliente. Clicar no caminho de uma pergunta ou de um passo de IA faz a simulação seguir por ali.
- Troca dados de execução por marcadores. O que só existe numa execução real aparece legível, como "[link da negociação do passo 4]".
- Refaz sozinha. Se você mexer num passo com o Testar ligado, a simulação roda de novo.
- Guarda a última simulação no painel Última simulação, no trilho.
Dois cuidados:
- Chamadas a sistemas externos só acontecem de verdade com a chave Chamar sistemas externos de verdade ligada, na escolha de contato. Ela vale só para as chamadas: mensagens continuam sem sair.
- "Para cada" simula o corpo uma vez, com o primeiro item da lista.
Quem entraria: a estimativa
No painel do gatilho, logo abaixo de Só entra se, aparece uma linha como "41 conversas dos últimos 7 dias entrariam · Ver". O Codewo passa os eventos da última semana pelas mesmas regras do gatilho, sem disparar nada. Em Ver, você confere exemplos.
- Só existe nos gatilhos Conversa aberta e Mensagem recebida (neste, a conta é de mensagens), e aparece depois que a automação foi salva.
- É uma amostra: quando há muito movimento, analisa os mais recentes e avisa, por exemplo, "(das 300 mais recentes)".
- O número conta a empresa toda, mas os exemplos em "Ver" mostram só conversas que você pode ver.
Resultados
Clique em Resultados no topo. A faixa mostra quantas pessoas entraram, a porcentagem que concluiu, quantas estão em andamento agora e quantas falharam. O período é de 7 dias, 30 dias (padrão) ou 90 dias. "Em andamento" é sempre o momento atual, sem período.
Sobre cada passo aparecem três números: quantos passaram, quantos estão parados ali agora e quantas falhas houve. Um passo dentro de um "Para cada" conta uma vez por execução, porque a pergunta é quantas pessoas passaram por ali, não quantas voltas o laço deu.
Execuções
O painel Execuções, no trilho à esquerda, abre com um resumo: o total, a porcentagem concluída e as falhas dos últimos 30 dias, e quantas estão em andamento agora. Abaixo, lista as 50 execuções mais recentes. Cada linha tem a foto do contato, a situação (Concluída, Esperando, Rodando, Falhou ou Cancelada) e onde parou, como "No passo 7: motivo do erro" ou "Parado no passo 3 · há 2 h".
- Clique numa execução para ver o caminho dela destacado no desenho. A faixa diz de quem é a execução e onde ela parou, com o botão Ir para a conversa.
- O ícone de conversa abre a conversa numa nova aba.
- Reprocessar, na execução que falhou, recomeça a partir do passo que falhou, na mesma versão da automação em que ela entrou. Os passos anteriores não se repetem: a mensagem que já saiu não sai de novo.
- Reprocessar as N que falharam, no rodapé, reprocessa as falhas dos últimos 30 dias, até 100 de uma vez.
Uma execução que continua rodando uma hora depois de começar é marcada como falha, e também pode ser reprocessada. Isso não vale para quem está esperando num passo de espera ou numa pergunta.
Na lista de Automações
Precisa de atenção mostra até 3 cartões, em ordem de urgência:
| Cartão | Quando aparece | Botão |
|---|---|---|
| Falhou | Execuções pararam com erro nas últimas 48 horas | Corrigir: abre o painel Execuções |
| Vai falhar | A automação está no ar com um passo incompleto | Resolver: abre o construtor no passo com problema |
| Parado | Rascunho sem alteração há mais de 5 dias | Continuar |
Em cada linha da lista aparecem o problema mais urgente, dizendo em que passo ("3 falharam no passo 12: motivo"), quem está no fluxo agora ("N aguardando", "N em andamento" ou "Ninguém no fluxo"), o gráfico de execuções dos últimos 14 dias, o total e a porcentagem concluída dos últimos 30 dias e quando foi a última execução. O filtro Com problema mostra só as automações com falha nos últimos 30 dias ou com passo incompleto.
No fluxo agora
Clique em "N aguardando" ou "N em andamento" numa linha para abrir No fluxo agora. Para cada pessoa aparecem a situação da conversa, o passo em que ela está, o que ela espera e desde quando ("Esperando a resposta do contato", "Esperando o tempo do passo") e quando segue sozinha, por exemplo "Segue sozinho amanhã às 14:43 (em 24 h)". Uma execução rodando há mais de 15 minutos sem avançar aparece como Parada sem avançar.
Quem pode editar automações vê Tirar do fluxo em cada pessoa. O primeiro clique vira Confirmar saída; o segundo cancela a execução, e aquela automação não envia mais nada para essa pessoa.
Aviso de falha
Quando uma execução falha, quem criou a automação recebe um aviso, por padrão no app e por e-mail, com o texto "[nome da automação] encontrou um erro durante a execução." e o botão Ver execução, que abre o painel Execuções. Se a conta de quem criou foi excluída, o aviso vai para o usuário mais antigo da empresa. Cada pessoa ajusta os canais desse aviso em Configurações → Notificações.
Passo a passo: testar o menu de atendimento antes de ligar
Cenário: você criou a automação pela receita Menu de atendimento no WhatsApp e quer conferir o caminho de quem quer comprar.
- Abra a automação e confira se os passos Passar para Vendas, Passar para Suporte e Passar para o Financeiro (todos do tipo Distribuir ou atribuir) já têm a equipe de cada assunto escolhida.
- Durante o horário de atendimento, clique em Testar. A faixa mostra "Simulando com" e a conversa mais recente.
- Confira o passo Dentro do horário?, que é um passo Horário de atendimento: a nota deve dizer "Dentro do horário", com o dia e a hora da simulação, e o caminho verde deve seguir para a pergunta.
- No passo Perguntar o assunto, que mostra Esperaria, toque no botão Quero comprar, que é o texto que o cliente vê. O caminho verde segue por Comprar até Passar para Vendas.
- Clique no caminho Sem resposta válida para ver o que acontece com quem não responde.
- Em Outro contato, escolha Contato de exemplo e repita, para ver o texto com outro nome.
- Se algum passo mostrar Falharia, clique nele, leia o motivo e corrija.
- Clique em Publicar.
- Uma semana depois, abra Resultados com 7 dias e veja quantas pessoas escolheram cada assunto e quantas ficaram sem resposta.
- Se houver falhas, abra Execuções, clique na execução, corrija o passo e use Reprocessar.
Pegadinhas comuns
- "Testar" pede a automação salva. Numa automação criada do zero, clique em Salvar antes. Depois disso, a simulação usa o que está na tela, mesmo o que ainda não foi salvo.
- O horário de atendimento segue o relógio de agora. Testando às 21h, a simulação vai pelo caminho Fora do horário. Para ver o outro caminho, teste dentro do expediente.
- Nada é enviado, nada é criado. Nem mensagem, nem negociação, nem etiqueta. A exceção é a chave "Chamar sistemas externos de verdade", e o sistema do outro lado recebe a chamada de verdade.
- Variável escrita errado aparece crua. Se a prévia mostra um texto entre chaves duplas, o nome da variável está errado. Corrija antes de publicar.
- A estimativa é amostra. Ela ajuda a calibrar as regras, mas não é a contagem exata do que vai acontecer.
- Reprocessar não volta ao começo. Se o erro estava num passo anterior ao que falhou, reprocessar não refaz esse passo.
- Tirar do fluxo vale para uma pessoa. Para encerrar todo mundo, arquive a automação. Pausar não tira ninguém.
- Quem só vê automações não testa. Com a permissão "Ver automações", o construtor abre em modo leitura, com Resultados e Execuções, mas sem Testar, Reprocessar e Tirar do fluxo.
Boas práticas
- Teste com três contatos: um que deve entrar, um que não deve e o contato de exemplo.
- Olhe "Precisa de atenção" toda semana. É o jeito mais rápido de achar a automação que parou de funcionar.
- Depois de corrigir, reprocesse. Quem ficou para trás por causa do erro segue de onde parou.
- Compare os números dos passos. Se muita gente para numa pergunta, talvez o texto ou os botões não estejam claros.
- Combine quem acompanha os avisos. O aviso de falha vai para quem criou a automação. Peça para criar quem vai acompanhar a automação no dia a dia.