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.
No máximo um email de falha por automatização neste período; o separador Runs regista todas as falhas.
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.
Com que frequência abrir a app no telemóvel; as mensagens enviadas ou recebidas pela API não contam como atividade.
A partir desta data, a Meta deixa de entregar mensagens de serviço a empresas sem método de pagamento registado.
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.
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:
| 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 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:
"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.
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 gratuitoVerificado em