EntrarComeçar teste grátis
Meta Tech Provider

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.

6 hours

No máximo um e-mail de falha por automação nesse intervalo; a aba Execuções guarda todas as falhas.

14 days

A Meta desconecta um número de Coexistência cujo app do WhatsApp Business fica sem ser aberto no celular por cerca desse tempo.

10 days

Com que frequência abrir o app no celular; mensagens enviadas ou recebidas pela API não contam como atividade.

1 Oct 2026

A partir desta data, a Meta deixa de entregar mensagens de serviço de empresas sem forma de pagamento cadastrada.

15 events

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.

A step failedYour webhook did not answer, the AI provider errored, or Meta refused a send.
AI key refusedThe key was deleted, expired or out of credit; automations using it pause.
Automations off for the numberThe number is set to Direct to your server, so no runs start.
Number disconnectedThe 14-day rule, a disconnection from the app, or a new registration elsewhere.
Messages not deliveredNo valid payment method on the WhatsApp Business account.
Restricted or low qualityMeta restricted the number, or blocks and reports pushed quality to Low.

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:

EmailWhat it says
A run fails on a real messageYes, 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 keyYes, once per incident"Action needed: your <provider> key stopped working", listing the paused automations
Meta disconnects the numberYes, once per dropMeta's reason, the time, and a link to reconnect
Meta stops delivering templatesYes, and again when it liftsThe cause, such as a missing payment method, and the steps in WhatsApp Manager
A run is skippedNoThe Runs tab shows the reason, such as your recent reply or the 24-hour window
Quality drops or Meta restrictsNoThe 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:

Requests to ChatGPT or Claude, and the tools they call
"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.
Fazendo isso com o EasyCoexistence

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

Verificado em