Automações de várias etapas no WhatsApp: encadeie respostas, IA, webhooks e esperas
Uma automação de várias etapas no WhatsApp executa um fluxo de etapas a partir de uma mensagem recebida: até 30 por linha e 60 no total, em ordem, com ramificações que têm linhas próprias. As etapas podem enviar texto, um arquivo, um template ou uma resposta de IA, fazer uma pergunta, chamar seu webhook ou esperar até 23 horas. Cada etapa que envia texto manda uma mensagem própria, separada.
O easyCoexistence executa automações de várias etapas no número de WhatsApp Business que você continua usando no app, pela Cloud API da Meta: respostas fixas, templates, IA com a sua própria chave, o seu webhook, esperas e ramificações, até 30 etapas por linha, com histórico de execuções guardado por 30 dias.
Etapas por automação, ramificações incluídas: 30 por linha, aninhadas em até 4 níveis; pelo menos uma precisa fazer algo além de Wait, Stop, Go back ou ramificação.
O Wait mais longo, 23 horas. Os Waits contam no limite de 60 etapas.
Tempo que Call my webhook espera por uma resposta; a resposta devolvida dentro do prazo é enviada, e um timeout faz a etapa falhar.
Mensagens recentes do chat que o webhook recebe, incluindo as respostas que etapas anteriores da mesma execução enviaram.
No máximo um e-mail de falha por automação nesse período; a aba Runs guarda as execuções com falha.
Como uma automação de várias etapas é executada?
De cima para baixo, uma vez para cada mensagem recebida em que a automação é escolhida. Cada etapa roda, o resultado vai para o log da execução, e a próxima começa; em uma ramificação, roda o primeiro caminho cujas regras valem e o fluxo segue depois dele. A execução termina como Done depois da última etapa; Stop, "End the automation", é opcional e só pode ficar por último na sua linha, então marca o fim no diagrama sem mudar o que acontece. Duas situações encerram uma execução antes do fim. Uma falha, como um webhook que não responde, marca a etapa como Failed, pula todas as etapas seguintes, inclusive as esperas, encerra a execução como Failed e envia um e-mail para que você mesmo responda esse cliente. Uma trava, como a janela de 24 horas, o limite de respostas de IA ou a sua resposta pelo celular depois de uma espera, encerra a execução como Skipped com o motivo, e o restante não roda.
O que cada etapa faz dentro de uma sequência?
Qualquer etapa pode vir depois de qualquer outra. O que muda é o que cada uma envia e qual regra ela verifica quando chega a sua vez. Dois detalhes fazem as sequências funcionarem: Reply with AI lê o chat, incluindo o que as etapas anteriores da execução acabaram de enviar, então não repete a sua saudação, e Call my webhook também recebe essas respostas no histórico. A grade mostra as seis etapas básicas; o editor também oferece Ask a question, Split into paths, AI picks the path, Agent answers, Send a picture or file, Call an API, Save to contact, Tag, Hand to a person e Go back to a step.
Qual é a armadilha da mensagem duplicada depois de um webhook?
Uma etapa depois de Call my webhook roda, tenha o webhook respondido ou não, porque a resposta dele é enviada, não guardada para uma condição. Se o seu sistema devolver {"reply": "..."} e uma etapa Reply with AI ou Reply with text vier em seguida, o cliente recebe duas mensagens para uma única pergunta. O mesmo acontece quando o seu sistema envia a própria mensagem pela Cloud API e também devolve uma resposta. Não existe um fallback do tipo "se o webhook não respondeu nada, deixe a IA responder" com essa etapa; para ramificar pela resposta do seu sistema, use Call an API, cuja resposta JSON uma condição consegue ler. Decida qual etapa fala:
| The webhook speaks | The webhook records | |
|---|---|---|
| Chain | Optional Reply with text, then Call my webhook, last | Reply with AI or Reply with text, then Call my webhook |
| Your system returns | {"reply": "..."} in every case, including not found | Any 2xx with no reply field |
| The customer gets | Your system's answer | The earlier step's answer |
| Fits | Order status, stock, prices from your database | CRM logging, team alerts, spreadsheets |
Quais sequências vale a pena copiar?
Estas usam as etapas básicas e evitam a armadilha. Cada uma é lida da esquerda para a direita, na ordem do diagrama, e funciona com qualquer gatilho, salvo indicação em contrário.
- Saudação e depois resposta: Reply with text "Oi {{
first_name}}, obrigado pela mensagem!", depois Reply with AI. No gatilho First message. - Uma única resposta para várias mensagens seguidas: Wait 1, depois Reply with AI. Uma mensagem mais nova que escolha esta automação substitui a execução em espera.
- Avisar e depois consultar: Reply with text "Estou verificando seu pedido agora…", depois Call my webhook, que devolve o status.
- Responder e depois registrar: Reply with AI, depois Call my webhook para o seu CRM ou n8n, que não devolve resposta.
- Responder e depois retomar o contato: Reply with AI, Wait 120, Reply with text "Isso ajudou?". A sua resposta pelo celular cancela o lembrete.
- Lembrete no dia seguinte: Reply with AI, Wait 1.380, Wait 60, Send a template. Só para clientes que aceitaram receber mensagens.
Como as esperas mudam uma sequência?
Um Wait deixa a execução parada, exibida como Waiting na aba Runs, e a próxima etapa roda quando o tempo acaba. Antes dessa etapa, a execução verifica se alguém respondeu ao chat pelo app do WhatsApp Business desde o início da execução; se sim, ela termina como Skipped com "You answered this chat from your phone recently". Uma nova mensagem do cliente que escolha a mesma automação substitui a execução em espera, registrada como "A newer message from the customer took over"; uma mensagem que vá para outra automação não faz isso. Etapas de texto que acordam mais de 24 horas depois da última mensagem do cliente são puladas, enquanto Send a template ainda é enviado. As esperas se somam: com 11 Waits e uma etapa de envio, uma execução pode durar cerca de 10,5 dias.
Como montar e testar uma sequência?
No diagrama do editor, clique em "Add a step here" entre dois blocos, escolha em "Choose a step" e preencha o painel; "Delete step" remove uma etapa. Pelo conector, steps é um array em create_automation, e update_automation substitui o array inteiro, então um assistente que adiciona uma etapa precisa enviar todas elas. Run test executa a sequência salva sobre uma mensagem de exemplo: a etapa de IA e o seu webhook rodam de verdade, o webhook recebe dry_run definido como true, as esperas são registradas como "Would wait 120 min" e puladas, e nada é enviado. O teste lê apenas a mensagem de exemplo, então uma etapa de IA depois de uma saudação não vê a saudação ali, como acontece em produção.
"trigger": {
"type": "message_received",
"match": "keyword",
"keywords": ["order", "pedido", "tracking"],
"keywordMode": "contains"
},
"steps": [
{ "type": "reply_text", "text": "Checking your order now, {{first_name}}…" },
{ "type": "call_webhook", "url": "https://shop.example.com/hooks/order-status" }
]
// Your endpoint answers within 20 seconds, in every case:
// { "reply": "Order #1042 left the shop at 14:20." }
// { "reply": "I couldn't find that order. A person will check it here." }Erros comuns
- Colocar Reply with AI depois de um webhook que devolve uma resposta. As duas etapas falam, e o cliente recebe duas respostas; deixe só uma etapa falar.
- Enviar update_automation só com a etapa nova. As etapas são substituídas em bloco, então as outras desaparecem; leia a automação com list_automations e envie a lista completa.
- Esperar que uma etapa depois de um webhook com falha responda no lugar dele. Uma falha pula o restante; devolva HTTP 200 com uma resposta mesmo quando a consulta não encontrar nada.
- Colocar Stop no meio para encerrar a sequência antes. O salvamento é recusado com "Stop must be the last step"; apague as etapas que você não quer.
Monte-as no diagrama do editor ou peça ao ChatGPT ou ao Claude pelo conector. De R$ 29,90 até R$ 3,90 por número por mês, com o valor caindo conforme você adiciona números, e os 3 primeiros dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
Uma etapa pode usar o que uma etapa anterior retornou?
Sim. O que uma etapa anterior enviou chega às seguintes como histórico do chat, é lido pelo Reply with AI e enviado ao seu webhook. As etapas também podem repassar valores: Ask a question e Save to contact guardam respostas em campos do contato ({{contact.<field>}}), e Call an API guarda a resposta como {{vars.<name>}}. As variáveis {{first_name}}, {{name}}, {{message}} e {{phone}} sempre vêm da mensagem que iniciou a execução.
Uma automação pode enviar duas respostas de IA?
Sim, com duas etapas Reply with AI, por exemplo uma antes de um Wait e outra depois. Cada uma conta como uma resposta de IA no limite por hora do chat, e cada uma consome tokens da sua chave.
As mensagens de uma sequência chegam na ordem das etapas?
Elas são enviadas na ordem das etapas, uma de cada vez, com intervalo mínimo de 100 ms entre os envios de um mesmo número, abaixo do limite da Meta de 20 mensagens por segundo para um número em Coexistência. Uma etapa só começa depois que a anterior termina.
O que acontece com uma sequência em espera quando eu edito a automação?
Ao acordar, ela retoma no próximo número de etapa da automação como estiver salva naquele momento, então uma edição pode mudar o que ela envia. Para parar as execuções em espera, desligue a automação (Off); elas terminam como Skipped com "Automation is off".
Continue lendo
Pronto para começar?
Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.
Começar teste grátisVerificado em