Os 7 erros que derrubam um agente de WhatsApp em produção (e como pegar cada um antes do cliente)

Sete falhas derrubam um agente de WhatsApp em produção com o chat ainda no ar: pagamento, moeda ou verificação, janela de 24 horas contada pelo agente, modelo errado ou em revisão, passagem sem histórico, telefone mal formatado, e sucesso marcado sem entrega. O token vencido entra nesse último caso. O status de entrega (entregue, lida ou falhou) mostra cada falha antes do cliente.

O desenho do atendimento está em agentes de IA no WhatsApp.

O que mudou no preço em 1º de outubro de 2026

A página de preços, atualizada em 30 de setembro de 2026, vale desde 1º de outubro de 2026, no fuso da conta de mensagens. A Meta cobra a mensagem entregue. Fatura zerada não prova que o lembrete saiu. A janela de ponto de entrada gratuito segue sem cobrança Fonte [1]. Se duas páginas discordarem, a fatura do Gerenciador do WhatsApp decide Fonte [1]Fonte [11].

• Desde 1º de outubro de 2026, a resposta dentro da janela de 24 horas é cobrada na tarifa de utilidade do país. Na franquia abaixo, o tipo é free_customer_service (serviço grátis). Acima dela, o tipo é regular (cobrada) Fonte [1].
• Cada número tem 1.000 mensagens de serviço grátis por mês, sem acúmulo. A contagem zera à meia-noite, no fuso da conta Fonte [1].
• Sem forma de pagamento, só as grátis saem. A utilidade dentro da janela também passou a ser cobrada em 1º de outubro de 2026, fora da franquia. Esse envio era grátis desde 1º de julho de 2025. Só a mensagem de serviço usa as 1.000 Fonte [1].

1. Conta sem forma de pagamento

O que acontece. Lembrete e aviso saem como modelo e falham com o erro 131042, falta de forma de pagamento. A Meta publica estas causas: conta de pagamento desligada do WhatsApp Business, linha de crédito estourada ou inativa, conta apagada ou suspensa, fuso ou moeda ausente, pedido para operar em nome de outra empresa pendente ou recusado Fonte [2]. O modelo cai, e a resposta livre ainda pode sair dentro das 1.000 Fonte [1]. Um provedor de solução ou uma empresa integrada direto, sem pagamento em 30 de setembro de 2026, perde essa mensagem de serviço quando a cobrança começa, em 1º de outubro Fonte [1].

Como aparece. O chat responde e o lembrete de amanhã não sai. Vimos em produção. A fatura não avisa, porque a Meta não cobra o que não entregou Fonte [1].

Como pegar. Leia o health_status: telefone (PHONE_NUMBER), conta do WhatsApp Business (WABA), empresa (BUSINESS) e aplicativo (APP). BLOCKED (bloqueado) bloqueia o conjunto. Sem bloqueio, LIMITED (limitado) limita o conjunto Fonte [3]. No webhook, failed (falhou) com 131042 confirma a causa Fonte [4].

Como evitar. Cadastre o cartão no Billing Hub da conta de mensagens Fonte [1]. Vimos em produção o cartão na conta de anúncios, com a conta de mensagens sem pagamento. A conta de pagamento tem de estar ligada ao WhatsApp Business Fonte [2].

2. Moeda indefinida ou empresa não verificada

O que acontece. Sem moeda, a API devolve o erro 131042 Fonte [2]. Sem verificação, um portfólio novo fica em 2 números até a empresa ser verificada ou o limite de mensagens chegar a 2.000. Aí o teto passa a 20 Fonte [8]. O teto de modelos é 250 sem verificação e vai a 6.000 com verificação e nome de exibição aprovado Fonte [6]. Você escolhe a moeda na criação. Desde 1º de julho de 2026 são 16 moedas, sem troca no mesmo lugar. A troca usa a API de migração Fonte [1].

Como aparece. O número limita ou bloqueia, o lembrete cala, e o teste da hora ainda passa. Vimos em produção o health_status devolver 141006 e 141010. Moeda ausente continua no erro 131042. Verificação aparece no teto de números e de modelos Fonte [2]Fonte [6]Fonte [8].

Como pegar. Um nó LIMITED traz additional_info (detalhe extra). Um nó BLOCKED traz error_code (código), error_description (descrição) e possible_solution (o que fazer) Fonte [3]. O registro precisa estar CONNECTED (conectado). Um número desconectado não envia Fonte [8].

Como evitar. Verifique o portfólio antes do lembrete automático e antes de um terceiro número. A moeda fica definida na criação Fonte [1]Fonte [8].

3. Janela de 24 horas contada do lado errado

O que acontece. A janela dura 24 horas e só abre ou reinicia quando a pessoa manda mensagem ou liga. A resposta do agente não abre a janela Fonte [5]. Fora dela, texto livre volta o erro 131047, mais de 24 horas desde a última resposta do destinatário. A saída é um modelo Fonte [2]. Há um caso raro, documentado, em que a mensagem chega e não dá para responder na janela Fonte [5]. O lembrete de amanhã precisa de um modelo de utilidade já aprovado. Promoção, ou texto misturado com promoção, é marketing Fonte [7].

Como aparece. A demonstração passa porque alguém escreveu na hora. O lembrete da manhã não sai.

Como pegar. Texto livre para um número interno calado há mais de 24 horas tem de voltar 131047. O modelo de utilidade aprovado tem de chegar a delivered, entregue no aparelho Fonte [2]Fonte [4].

Como evitar. Grave a hora da última mensagem da pessoa e aprove o lembrete antes de ir ao ar. Se a ordem importa, espere delivered, porque várias mensagens não têm ordem garantida Fonte [6]. read (lida) já implica entrega, e o webhook de delivered pode não chegar Fonte [4].

4. Modelo na categoria errada ou ainda em revisão

O que acontece. Só APPROVED (aprovado) envia, e a revisão pode levar 24 horas. Rejeitado, pausado e desativado não enviam. No modelo ativo, qualidade pending (pendente), high (alta), medium (média) ou low (baixa) ainda envia Fonte [6]. O erro 132001 é idioma ausente ou modelo não aprovado Fonte [2]. Desde 9 de abril de 2025, utilidade que o WhatsApp lê como marketing é aprovada como marketing Fonte [7]. Na troca comum, a Meta avisa um dia antes, muda a categoria e mantém APPROVED. Aviso de abuso desde 16 de abril de 2025 tira esse dia. O webhook template_category_update avisa a troca, e a API mostra category (em uso) e correct_category (a que a Meta considera correta). A empresa responde pela categoria cobrada Fonte [7]. O erro 131064, penalidade por abuso, atinge modelo e mensagem direta até a penalidade acabar Fonte [2]. O recurso fica aberto 60 dias no Business Support Home Fonte [7].

Como aparece. O envio falha num modelo que parecia publicado, ou a fatura de marketing sobe numa categoria que você não escolheu.

Como pegar. Leia o status, assine message_template_status_update (mudança de status) e não agende modelo em revisão Fonte [6]. A troca chega em template_category_update Fonte [7].

Como evitar. Escreva utilidade sem oferta, cupom ou convite. Uma frase promocional vira marketing Fonte [7]. Reenviar o mesmo texto alimenta o erro 131064 Fonte [2].

5. Passagem para humano sem o histórico

O que acontece. O aviso chega para uma pessoa que não vê a conversa. Ela pede para o cliente repetir, e o cliente entende que a empresa esqueceu. Vimos em produção. Esse erro não vem da Cloud API. O histórico fica no sistema de vocês.

Como aparece. O cliente diz que já explicou e o atendente diz que não chegou nada. A notificação saiu sem o histórico.

Como pegar. O payload de teste precisa das últimas mensagens da pessoa, da última resposta do agente e do motivo. Se faltar um campo, o teste falhou.

Como evitar. Grave a transcrição no mesmo passo do aviso. Se a gravação falhar, a passagem falha. Não mande só o telefone.

6. Telefone no formato errado

O que acontece. A Cloud API aceita sinal de mais, hífen, parênteses e espaço, e recomenda o mais com o código do país Fonte [5]Fonte [8]. Sem o mais, ela prefixa o país da empresa. (631) 555-1234 vira +916315551234 se a empresa está na Índia Fonte [5]. No Brasil e no México, a API pode mudar esse prefixo. A Meta trata isso como comportamento padrão, não como defeito Fonte [5]Fonte [8]. O texto enviado pode diferir do wa_id, o identificador do contato Fonte [5]. Vimos em produção um celular brasileiro sem o nono dígito, e uma planilha com o 9 duplicado.

Como aparece. Parte da planilha não recebe, ou o wa_id abre outra conversa.

Como pegar. Teste com mais, sem mais, 9 duplicado e um número do México. Guarde o valor enviado e o wa_id. Para Brasil e México, não exija textos iguais Fonte [5]Fonte [8].

Como evitar. Converta para E.164 antes do envio: sinal de mais, código do país e o número, só com dígitos. Não use o texto cru da planilha.

7. "Deu sucesso" sem ter feito nada

O que acontece. No primeiro caso, a consulta volta zero linhas e o passo seguinte segue com campo vazio. Vimos em produção. O JSON de sucesso da API significa que a Meta aceitou, não que entregou Fonte [5]. No webhook, sent (enviada), delivered (entregue no aparelho), read (lida), failed (falhou e traz o código) e played (mídia reproduzida) Fonte [4].

No segundo caso, o token vence. No cadastro incorporado (Embedded Signup), o Facebook Login for Business sai do modelo "WhatsApp Embedded Signup Configuration With 60 Expiration Token", válido por 60 dias Fonte [9]. Vimos em produção HTTP 401 (não autorizado) depois que esse token venceu. Leia code e details. O código 190 é token expirado. O código 0 é falha ao autenticar o usuário do aplicativo: vencido, invalidado, ou ajuste mudado pela pessoa Fonte [2].

O token de usuário de sistema é outro. Renove-o a cada 60 dias com grant_type=fb_exchange_token e set_token_expires_in_60_days=true (id do aplicativo, segredo e token atual). Sem renovar, o token se perde. O novo substitui o antigo, que vale até a data original. Depois, revogue o antigo Fonte [12]. Há token sem prazo. A página recomenda o que expira. Sem a flag, ou com false, a chamada falha nas empresas que só aceitam token com prazo Fonte [12]. As versões 2 e 3, e os previews públicos, param em 15 de outubro de 2026. Passe à versão 4 antes disso Fonte [9]Fonte [10].

Como aparece. O painel fica verde, o cliente não recebe a mensagem, e o contador de execuções não mostra a falha. No token, ontem enviava e hoje a autenticação falha.

Como pegar. Em sete dias, compare o que a API aceitou com delivered ou read. Os códigos 190 e 0 são falha Fonte [2]. No token de 60 dias, anote a emissão e alarme antes do dia 60 Fonte [9].

Como evitar. Conte sucesso só com delivered ou read. Consulta vazia não segue. No teste da manhã, os poucos minutos de espera são critério da samambai. A Meta não publica esse prazo.

O que não fazer

Não dispare sem opt-in, o consentimento da pessoa para aquele contato Fonte [5]. Não tire o cartão em produção para forçar o 131042. Não leia fatura zero como envio Fonte [1]. Não conte a janela pela mensagem do agente Fonte [5]. Não agende modelo fora de APPROVED e não esconda marketing em utilidade Fonte [6]Fonte [7]. Não mande telefone de planilha Fonte [5]. Não passe o atendimento sem histórico. Não confunda conta de anúncios com conta de mensagens.

O que monitorar toda semana

No número em produção:

• health_status de PHONE_NUMBER, WABA, BUSINESS e APP fora de AVAILABLE (disponível) Fonte [3].
• failed em sete dias: 131042 (pagamento), 131047 (janela fechada), 132001 (modelo) e 190 (token expirado) Fonte [2]Fonte [4].
• Aceites da API contra delivered ou read Fonte [4]Fonte [5].
• Modelo fora de APPROVED, e qualquer template_category_update Fonte [6]Fonte [7].
• Serviço perto de 1.000 por número no mês. Passou disso, o tipo vem regular. Sem cartão, essa mensagem não sai Fonte [1]Fonte [4].
• Alarme antes do dia 60, se o token é o de 60 dias Fonte [9].
• De manhã, uma utilidade aprovada para um número interno. Na semana, texto livre fora da janela volta 131047, e a utilidade chega a delivered Fonte [2]Fonte [4].
• Telefones de teste: com mais, sem mais, 9 duplicado e México Fonte [5]Fonte [8].

Quando não contratar a samambai

Não contrate se uma pessoa no aplicativo WhatsApp Business dá conta do volume, sem sistema atrás do número.

Não contrate se um software do setor já faz a caixa inteira, sem CRM, ERP ou agenda por fora, sem um lembrete que ele não envia, e a operação não vai crescer além disso. O critério está em SaaS ou sob medida.

Não contrate sem pagamento na conta de mensagens, sem empresa verificada ou sem modelo aprovado antes de ir ao ar. Não contrate se ninguém lê a passagem para uma pessoa. Não contrate em troca de garantia de categoria, de preço por mensagem ou de promessa de que a Meta não restringe a conta. Categoria, preço e entrega são da Meta Fonte [1]Fonte [7].

O estúdio fica em São Paulo e entregou, em português e inglês, para times em São Paulo, Nova York, Madrid e Tel Aviv. A sprint de duas semanas custa US$ 1.200, cancela quando quiser, e serve para o agente já no ar, com conta, modelos e acesso prontos. O projeto, desde US$ 3.000, serve quando o agente ainda vai nascer ligado ao sistema, com escopo, prazo e preço fechados, uma entrega por sprint e suporte depois. A parceria, desde US$ 900 por mês, serve quando o monitoramento semanal fica no estúdio, com roadmap, prioridade e acompanhamento mensal. As três formas estão em preços. A primeira conversa dura 30 minutos e não cria compromisso. Automação em 2 a 4 semanas. Projeto em 4 a 8, em sprints de 2. Isso não cobre uma queda da Meta.