--- title: "Os 7 erros que derrubam um agente de WhatsApp em produção (e como pegar cada um antes do cliente)" url: https://samambai.com/pt/blog/erros-que-derrubam-agente-de-whatsapp-em-producao/ date: 2026-10-14 author: samambai --- O chat continua e o lembrete para. As causas são pagamento, moeda ou verificação, janela contada do lado errado, modelo, passagem sem histórico, telefone mal formatado e um fluxo que marca sucesso sem entregar. O status de entrega mostra cada falha 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](/pt/agente-de-ia-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 [1]. Se duas páginas discordarem, a fatura do Gerenciador do WhatsApp decide [1][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) [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 [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 [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 [2]. O modelo cai, e a resposta livre ainda pode sair dentro das 1.000 [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 [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 [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 [3]. No webhook, `failed` (falhou) com 131042 confirma a causa [4]. **Como evitar.** Cadastre o cartão no Billing Hub da conta de mensagens [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 [2]. ## 2. Moeda indefinida ou empresa não verificada **O que acontece.** Sem moeda, a API devolve o erro 131042 [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 [8]. O teto de modelos é 250 sem verificação e vai a 6.000 com verificação e nome de exibição aprovado [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 [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 [2][6][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) [3]. O registro precisa estar `CONNECTED` (conectado). Um número desconectado não envia [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 [1][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 [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 [2]. Há um caso raro, documentado, em que a mensagem chega e não dá para responder na janela [5]. O lembrete de amanhã precisa de um modelo de utilidade já aprovado. Promoção, ou texto misturado com promoção, é marketing [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 [2][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 [6]. `read` (lida) já implica entrega, e o webhook de `delivered` pode não chegar [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 [6]. O erro 132001 é idioma ausente ou modelo não aprovado [2]. Desde 9 de abril de 2025, utilidade que o WhatsApp lê como marketing é aprovada como marketing [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 [7]. O erro 131064, penalidade por abuso, atinge modelo e mensagem direta até a penalidade acabar [2]. O recurso fica aberto 60 dias no Business Support Home [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 [6]. A troca chega em `template_category_update` [7]. **Como evitar.** Escreva utilidade sem oferta, cupom ou convite. Uma frase promocional vira marketing [7]. Reenviar o mesmo texto alimenta o erro 131064 [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 [5][8]. Sem o mais, ela prefixa o país da empresa. `(631) 555-1234` vira `+916315551234` se a empresa está na Índia [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 [5][8]. O texto enviado pode diferir do `wa_id`, o identificador do contato [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 [5][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 [5]. No webhook, `sent` (enviada), `delivered` (entregue no aparelho), `read` (lida), `failed` (falhou e traz o código) e `played` (mídia reproduzida) [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 [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 [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 [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 [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 [9][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 [2]. No token de 60 dias, anote a emissão e alarme antes do dia 60 [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 [5]. Não tire o cartão em produção para forçar o 131042. Não leia fatura zero como envio [1]. Não conte a janela pela mensagem do agente [5]. Não agende modelo fora de `APPROVED` e não esconda marketing em utilidade [6][7]. Não mande telefone de planilha [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) [3]. - `failed` em sete dias: 131042 (pagamento), 131047 (janela fechada), 132001 (modelo) e 190 (token expirado) [2][4]. - Aceites da API contra `delivered` ou `read` [4][5]. - Modelo fora de `APPROVED`, e qualquer `template_category_update` [6][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 [1][4]. - Alarme antes do dia 60, se o token é o de 60 dias [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` [2][4]. - Telefones de teste: com mais, sem mais, 9 duplicado e México [5][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](/pt/blog/agente-de-ia-no-whatsapp-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 [1][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](/pt/precos/). 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.