Iniciar sessãoIniciar teste gratuito
Meta Tech Provider

Saiba quando uma automatização do WhatsApp para: alertas e monitorização

Uma automatização do WhatsApp pode parar por motivos internos, como um passo falhado ou uma chave de IA recusada pelo fornecedor, ou por motivos externos: o número desligou-se, a Meta não entrega as mensagens que envia, ou existe uma restrição. Acompanhe as duas camadas. Receba alertas de execuções falhadas, chaves recusadas e desligamentos, verifique a ligação e a qualidade do número e leia o registo de execuções para ver as respostas que foram ignoradas de propósito.

A easyCoexistence monitoriza continuamente cada número do WhatsApp ligado e envia-lhe um email quando a Meta o desliga, indicando o motivo; quando a Meta deixa de entregar as mensagens de template e de novo quando isso for retomado; quando uma execução falha numa mensagem real; e quando o seu fornecedor de IA recusa a sua chave.

6 hours

No máximo um email de falha por automatização neste período; o separador Runs regista todas as falhas.

14 days

A Meta desliga um número em Coexistência cuja app do WhatsApp Business não seja aberta no telemóvel durante cerca deste período.

10 days

Com que frequência abrir a app no telemóvel; as 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 a empresas sem método de pagamento registado.

15 events

Entradas recentes da cronologia de monitorização que get_number_health devolve, com um instantâneo em tempo real do número, vindo da Meta.

Que problemas podem fazer uma automatização do WhatsApp deixar de responder?

Os problemas existem em duas camadas, e uma estratégia de alertas tem de cobrir as duas. A camada da automatização são os seus passos, a sua chave e as suas definições. A camada do número é a ligação à Meta, a situação do número e a faturação do lado da Meta. Uma automatização saudável num número desligado não responde a ninguém, e um número saudável com uma chave recusada não dá 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.

Que problemas geram um email?

Os alertas são enviados para o endereço de email da conta, em inglês, português ou espanhol. O número de telefone para alertas pedido no registo não é usado para os enviar. Os emails existem para que uma pessoa responda ao cliente que a automatização não conseguiu atender; os problemas que deixam o número a funcionar mas em silêncio aparecem no painel. Eis o que chega e o que deve verificar por si:

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 a monitorização do número?

Há duas fontes, para que uma queda seja detetada mesmo quando uma delas fica em silêncio. A Meta envia por webhook as atualizações da conta à medida que acontecem, incluindo um desligamento com o respetivo motivo, como PRIMARY_INACTIVITY para a regra dos 14 dias. Uma verificação de saúde agendada também lê cada número ligado na Meta: o estado, a classificação de qualidade, o limite de mensagens, o throughput e se pode entregar mensagens iniciadas pela empresa. Um número que a Meta já não consegue ler fica marcado como Disconnected e é comunicado por email, e as alterações ficam registadas na cronologia do número. Os números suspensos, cuja subscrição terminou, não são monitorizados.

O que é a regra dos 14 dias e como evitá-la?

A Meta desliga um número em Coexistência quando a app do WhatsApp Business no telemóvel principal não é aberta durante cerca de 14 dias. O tráfego através da API não conta, pelo que um número muito ocupado com automatizações pode ser desligado se ninguém abrir a app. Abra-a nesse telemóvel pelo menos a cada 10 dias e deixe-a sincronizar. Se acontecer, o email indica o motivo; abra a app, aguarde a sincronização e carregue em «Reconnect this number» na página do número. Um destino de webhook que o seu sistema usava é reposto automaticamente ao religar, se tiver sido guardado antes.

Como verifica a saúde por si?

No painel, a lista Automations mostra a última execução de cada automatização, «runs in 30 days» e quantas falharam, e o filtro de estado «Needs attention» lista as que têm uma chave recusada, as que estão On enquanto as automatizações do número estão desligadas, e as que tiveram uma execução falhada nos últimos 30 dias. A página de cada número mostra o estado (Connected, Degraded, Disconnected, Banned / restricted), a classificação de qualidade e uma cronologia. A sua IA pode verificar as mesmas coisas através do conector MCP, e get_number_health continua a funcionar mesmo com a faturação 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 deve fazer quando chega um alerta?

Responda primeiro ao cliente, se estiver à espera, e depois corrija a causa. Cada alerta tem uma correção habitual:

  • Uma execução falhou: responda a esse cliente a partir da app, abra a execução em «Open the run» e corrija o passo indicado no erro.
  • Uma chave deixou de funcionar: adicione crédito ou crie uma nova chave e carregue em «Test and save» na secção «AI keys»; as automatizações em pausa reiniciam sozinhas.
  • O número desligou-se: abra a app do WhatsApp Business no telemóvel, aguarde a sincronização e religue a partir da página do número.
  • Os templates não são entregues: no WhatsApp Manager, em «Account tools», «Billing & payments», adicione um cartão à própria conta WhatsApp Business.
  • A qualidade é Low: pause o que começou a gerar bloqueios, muitas vezes um template enviado a pessoas que não o esperavam.

Erros comuns

  • Contar com o tráfego das automatizações para manter o número ligado. As mensagens enviadas ou recebidas pela API não contam para a regra dos 14 dias da Meta; só abrir a app no telemóvel conta.
  • Ler uma caixa de entrada sem movimento como uma automatização saudável. As execuções ignoradas não enviam email, por isso verifique o separador Runs ou o filtro Needs attention uma vez por semana.
  • Adicionar um cartão à conta de anúncios ou ao Portefólio empresarial quando os templates deixam de ser entregues. A Meta precisa do método de pagamento na própria conta WhatsApp Business.
  • Supor que um email de falha significa uma só falha. As falhas posteriores da mesma automatização nas 6 horas seguintes existem apenas no histórico de execuções; abra o separador Runs.
Fazer isto com a EasyCoexistence

A sua IA pode verificar a mesma saúde através do conector MCP. De US$ 9 a US$ 0.75 por número por mês, descendo à medida que adiciona números, com os primeiros 3 dias gratuitos.

Perguntas frequentes

Recebo um aviso antes de os 14 dias acabarem?

Não. O email chega quando a Meta desliga o número, e não antes. Torne a abertura da app do WhatsApp Business nesse telemóvel uma rotina, pelo menos a cada 10 dias.

Os alertas podem chegar por WhatsApp ou por SMS em vez de email?

Para já não. Os alertas são enviados por email para o endereço da conta, e o número de telefone recolhido no registo não é usado para eles.

Um teste falhado envia um email?

Não. As execuções iniciadas em «Try it» no painel e a partir de test_automation são marcadas como testes e nunca enviam email, por isso testar um webhook avariado não enche a sua caixa de entrada.

O que acontece à monitorização se a minha subscrição terminar?

Um número suspenso por motivos de faturação deixa de ser monitorizado, e as suas automatizações param. Ao religar com uma subscrição ativa, a monitorização volta a funcionar.

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 gratuito

Verificado em