Glossário de automação do WhatsApp: gatilhos, passos, tomada de controlo, a janela de 24 horas e mais
A automação do WhatsApp tem vocabulário próprio. Um gatilho decide o que inicia uma automação: uma mensagem, uma etiqueta ou uma chamada de webhook, os passos decidem o que sai como resposta, a tomada de controlo pausa a automação quando uma pessoa responde a partir do telemóvel, e a janela de 24 horas decide quando podem sair respostas que não sejam templates. Templates, opt-in, estados de execução, motivos de omissão e webhooks assinados completam o quadro, e cada termo aqui ocupa uma linha.
A easyCoexistence liga o seu número do WhatsApp Business à Cloud API da Meta através da Coexistence e corre automações com o vocabulário acima: quatro correspondências, 19 tipos de passo, tomada de controlo quando responde a partir do telemóvel e um registo de execuções de 30 dias com motivos de omissão.
Formas como uma automação do WhatsApp pode escolher as mensagens recebidas: Every message, Has keyword, First message e After hours.
Tipos de passo num número, de Reply with text e Send a template a Ask a question, Split into paths e Agent answers.
Número máximo de passos que uma linha de uma automação pode ter, 60 no total, com ramificações aninhadas até 4 níveis de profundidade.
Janela de atendimento da Meta: mensagens que não sejam templates só são permitidas nas 24 horas seguintes à última mensagem do cliente.
Categorias de template da Meta: marketing, utilidade e autenticação.
Motivos de omissão que uma execução pode mostrar, desde uma resposta recente a partir do seu telemóvel até uma chave de IA que deixou de funcionar.
Que termos descrevem a ligação por trás das automações?
As automações correm num número ligado à API da Meta enquanto este permanece na app WhatsApp Business. Estes seis termos descrevem essa ligação e para onde vão as mensagens recebidas do número:
- Coexistence: o processo de integração da Meta que liga um número já existente na app WhatsApp Business à Cloud API, para que a app e o software partilhem o número e as suas conversas.
- Cloud API: a API alojada da Meta para enviar e receber mensagens do WhatsApp Business; a via oficial para software.
- Inbound mode: para onde vão as mensagens recebidas de um número, mostrado na sua página em Where incoming messages go como Through easyCoexistence ou Straight to your system.
- Through easyCoexistence (managed): a Meta entrega à easyCoexistence, as automações e as Conversations podem usar as mensagens e um Forward URL opcional recebe uma cópia assinada.
- Straight to your system (direct): a Meta publica as mensagens do número diretamente no seu próprio destino de webhook, e as automações ficam desligadas.
- Forward URL: o seu endpoint HTTPS, que recebe cada mudança recebida de um número gerido, assinada com X-EC-Signature.
Quais são os blocos de construção de uma automação?
Uma automação é um gatilho e um fluxo de passos num número. O gatilho indica o evento e a correspondência restringe-o; apenas uma automação responde a determinada mensagem, por prioridade. Estes são os nomes que o editor usa em "When a message arrives":
- Automação: um gatilho e um fluxo de até 30 passos por linha, 60 no total, num número, ligada ou desligada em conjunto.
- Gatilho: o evento que inicia uma automação; num número do WhatsApp, A message arrives, A contact gets a tag ou Your system calls a URL.
- Every message: a correspondência geral, para tudo o que o cliente escreve.
- Has keyword: corre quando a mensagem corresponde a uma de até 30 palavras-chave; as maiúsculas não contam.
- Keyword mode: Contains (em qualquer parte da mensagem), Starts with (no início) ou Is exactly (a mensagem inteira).
- First message: corre numa conversa sem histórico, incluindo a primeira mensagem de um cliente habitual depois de as automações serem ativadas, ou após cerca de 30 dias sem atividade.
- After hours: corre enquanto estiver fechado, com base num Timezone, Open on days e horas From / To no formato de 24 horas.
- Prioridade: a ordem que escolhe uma automação: palavra-chave, depois First message, depois After hours, depois a correspondência geral, da mais antiga para a mais recente.
O que significa cada tipo de passo?
Os passos correm por ordem, de cima para baixo, a seguir ao bloco Trigger, e dois deles ramificam: Split into paths (por regras sobre texto, campos, etiquetas ou horários) e AI picks the path (pelo significado) têm, cada um, uma linha de passos por caminho mais uma linha Otherwise. Uma linha tem até 30 passos, 60 no total, com ramificações aninhadas até 4 níveis. Um número aceita 19 tipos de passo; além dos que se seguem, o editor oferece Ask a question (até 3 botões tocáveis, espera pela resposta e guarda-a num campo do contacto), Agent answers, Hand to a person (pausa o bot na conversa e envia-lhe um email), Notify me, Send a picture or file, Save to contact, Tag, AI saves details, Call an API, Start automation e Go back to a step. Estes são os tipos de passo principais e os seus nomes:
- Reply with text: uma mensagem fixa de até 4,096 caracteres, enviada tal como está escrita.
- Variables: {{
first_name}}, {{name}}, {{message}} e {{phone}}, mais {{contact.field}} para um campo de contacto guardado e {{vars.name}} para a resposta de um passo anterior, preenchidas quando o passo corre. - Send a template: envia um template aprovado do número, com variáveis posicionais no corpo; funciona fora da janela de 24 horas.
- Reply with AI: o seu próprio modelo, com a sua chave Anthropic, OpenAI ou OpenRouter, escreve a resposta.
- Instructions: o prompt do passo de IA, ou de um agente, até 20,000 caracteres; um agente pode também recorrer a ficheiros de conhecimento, links e texto.
- Call my webhook: envia a mensagem e até 10 mensagens recentes da conversa para o seu URL, e devolve uma resposta recebida no prazo de 20 segundos.
- Wait: pausa a execução durante 1 a 1,380 minutos, ou seja 23 horas, antes do passo seguinte.
- Stop: termina a execução; só é permitido como último passo da sua linha.
Que regras e limites têm nome próprio?
Algumas palavras vêm da Meta e aplicam-se a qualquer negócio no WhatsApp; outras são definições em Advanced no editor de automações. Ambas decidem se uma resposta chega a sair, por isso vale a pena conhecê-las pelo nome:
- 24-hour window: a janela de atendimento da Meta; mensagens que não sejam templates só são permitidas nas 24 horas seguintes à última mensagem do cliente.
- Template: um formato de mensagem que a Meta analisa previamente, nas categorias marketing, utilidade ou autenticação; é necessário para escrever primeiro ou após as 24 horas.
- Opt-in: a pessoa deu-lhe o número e aceitou receber as suas mensagens, o que a Meta exige antes de enviar a primeira mensagem.
- Echo: o webhook
smb_message_echoesda Meta, que reporta uma mensagem enviada a partir da app ou de um dispositivo associado. - Tomada de controlo: a pausa depois de responder a partir do telemóvel ou das Conversations, definida em "Pause on a chat after I answer it (hours)", 4 por predefinição, de 0 a 168.
- AI reply limit: "AI replies per chat per hour, at most", 10 por predefinição, de 1 a 60.
- Tokens: as unidades que os fornecedores de IA faturam; "Longest reply (tokens)" limita uma resposta, 600 por predefinição, de 50 a 2,000.
- Regra dos 14 dias: a Meta desliga um número de Coexistence cuja app não é aberta no telemóvel durante cerca de 14 dias.
O que significam os termos do registo de execuções?
Sempre que uma automação começa com uma mensagem, deixa uma execução no separador Runs, guardada durante 30 dias, com o resultado, o tempo e os tokens de cada passo. Estas palavras explicam o que lá aparece:
- Run: uma execução de uma automação numa mensagem recebida, numa etiqueta ou numa chamada de webhook, ou num teste.
- Run status: Queued, Running, Waiting (parada num passo Wait), Done, Failed ou Skipped.
- Skip reason: porque é que a execução parou de propósito, como "You answered this chat from your phone recently".
- Test it / Try it: corre os passos guardados numa mensagem de exemplo; nada é enviado, mas a IA e o webhook correm de facto.
- Paused: o estado de uma automação cuja chave de IA foi recusada pelo fornecedor; recomeça assim que uma chave válida for guardada.
- Superseded: uma execução em espera cancelada porque uma mensagem mais recente do cliente voltou a iniciar a mesma automação.
Erros comuns
- Ler Paused como Off. Paused significa que a chave de IA deixou de funcionar; a automação recomeça sozinha quando uma chave válida for guardada, enquanto Off fica desligada até ser ativada.
- Confundir a mensagem de ausência da app com After hours. Uma vive na app do telemóvel e o software não a consegue ver; a outra é uma automação do lado da API.
- Esperar que First message só dispare para contactos novos. Dispara para qualquer conversa sem histórico guardado, incluindo os clientes habituais.
Crie-as no editor ou peça à sua IA, com a sua própria chave. De US$ 9 a US$ 0.75 por número por mês, descendo à medida que acrescenta números, com os primeiros 3 dias grátis.
Perguntas frequentes
Qual é a diferença entre uma automação e um agente de IA?
Uma automação é um gatilho e passos, mesmo quando ramifica: cada caminho é um que desenhou. Um agente de IA decide a sua própria ação seguinte. Um passo Agent answers coloca um dos seus agentes dentro de uma automação, com as suas instruções, conhecimento e ferramentas como guardar um campo do contacto ou passar a conversa a uma pessoa, enquanto um passo Reply with AI apenas escreve a resposta. Um agente completo, da sua autoria, também pode ficar por trás de Call my webhook ou de um Forward URL.
Onde aparecem estes termos no painel?
Correspondências e modos de palavra-chave estão no bloco Trigger do editor de automações, e os passos no menu + entre blocos. A tomada de controlo e o limite de respostas de IA estão em Advanced, as execuções e os motivos de omissão no separador Runs, e o Inbound mode na página do número.
Quais destes termos vêm da Meta?
Coexistence, Cloud API, a janela de 24 horas, os templates e as respetivas categorias, o opt-in, os echoes e a regra dos 14 dias são da Meta. Correspondências, passos, tomada de controlo, estados de execução, motivos de omissão e X-EC-Signature são nomes usados no painel e na API da easyCoexistence.
O que significa X-EC-Signature?
É o cabeçalho que prova que uma chamada de webhook ou um reenvio veio da easyCoexistence: t=<segundos unix>,v1=<HMAC-SHA256 de "<t>.<corpo>"> feito com um segredo que apenas a sua conta possui. O seu servidor recalcula-o e compara-o antes de confiar no pedido.
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