EntrarComeçar teste grátis
Meta Tech Provider

Glossário de automação do WhatsApp: gatilhos, passos, intervenção humana, janela de 24 horas e mais

A automação do WhatsApp tem vocabulário próprio. Um gatilho define o que inicia uma automação: uma mensagem, uma tag ou uma chamada de webhook, os passos definem o que é respondido, a intervenção humana pausa a automação quando uma pessoa responde pelo celular, e a janela de 24 horas define quando respostas que não sejam templates podem ser enviadas. Templates, opt-in, status de execução, motivos para pular e webhooks assinados completam o quadro, e cada termo aqui ocupa uma linha.

O easyCoexistence conecta o seu número do WhatsApp Business à Cloud API da Meta por meio da Coexistência e roda automações nele com o vocabulário acima: quatro correspondências, 19 tipos de passo, intervenção humana quando você responde pelo celular e um registro de execuções de 30 dias com motivos para pular.

4 matches

Formas de uma automação do WhatsApp escolher as mensagens recebidas: Every message, Has keyword, First message e After hours.

19 steps

Tipos de passo em um número, de Reply with text e Send a template a Ask a question, Split into paths e Agent answers.

30 steps

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.

24 hours

Janela de atendimento da Meta: mensagens que não são templates só são permitidas dentro de 24 horas após a última mensagem do cliente.

3 categories

Categorias de template da Meta: marketing, utilidade e autenticação.

15 reasons

Motivos para pular que uma execução pode mostrar, de uma resposta recente pelo celular até uma chave de IA que parou de funcionar.

Quais termos descrevem a conexão por trás das automações?

As automações rodam em um número conectado à API da Meta enquanto ele continua no app do WhatsApp Business. Estes seis termos descrevem essa conexão e para onde vão as mensagens recebidas do número:

  • Coexistência: o onboarding da Meta que conecta um número que já está no app do WhatsApp Business à Cloud API, para que o app e o software compartilhem o número e as conversas.
  • Cloud API: a API hospedada pela Meta para enviar e receber mensagens do WhatsApp Business; o caminho oficial para software.
  • Modo de entrada: para onde vão as mensagens recebidas de um número, exibido na página dele em Where incoming messages go como Through easyCoexistence ou Straight to your system.
  • Through easyCoexistence (managed): a Meta entrega as mensagens ao easyCoexistence, as automações e as Conversations podem usar as mensagens e uma Forward URL opcional recebe uma cópia assinada.
  • Straight to your system (direct): a Meta envia as mensagens do número direto para o seu próprio destino de webhook, e as automações ficam desligadas.
  • Forward URL: o seu endpoint HTTPS que recebe cada alteração recebida de um número gerenciado, 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 em um número. O gatilho define o evento e a correspondência o restringe; só uma automação responde a cada mensagem, por ordem de 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, em um número, ligada ou desligada como um todo.
  • Gatilho: o evento que inicia uma automação; em um 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 qualquer coisa que o cliente escreva.
  • Has keyword: roda quando a mensagem corresponde a uma de até 30 palavras-chave; maiúsculas e minúsculas não importam.
  • Keyword mode: Contains (em qualquer parte da mensagem), Starts with (no início) ou Is exactly (a mensagem inteira).
  • First message: roda em uma conversa sem histórico, inclusive na primeira mensagem de um cliente recorrente depois que as automações são ligadas, ou após cerca de 30 dias sem atividade.
  • After hours: roda enquanto você está fechado, com base em Timezone, Open on days e nos horários From / To em 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 rodam em ordem, de cima para baixo, depois do bloco Trigger, e dois deles ramificam: Split into paths (por regras sobre texto, campos, tags ou horários) e AI picks the path (pelo sentido) têm, cada um, uma linha de passos por caminho, além de uma linha Otherwise. Uma linha comporta até 30 passos, 60 no total, com ramificações aninhadas em até 4 níveis. Um número aceita 19 tipos de passo; além dos abaixo, o editor oferece Ask a question (até 3 botões tocáveis, espera a resposta e a salva em um campo do contato), Agent answers, Hand to a person (pausa o bot no chat e envia um e-mail para você), 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 seus termos:

  • Reply with text: uma mensagem fixa de até 4.096 caracteres, enviada exatamente como foi escrita.
  • Variáveis: {{first_name}}, {{name}}, {{message}} e {{phone}}, mais {{contact.field}} para um campo salvo do contato e {{vars.name}} para a resposta de um passo anterior, preenchidas quando o passo roda.
  • 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 da Anthropic, OpenAI ou OpenRouter, escreve a resposta.
  • Instructions: o prompt do passo de IA, ou de um agente, com até 20.000 caracteres; um agente também pode usar arquivos de conhecimento, links e texto.
  • Call my webhook: envia a mensagem e até 10 mensagens recentes da conversa para a sua URL, e devolve ao cliente a resposta recebida em até 20 segundos.
  • Wait: pausa a execução por 1 a 1.380 minutos, ou seja, 23 horas, antes do próximo passo.
  • Stop: encerra a execução; só pode ser o último passo da sua linha.

Quais regras e limites têm nome próprio?

Alguns termos vêm da Meta e valem para qualquer empresa no WhatsApp; outros são configurações em Advanced, no editor de automações. Ambos definem se uma resposta é enviada ou não, por isso vale conhecê-los pelo nome:

  • Janela de 24 horas: a janela de atendimento da Meta; mensagens que não são templates só são permitidas dentro de 24 horas após a última mensagem do cliente.
  • Template: um formato de mensagem que a Meta revisa com antecedência, na categoria marketing, utilidade ou autenticação; necessário para iniciar a conversa ou escrever depois de 24 horas.
  • Opt-in: a pessoa passou o número dela e concordou em receber as suas mensagens, o que a Meta exige antes de você iniciar a conversa.
  • Echo: o webhook smb_message_echoes da Meta, que informa uma mensagem que você enviou pelo app ou por um dispositivo vinculado.
  • Intervenção humana: a pausa depois que você responde pelo celular ou pelas Conversations, definida em "Pause on a chat after I answer it (hours)", 4 por padrão, de 0 a 168.
  • Limite de respostas de IA: "AI replies per chat per hour, at most", 10 por padrão, de 1 a 60.
  • Tokens: as unidades que os provedores de IA cobram; "Longest reply (tokens)" limita uma resposta, 600 por padrão, de 50 a 2.000.
  • Regra dos 14 dias: a Meta desconecta um número em Coexistência cujo app não é aberto no celular por cerca de 14 dias.

O que significam os termos do registro de execuções?

Cada vez que uma automação começa a partir de uma mensagem, ela deixa uma execução na aba Runs, guardada por 30 dias, com a saída, o tempo e os tokens de cada passo. Estes termos explicam o que você vê ali:

  • Execução: cada vez que uma automação roda em uma mensagem recebida, em uma tag ou em uma chamada de webhook, ou em um teste.
  • Status da execução: Queued, Running, Waiting (parada em um passo Wait), Done, Failed ou Skipped.
  • Motivo para pular: por que uma execução parou de propósito, como "You answered this chat from your phone recently".
  • Test it / Try it: roda os passos salvos em uma mensagem de exemplo; nada é enviado, mas a IA e o webhook rodam de verdade.
  • Paused: o status de uma automação cuja chave de IA foi recusada pelo provedor; ela volta a rodar quando uma chave que funcione é salva.
  • Superseded: uma execução em espera cancelada porque uma mensagem mais nova do cliente iniciou a mesma automação de novo.

Erros comuns

  • Confundir Paused com Off. Paused significa que a chave de IA parou de funcionar; a automação volta a rodar sozinha quando uma chave que funcione é salva, enquanto Off continua desligada até você ligá-la.
  • Tratar a mensagem de ausência do app e o After hours como a mesma coisa. Uma fica no app do celular e o software não a enxerga; a outra é uma automação do lado da API.
  • Esperar que First message dispare só para contatos totalmente novos. Ela dispara para qualquer conversa sem histórico salvo, inclusive com clientes recorrentes.
Fazendo isso com o EasyCoexistence

Crie as automações você mesmo no editor ou pedindo à sua IA, com a sua própria chave. De R$ 29,90 até R$ 3,90 por número conectado 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

Qual é a diferença entre uma automação e um agente de IA?

Uma automação é um gatilho e passos, mesmo quando ramifica: todo caminho é um que você desenhou. Um agente de IA decide sozinho a próxima ação. Um passo Agent answers coloca um dos seus agentes dentro de uma automação, com as instruções, o conhecimento e ferramentas como salvar um campo do contato ou passar o chat a uma pessoa, enquanto um passo Reply with AI apenas escreve a resposta. Um agente próprio completo também pode ficar por trás de Call my webhook ou de uma Forward URL.

Onde esses termos aparecem no painel?

Correspondências e modos de palavra-chave ficam no bloco Trigger do editor de automações, e os passos no menu + entre os blocos. A intervenção humana e o limite de respostas de IA ficam em Advanced, as execuções e os motivos para pular na aba Runs, e o modo de entrada na página do número.

Quais desses termos vêm da Meta?

Coexistência, Cloud API, a janela de 24 horas, os templates e suas categorias, opt-in, echoes e a regra dos 14 dias são da Meta. Correspondências, passos, intervenção humana, status de execução, motivos para pular e X-EC-Signature são nomes usados no painel e na API do easyCoexistence.

O que significa X-EC-Signature?

É o cabeçalho que comprova que uma chamada de webhook ou um encaminhamento veio do easyCoexistence: t=<unix seconds>,v1=<HMAC-SHA256 de "<t>.<body>"> gerado com um segredo que só você tem. O seu servidor recalcula a assinatura e compara antes de confiar na requisição.

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átis

Verificado em