Saiba quando uma automação do WhatsApp para: alertas e monitoramento
Uma automação do WhatsApp pode parar por motivos internos, como uma etapa com falha ou uma chave de IA recusada pelo provedor, ou por motivos externos: o número desconectado, a Meta sem entregar suas mensagens ou uma restrição. Monitore as duas camadas. Receba alertas de execuções com falha, chaves recusadas e desconexões, verifique a conexão e a classificação de qualidade do número e consulte o histórico de execuções para ver as respostas que foram puladas de propósito.
A easyCoexistence monitora cada número de WhatsApp conectado 24 horas por dia e envia um e-mail quando a Meta desconecta o número, com o motivo; quando a Meta deixa de entregar as mensagens de template dele e de novo quando a entrega volta; quando uma execução falha em uma mensagem real; e quando seu provedor de IA recusa sua chave.
No máximo um e-mail de falha por automação nesse intervalo; a aba Execuções guarda todas as falhas.
A Meta desconecta um número de Coexistência cujo app do WhatsApp Business fica sem ser aberto no celular por cerca desse tempo.
Com que frequência abrir o app no celular; mensagens enviadas ou recebidas pela API não contam como atividade.
A partir desta data, a Meta deixa de entregar mensagens de serviço de empresas sem forma de pagamento cadastrada.
Entradas recentes da linha do tempo de monitoramento que get_number_health retorna, junto com um retrato ao vivo do número vindo da Meta.
O que pode fazer uma automação do WhatsApp parar de responder?
Os problemas ficam em duas camadas, e uma estratégia de alertas precisa cobrir as duas. A camada da automação são suas etapas, sua chave e suas configurações. A camada do número é a conexão com a Meta, a situação do número e a cobrança do lado da Meta. Uma automação saudável em um número desconectado não responde a ninguém, e um número saudável com uma chave recusada não gera respostas de IA.
Quais problemas geram um alerta por e-mail?
Os alertas vão para o e-mail da conta, em inglês, português ou espanhol. O número de telefone para alertas pedido no cadastro não é usado para enviá-los. Os e-mails existem para que uma pessoa responda ao cliente que a automação não conseguiu atender; problemas que deixam o número funcionando, mas sem atividade, aparecem no painel, e não por e-mail. Veja o que chega por e-mail e o que você mesmo precisa verificar:
| What it says | ||
|---|---|---|
| A run fails on a real message | Yes, one per automation every 6 hours at most | "<automation> could not answer <customer>", with the message, the error and "Open the run" |
| Your AI provider refuses the key | Yes, once per incident | "Action needed: your <provider> key stopped working", listing the paused automations |
| Meta disconnects the number | Yes, once per drop | Meta's reason, the time, and a link to reconnect |
| Meta stops delivering templates | Yes, and again when it lifts | The cause, such as a missing payment method, and the steps in WhatsApp Manager |
| A run is skipped | No | The Runs tab shows the reason, such as your recent reply or the 24-hour window |
| Quality drops or Meta restricts | No | The number's page shows Degraded or Banned / restricted, and the timeline records it |
Como funciona o monitoramento do número?
São duas fontes, para que uma queda seja detectada mesmo quando uma delas fica em silêncio. A Meta envia atualizações da conta por webhook assim que acontecem, incluindo uma desconexão com o motivo, como PRIMARY_INACTIVITY no caso da regra dos 14 dias. Uma checagem de saúde agendada também consulta cada número conectado na Meta: o status, a classificação de qualidade, o limite de mensagens, o throughput e se ele consegue entregar mensagens iniciadas pela empresa. Um número que a Meta não consegue mais ler é marcado como Disconnected e você recebe um e-mail, e as mudanças entram na linha do tempo do número. Números suspensos, cuja assinatura terminou, não são monitorados.
O que é a regra dos 14 dias e como evitá-la?
A Meta desconecta um número de Coexistência quando o app do WhatsApp Business no celular principal fica sem ser aberto por cerca de 14 dias. O tráfego pela API não conta, então um número cheio de automações ainda pode ser desconectado se ninguém abrir o app. Abra o app nesse celular pelo menos a cada 10 dias e deixe-o sincronizar. Se a desconexão acontecer, o e-mail informa o motivo; abra o app, espere a sincronização e clique em "Reconectar este número" na página do número. Se o destino de webhook que seu sistema usava estava salvo, ele é restaurado automaticamente quando você reconecta.
Como verificar a saúde por conta própria?
No painel, a lista de Automações mostra a última execução de cada automação, as "execuções nos últimos 30 dias" e quantas falharam, e o filtro de status "Precisa de atenção" lista as que têm uma chave recusada, as que estão Ligadas enquanto as automações do número estão desligadas e as que tiveram uma execução com falha nos últimos 30 dias. A página de cada número mostra o status (Connected, Degraded, Disconnected, Banned / restricted), a classificação de qualidade e uma linha do tempo. Sua IA pode verificar as mesmas informações pelo conector MCP, e get_number_health continua funcionando mesmo com a cobrança em atraso:
"Is my WhatsApp number healthy?"
-> list_numbers, then get_number_health
(quality, status, Coexistence link, last 15 events)
"Did any automation fail this week? Why?"
-> list_automations, then list_automation_runs with status "failed"
"Show me what happened in that run."
-> get_automation_run (each step's input, output, error and timing)O que fazer quando chega um alerta?
Primeiro responda ao cliente que estiver esperando, depois corrija a causa. Cada alerta tem uma solução habitual:
- Uma execução falhou: responda a esse cliente pelo app, abra a execução em "Abrir a execução" e corrija a etapa indicada no erro.
- Uma chave parou de funcionar: adicione crédito ou crie uma nova chave e clique em "Testar e salvar" em "Chaves de IA"; as automações pausadas voltam a funcionar sozinhas.
- O número foi desconectado: abra o app do WhatsApp Business no celular, espere a sincronização e reconecte pela página do número.
- Os templates não estão sendo entregues: no WhatsApp Manager, em Ferramentas da conta, Cobrança e pagamentos, adicione um cartão na própria conta do WhatsApp Business.
- A qualidade está baixa (Low): pause o que começou a gerar bloqueios, muitas vezes um template enviado a pessoas que não esperavam recebê-lo.
Erros comuns
- Contar com o tráfego das automações para manter o número conectado. Mensagens enviadas ou recebidas pela API não contam para a regra dos 14 dias da Meta; só abrir o app no celular conta.
- Achar que uma caixa de entrada sem alertas significa que a automação está saudável. Execuções puladas não geram e-mail, então confira a aba Execuções ou o filtro Precisa de atenção uma vez por semana.
- Adicionar um cartão na conta de anúncios ou no Portfólio de Negócios quando os templates deixam de ser entregues. A Meta exige a forma de pagamento na própria conta do WhatsApp Business.
- Supor que um e-mail de falha significa uma única falha. Novas falhas da mesma automação dentro de 6 horas aparecem só no histórico de execuções, então abra a aba Execuções.
Sua IA pode verificar a mesma saúde pelo conector MCP. De R$ 29,90 a 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
Recebo algum aviso antes de os 14 dias acabarem?
Não. O e-mail chega quando a Meta desconecta o número, não antes. Crie o hábito de abrir o app do WhatsApp Business nesse celular pelo menos a cada 10 dias.
Posso receber os alertas por WhatsApp ou SMS em vez de e-mail?
Hoje, não. Os alertas são enviados por e-mail para o endereço da conta, e o número de telefone informado no cadastro não é usado para isso.
Um teste com falha gera e-mail?
Não. Execuções feitas pelo Testar no painel e por test_automation são marcadas como testes e nunca geram e-mail, então testar um webhook quebrado não vai lotar sua caixa de entrada.
O que acontece com o monitoramento se minha assinatura terminar?
Um número suspenso por falta de pagamento deixa de ser monitorado, e as automações dele param. Ao reconectá-lo com uma assinatura ativa, o monitoramento volta.
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