Automações WhatsApp em vários passos: encadear respostas, IA, webhooks e esperas
Uma automação WhatsApp em vários passos executa um fluxo de passos numa mensagem recebida: até 30 por linha e 60 no total, por ordem, com ramificações que têm linhas próprias. Os passos podem enviar texto, um ficheiro, um template ou uma resposta de IA, fazer uma pergunta, chamar o seu webhook ou aguardar até 23 horas. Um passo que envia texto envia uma mensagem própria e separada.
A easyCoexistence executa automações em vários passos no número WhatsApp Business que mantém na aplicação, através da Cloud API da Meta: respostas fixas, templates, IA com a sua própria chave, o seu webhook, esperas e ramificações, até 30 passos por linha, com um registo de execuções durante 30 dias.
Passos por automação, ramificações incluídas: 30 por linha, aninhadas até 4 níveis; pelo menos um faz mais do que Wait, Stop, Go back ou ramificação.
A espera única mais longa, 23 horas. As esperas contam para os 60 passos.
Tempo que Call my webhook aguarda por uma resposta; uma resposta devolvida a tempo é enviada, um tempo esgotado falha o passo.
Mensagens recentes do chat que o webhook recebe, incluindo as respostas que passos anteriores da mesma execução enviaram.
No máximo um email de falha por automação neste período; o separador Runs guarda as execuções falhadas.
Como é que uma automação em vários passos é executada?
De cima para baixo, uma vez por cada mensagem recebida para a qual a automação é escolhida. Cada passo é executado, o seu resultado vai para o registo de execução, e começa o seguinte; numa ramificação, é executado o primeiro caminho cujas regras se verificam e o fluxo continua depois por baixo dele. A execução termina em Done depois do último passo; Stop, « End the automation », é opcional e só é permitido no fim da sua linha, por isso marca o fim no diagrama sem alterar o que acontece. Há duas situações que terminam uma execução antes. Uma falha, como um webhook que não responde, marca o passo como Failed, ignora todos os passos seguintes, incluindo as esperas, termina a execução como Failed e envia-lhe um email para que possa responder a esse cliente pessoalmente. Uma proteção, como a janela de 24 horas, o limite de IA ou a sua resposta a partir do telefone depois de uma espera, termina a execução como Skipped com o respetivo motivo, e o restante não é executado.
O que faz cada passo dentro de uma cadeia?
Qualquer passo pode seguir qualquer outro. O que muda é o que cada um envia e a regra que verifica quando chega a sua vez. Dois detalhes tornam as cadeias possíveis: Reply with AI lê o chat, incluindo o que os passos anteriores da execução acabaram de enviar, por isso não repete a sua saudação, e Call my webhook recebe essas respostas também no seu histórico. A grelha mostra os seis passos básicos; o editor oferece ainda 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 dupla mensagem depois de um webhook?
Um passo a seguir a Call my webhook é executado tenha ou não o webhook respondido, porque a sua resposta é enviada, não guardada para uma condição. Se o seu sistema devolver {"reply": "..."} e se seguir um Reply with AI ou um Reply with text, o cliente recebe duas mensagens para uma única pergunta. O mesmo acontece quando o seu sistema envia uma mensagem própria pela Cloud API e também devolve uma resposta. Não há nenhum mecanismo de recurso do tipo « se o webhook não disser nada, deixe a IA responder » com este passo; para ramificar com base na resposta do seu sistema, use Call an API, cuja resposta JSON uma condição consegue ler. Decida qual passo 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 |
Que cadeias valem a pena copiar?
Estas usam os passos básicos e evitam a armadilha. Cada uma lê-se da esquerda para a direita, pela ordem do diagrama, e encaixa em qualquer gatilho, salvo indicação em contrário.
- Saudação e depois resposta: Reply with text « Olá {{
first_name}}, obrigado por escrever! », depois Reply with AI. No gatilho First message. - Uma resposta para uma rajada: Wait 1, depois Reply with AI. Uma nova mensagem que escolha esta automação substitui a execução em espera.
- Esperar e depois consultar: Reply with text « Estamos a verificar o seu pedido… », depois Call my webhook, que devolve o estado.
- Responder e depois registar: Reply with AI, depois Call my webhook para o seu CRM ou n8n, que não devolve resposta.
- Responder e depois lembrar: Reply with AI, Wait 120, Reply with text « Isso ajudou? ». A sua resposta pelo telefone cancela o lembrete.
- Lembrete no dia seguinte: Reply with AI, Wait 1,380, Wait 60, Send a template. Apenas para clientes que deram consentimento.
Como é que as esperas alteram uma cadeia?
Um Wait deixa a execução em pausa, mostrada como Waiting no separador Runs, e o passo seguinte é executado quando o tempo termina. Antes desse passo, a execução verifica se alguém respondeu ao chat a partir da aplicação WhatsApp Business desde o início da execução; se sim, 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, registada como « A newer message from the customer took over »; uma mensagem que vá para outra automação não o faz. Os passos de texto que acordem mais de 24 horas depois da última mensagem do cliente são ignorados, mas Send a template continua a ser enviado. As esperas somam-se: com 11 Waits e um passo de envio, uma execução pode durar cerca de 10.5 dias.
Como é que se constrói e testa uma cadeia?
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 um passo. Através do conector, steps é uma lista em create_automation, e update_automation substitui a lista inteira, por isso um assistente que acrescente um passo tem de enviar todos. Run test executa a cadeia guardada sobre uma mensagem de exemplo: o passo de IA e o seu webhook são realmente executados, o webhook recebe dry_run com o valor true, as esperas ficam registadas como « Would wait 120 min » e são ignoradas, e nada é enviado. Um teste lê apenas o exemplo, por isso um passo de IA a seguir a uma saudação não vê a saudação aqui, como vê em direto.
"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. Ambos falam, e o cliente recebe duas respostas; deixe apenas um passo falar.
- Enviar update_automation só com o passo novo. Os passos são substituídos na totalidade, por isso os outros desaparecem; leia a automação com list_automations e envie a lista completa.
- Contar que um passo depois de um webhook com falha responda em vez disso. Uma falha ignora o resto; devolva HTTP 200 com uma resposta mesmo quando a consulta não encontra nada.
- Colocar Stop no meio para terminar uma cadeia mais cedo. A gravação é recusada com « Stop must be the last step »; elimine os passos que não quer.
Crie-as no diagrama do editor ou peça ao ChatGPT ou ao Claude através do conector. De US$ 9 até US$ 0.75 por número por mês, a descer à medida que acrescenta números, com os primeiros 3 dias grátis.
Perguntas frequentes
Um passo pode usar o que um passo anterior devolveu?
Sim. O que um passo anterior enviou chega aos seguintes como histórico do chat, lido pelo Reply with AI e enviado para o seu webhook. Os passos também podem passar valores: Ask a question e Save to contact guardam respostas em campos do contacto ({{contact.<field>}}), e Call an API guarda a sua resposta como {{vars.<name>}}. As variáveis {{first_name}}, {{name}}, {{message}} e {{phone}} vêm sempre da mensagem que iniciou a execução.
Uma automação pode enviar duas respostas de IA?
Sim, com dois passos Reply with AI, por exemplo um antes de um Wait e outro depois. Cada um conta como uma resposta de IA contra o limite horário do chat, e cada um cobra tokens da sua chave.
As mensagens de uma cadeia chegam pela ordem dos passos?
São enviadas pela ordem dos passos, uma de cada vez, e os envios a partir de um número são espaçados pelo menos 100 ms, abaixo das 20 mensagens por segundo da Meta para um número Coexistence. Um passo só começa depois de o anterior terminar.
O que acontece a uma cadeia em espera quando edito a automação?
Retoma no número do passo seguinte da automação tal como estiver guardada quando acordar, por isso uma edição pode mudar o que envia. Para parar as execuções em espera, desligue a automação; terminam como Skipped com « Automation is off ».
Continue a ler
Pronto para começar?
Configure a Coexistência do WhatsApp em minutos, não em meses. A aplicação continua a funcionar no telemóvel.
Começar período experimental gratuitoVerificado em