Código de erro

Causa (Descrição)

Solução possível

0

Não foi possível autenticar o usuário

Verifique que seu token de acesso seja válido e não tenha expirado.

1

API desconhecida.

Verifique a URL e o endpoint para o qual a requisição está sendo feita.

2

Serviço temporariamente indisponível

Problema nos servidores do Meta. Aguarde alguns minutos e tente novamente.

3

O app não tem permissões suficientes

Acesse Meta for Developers e certifique-se de conceder as permissões necessárias ao seu token/app.

4

Muitas solicitações

Você atingiu o limite de requisições da API. Reduza a velocidade de envio.

10

Permissões insuficientes para acessar o recurso

Valide que seu usuário ou token tenha as funções administrativas adequadas.

33

O número de telefone da empresa foi eliminado.

Você precisará registrar um novo número ou contestar a eliminação no seu Gerenciador do WhatsApp.

100

A requisição contém parâmetros inválidos

Verifique a estrutura dos dados que está enviando (faltam dados ou o formato está incorreto).

190

O token de acesso expirou

Gere um novo token de acesso permanente ou renove o temporário no Meta.

368

A conta comercial foi desabilitada por violar as políticas do WhatsApp

Acesse a seção "Qualidade da conta" no seu Meta Business Suite para ver os detalhes e contestar a decisão.

400

Não foi possível baixar o conteúdo multimídia enviado pelo remetente

Peça ao usuário que envie o arquivo novamente ou verifique se o formato é suportado.

401

Chave de API inválida.

Verifique que a chave de API configurada em sua conexão está correta.

402

A mensagem não foi enviada porque houve um ou mais erros relacionados ao método de pagamento

Acesse o Business Manager e atualize ou adicione um cartão de crédito válido.

403

O endpoint está bloqueado.

Entre em contato com nossa equipe de Suporte Técnico para revisar a conexão do seu canal.

404

Contato não existe

Verifique que o número de telefone do cliente está correto e que tem WhatsApp instalado.

408

Não foi possível enviar a mensagem porque ficou pendente por muito tempo

Erro de latência. Tente enviar a mensagem novamente.

410

Não foi possível enviar a mensagem durante seu tempo de vida

O sistema não pôde entregar a mensagem a tempo. Tente enviar novamente.

429

Limite de frequência atingido

Você está enviando mensagens muito rapidamente. Aguarde um momento e reduza a velocidade de envio.

430

Ocorreu um erro relacionado ao seu certificado

Verifique a configuração de seus webhooks e certificados de segurança.

432

Ocorreu um erro relacionado à assinatura do seu certificado

Valide a assinatura do certificado de segurança na configuração técnica.

433

Ocorreu um erro relacionado à assinatura do seu certificado

Valide a assinatura do certificado de segurança na configuração técnica.

470

Passaram mais de 24 horas desde a última mensagem do cliente. Por favor, use um modelo de mensagem

A janela de atendimento fechou. Use um Modelo do WhatsApp (HSM) para retomar o contato.

471

A mensagem falhou devido a restrições de quantidade de mensagens para este número de telefone

Atingiu o limite de envios diários (Tier). Verifique seu nível de mensagens no WhatsApp Manager.

472

A mensagem não pôde ser enviada porque o número de telefone do usuário é parte de um experimento

Restrição temporária interna do Meta. Não requer ação da sua parte.

480

A mensagem não foi enviada porque é possível que o usuário que pertence a este número de telefone tenha mudado.

Revalide o contato; é possível que a linha tenha mudado de proprietário.

500

Erro ao enviar mensagem

Erro interno e temporário. Tente novamente mais tarde.

1000

Formato não suportado ou excede o tamanho máximo permitido

Comprima seu arquivo (PDF, vídeo ou imagem) ou envie-o em um formato aceito.

1001

O comprimento da mensagem excede 4.096 caracteres

Encurte seu texto antes de enviá-lo (WhatsApp não suporta mensagens tão longas).

1002

Tipo de destinatário inválido

Certifique-se de estar enviando a mensagem para um número de telefone válido.

1004

Conflito com a criação de arquivo

Houve um erro ao tentar enviar ou processar sua multimídia. Tente novamente.

1005

Acesso negado

Verifique as permissões de acesso da sua integração técnica.

1006

O arquivo ou recurso não foi encontrado

O arquivo multimídia expirou ou o ID fornecido está incorreto. Envie-o novamente.

1007

O destinatário não está na lista de autorizados

Se seu app estiver em modo de desenvolvimento, você deve adicionar este número à sua lista de testes no Meta.

1008

Um parâmetro necessário não foi encontrado

Preencha todos os campos obrigatórios na mensagem ou modelo que está enviando.

1009

Valor de parâmetro inválido

O tipo de dado que está enviando não está correto (ex. enviou texto em vez de número).

1010

A mensagem contém um parâmetro não necessário

Está enviando mais informações do que a API do modelo solicitou.

1011

O serviço não está