Problemas da API do WhatsApp: erros comuns e o que fazer

Os problemas da API oficial do WhatsApp aparecem em quatro momentos: na entrada do número, no envio das mensagens, na conta e na cobrança. Quase todos chegam com um código de erro e têm um caminho oficial para resolver. O que costuma piorar a situação é reenviar a mensagem ou registrar o número de novo sem saber o motivo.

Aqui, API é só a oficial, a conexão da própria Meta; a diferença para o aplicativo está em WhatsApp Business ou API oficial. Este é um dos problemas do WhatsApp na clínica. Com o número no app e na API ao mesmo tempo, os defeitos são outros, e estão em coexistência no WhatsApp. As regras são da Meta, consultadas em 13/11/2026, cada uma com o link.

Antes do primeiro paciente: número, registro e PIN

Os primeiros problemas aparecem no dia em que o número entra na API, e dá para conferir antes. Um número em uso no WhatsApp só é registrado na API depois que a conta do aplicativo é apagada, diz a documentação da Meta sobre números. O número sai do app do celular e o histórico do app não vai junto, por isso a clínica faz o backup das conversas antes. No número só na API, também não há ligações nem grupos pelo app.

Depois vem o passado do número. A mesma página é direta: número banido no WhatsApp só pode ser registrado depois de desbanido pelo processo de recurso. Apagar a conta e cadastrar o número de novo para fugir da punição não é caminho. Antes da troca, pergunte: o número já foi banido ou restrito, mesmo que tenha voltado? Já foi usado com ferramenta não oficial ou para disparo em massa? Já foi de outra empresa? Com algum sim, converse com o fornecedor antes de registrar, porque pode ser melhor começar com um número novo.

Por fim, o registro. A Meta aceita 10 pedidos por número em 72 horas; no 11º, devolve o erro 133016 e trava o registro por 72 horas, segundo a página de registro. O PIN de seis dígitos da verificação em duas etapas está sendo aposentado aos poucos; onde ainda existe, o erro 133005 diz que ele não confere, e o caminho é trocar o PIN no WhatsApp Manager, sem chutar outro. O passo a passo está em migrar o número para a API.

Verificação da empresa não é o selo azul

Verificação da empresa e selo azul são coisas diferentes: o passo a passo da Meta diz que a verificação no Meta Business Suite "é diferente do Meta Verified para empresas e não concederá um selo de verificado".

A verificação confirma que o portfólio, o cadastro da empresa na Meta, é de uma empresa de verdade, explica a Central de Ajuda para Empresas. No passo a passo, razão social, endereço, telefone e site precisam corresponder exatamente aos da empresa registrada, e o site tem de abrir com HTTPS. Sem correspondência, a Meta pede documentos, como o contrato social. A decisão pode levar até 14 dias úteis, e mudar os dados depois obriga a verificar de novo.

Ela não é exigida para começar. Com a empresa verificada, o limite de pacientes alcançados fora da janela de 24 horas sobe de 250 para 2.000 por dia, e o portfólio passa a registrar 20 números em vez de 2.

O nome de exibição aparece no perfil do número. No topo da conversa, só depois que a Meta verifica esse nome, o que acontece sozinho quando o número sobe de limite, segundo a página de nomes de exibição. Se o paciente salvou o contato com outro nome, aparece o dele.

Modelos recusados, recategorizados ou pausados

Passadas 24 horas da última mensagem do paciente, a clínica só fala com ele por modelo, um texto aprovado antes pela Meta; mensagem livre dá o erro 131047.

A Meta decide em até 24 horas, e a página de revisão de modelos lista os motivos comuns de recusa. Três pesam na clínica: a variável mal montada, como o {{1}} no começo ou no fim do texto; o pedido de dado sensível, porque a Meta não aceita pedir número de identificação nacional, que aqui é o CPF, nem de cartão; e o modelo com o mesmo texto de outro já cadastrado.

Para a Meta, utilidade é mensagem sem intenção promocional, e o aviso útil com uma oferta no fim é marketing, diz a página de categorias. "Sua consulta é amanhã às 9h. Aproveite e agende a limpeza com desconto" deixa de ser lembrete. No Brasil, a mensagem de utilidade custa R$ 0,035 e a de marketing, R$ 0,3217, pela tabela de preços da Meta: o marketing custa cerca de nove vezes a utilidade.

Quem repete o erro de categoria sobe uma escada: aviso, limite no volume de utilidade por 7 dias, restrição dos modelos de utilidade por 7 dias (30 na reincidência) e restrição do portfólio inteiro por 30 dias, com o erro 131064. O que cabe em cada categoria está nas regras do WhatsApp para clínicas. E o modelo aprovado ainda tem nota de qualidade: com muitos bloqueios, ele é pausado (132015) e, pausado de novo, desativado.

Limite de envio e qualidade do número

O limite de envio conta quantos pacientes diferentes a clínica alcança fora da janela de 24 horas, em 24 horas. Ele é do portfólio, e todos os números da clínica dividem o mesmo limite, diz a página de limites da Meta. Responder o paciente dentro da janela não gasta limite.

A qualidade vem do que os pacientes fizeram com as mensagens nos últimos 7 dias: bloqueios, denúncias, conversas silenciadas ou arquivadas, segundo a documentação de envio. Muitos bloqueios levam ao erro 131048, uma restrição de envio no número.

O 131049 não é punição: é o limite que o WhatsApp põe em quantas mensagens de marketing uma pessoa recebe de todas as empresas juntas. A página desse limite pede para esperar pelo menos 24 horas: reenviar logo dá o mesmo erro. O lembrete de utilidade fica fora dele.

Conta restrita, punição e o erro 130497

Na plataforma, a punição por violar a política sobe em degraus, segundo a página de aplicação da política: aviso; bloqueio de 1 ou 3 dias nos modelos; bloqueio de 5, 7 ou 30 dias de qualquer mensagem; trava da conta sem prazo, que só sai com recurso; e desligamento.

O motivo aparece no Business Support Home, a página de suporte da Meta para empresas, onde também se pede a revisão. A Meta diz que a análise costuma levar de 24 a 48 horas e que nem toda violação de spam pode ser contestada. Conta encerrada pode deixar a empresa inteira proibida de usar o WhatsApp, prevê a política de mensagens. Nenhum fornecedor decide o recurso, então quem vende "desbloqueio" vende o que não controla. O banimento no aplicativo tem outro caminho, explicado em WhatsApp da clínica bloqueado.

A Meta define o 130497 assim: a conta do WhatsApp Business "está restrita de enviar mensagens a usuários de certos países", e manda consultar os países permitidos para a categoria do negócio. O texto fala da conta, não do número. Antes de trocar de número, abra um chamado na Meta e pergunte o motivo. A leitura é nossa: se a restrição estiver na conta, um número novo na mesma conta pode dar o mesmo erro.

Cobrança, troca de fornecedor e a regra sobre IA

Desde 01/10/2026, a Meta cobra também as respostas ao paciente dentro da janela, com 1.000 grátis por mês em cada número, sem acumular. Para quem opera a API por conta própria: sem forma de pagamento, a Meta entrega as respostas grátis e deixa de entregar as seguintes, diz a página de preços. A conta de uma clínica está em quanto custa a API do WhatsApp.

Entre 23/09 e meados de outubro de 2026, a Meta separou a conta do número, que é sempre da empresa, da conta de mensagens de cada fornecedor, e a migração de número entre fornecedores acabou, segundo a página do novo modelo de contas. A clínica compartilha o número com o fornecedor novo, e os modelos precisam ser recriados: os copiados voltam à qualidade inicial e levam de 2 a 4 semanas para se firmar.

Sobre IA, o texto da Meta diz que, desde 15/01/2026, fornecedores de IA só oferecem assistente de uso geral onde a lei obriga a Meta a permitir, segundo a página sobre provedores de IA. No Brasil, eles podem mandar mensagens de atendimento desde 11/03/2026, e a Meta cobra por elas. A leitura é nossa, não da Meta: a assistente de agendamento de uma clínica, que responde sobre a clínica e passa o resto para uma pessoa, não é de uso geral. Isto, sim, é regra da Meta: a política de mensagens exige um caminho claro para o paciente falar com uma pessoa.

Os códigos de erro e o que a clínica faz

Antes de suspeitar da conta, veja na página de status da Plataforma do WhatsApp Business se a Meta está com falha naquele momento. Os significados abaixo são da página de códigos de erro da Meta, atualizada em 18/06/2026, em tradução nossa. A última coluna é orientação nossa.

Código	O que a Meta diz	O que a clínica faz
131047	Passaram mais de 24 horas desde a última resposta do destinatário	Mandar por modelo
131026	Não foi possível entregar: número sem WhatsApp, termos novos não aceitos ou app antigo	Confirmar o número por telefone ou no balcão
131049	A mensagem não foi entregue para manter um engajamento saudável no ecossistema	Esperar 24 horas para reenviar
131050	O destinatário escolheu parar de receber marketing da empresa	Não reenviar marketing
131048	Há restrição de envio no número, talvez por mensagens bloqueadas ou marcadas como spam	Ver a qualidade e parar o envio que causou
132015	Modelo pausado por baixa qualidade	Editar o texto e reenviar
131064	A conta atingiu o limite por violações na classificação dos modelos	Corrigir as categorias e esperar o prazo
131042	Erro relacionado à forma de pagamento	Conferir o pagamento da conta
133016	Tentativas demais de registro deste número em pouco tempo	Parar por 72 horas
133005	PIN da verificação em duas etapas incorreto	Trocar o PIN no WhatsApp Manager, sem chutar outro
368 e 131031	Conta restrita ou desativada por violar uma política da plataforma	Ler o motivo e pedir revisão
130497	Conta restrita de enviar a usuários de certos países	Abrir chamado antes de trocar de número

A implantação confere o número antes de a assistente atender

A assistente virtual que oferecemos atende pela API oficial da Meta, sem conexão paralela. O número fica só no WhatsApp oficial e sai do app do celular, depois do backup das conversas. Antes, perguntamos o passado dele; se houver risco, sugerimos um número novo ou fazemos um teste curto de entrega. O portfólio fica em nome da clínica, e os modelos de lembrete são cadastrados na implantação. O custo da Meta está incluído nas 1.200 mensagens por agenda de cada mês. Se o número da clínica não puder ser ativado, porque a Meta recusou ou não ativou a ligação dele à conexão oficial, devolvemos o valor pago.

Na demonstração da Clínica da Saúde, a Maria marca, remarca e confirma consultas e manda lembrete 24 horas e 1 hora antes. Dúvida de saúde vai para a equipe, que assume a conversa pelo Painel. Para ver como ela atende, fale com a Maria no fim deste artigo.

Por onde começar a evitar os problemas da API

Antes de ligar um sistema à API, confira: se o número já foi banido, restrito ou usado com ferramenta não oficial; se o portfólio na Meta está em nome da clínica, com a razão social do CNPJ; e, se a clínica for operar a API por conta própria, se há forma de pagamento cadastrada.