Fale com a gente
GUIA

Erro 131030 da API do WhatsApp: por que o destinatário não está na lista permitida?

O erro 131030 quer dizer que você está enviando de um número de teste para um telefone que não está na lista de destinatários desse número. Enquanto você monta no número de teste da Meta, ele só manda mensagem para os números cadastrados como destinatários no painel de desenvolvedor; para falar com qualquer pessoa, conecte um número real da empresa.

Se o número está na lista e o erro continua, compare os formatos: o número que chega ao webhook e o da lista precisam bater dígito por dígito, com o código do país.

Atualizado em 8 de out. de 2026

Como funciona

  1. Veja qual número está enviando

    Se quem envia é o número de teste gratuito da Meta, só destinatários cadastrados recebem mensagens dele.

  2. Cadastre o destinatário

    No painel de desenvolvedor, adicione o número da pessoa como destinatário do número de teste.

  3. Compare os formatos

    Registre o número exatamente como o webhook entrega e como a lista guarda. Um dígito a menos basta para o erro.

  4. Corrija o número antes de enviar

    Padronize o número na etapa que envia a resposta, para bater com o formato guardado.

  5. Passe para um número real

    Com os testes certos, registre o número da própria empresa; a lista de destinatários deixa de valer.

Quanto custa manter

Resolver este erro não custa nada. Quanto custam as mensagens depois, com um número real, está no guia sobre conectar o WhatsApp a um assistente.

O que aprendemos montando

A nossa própria clínica fictícia de demonstração, montada num número de teste da Meta em 27 de setembro de 2026. Não é sistema de cliente.

Os números brasileiros perdiam o nono dígito
Os celulares brasileiros chegavam ao nosso webhook sem o nono dígito (12 dígitos), enquanto a lista guardava com ele (13 dígitos). Toda resposta falhava com 131030 até a etapa de envio recolocar o 9.
Outro erro parece igual
Um número de teste de uma empresa não verificada não conseguia entregar para números brasileiros (erro 130497), mesmo cadastrados. As respostas foram escritas; a Meta recusou a entrega.

Quando não vale a pena

  • Não monte um jeito de contornar o número de teste para clientes reais: registre o número da empresa.

Perguntas

O 131030 acontece num número real da empresa?

A lista de destinatários é do número de teste. Num número da empresa registrado, uma falha de entrega tem outro código.

O cliente vê o erro?

Não. A mensagem dele chegou; a sua resposta foi recusada, então ele simplesmente fica sem resposta. Por isso o erro importa.

O formato do número é igual em todo país?

Não. O Brasil é o caso que pegamos: o celular pode chegar com ou sem o nono dígito. Padronize os números dos países que você atende.

Fontes

Quer um assistente no WhatsApp no seu próprio número, testado antes de responder alguém?

Ver o serviço: Assistentes para WhatsAppFale com a gente

Todos os guias