1663832908583941.png)
Built with DocStarSe houver um problema na mensagem do WhatsApp que você enviou, códigos de erro serão exibidos para indicar o problema. Você pode encontrar uma lista de todos os códigos de erro junto com seus significados/descrições aqui, o que ajudará você a corrigi-los.
Você pode verificar os erros das mensagens do WhatsApp falhadas na seção de logs e logs falhados da seção do WhatsApp.
Códigos de erro do Meta
Se o seu fornecedor de WhatsApp for o Meta, verifique os códigos de erro aqui -
https://developers.facebook.com/docs/whatsapp/on-premises/errors
Erros de autorização
Código | Detalhes | Possíveis razões e soluções | Código de Status HTTP |
|---|---|---|---|
AuthException | Não conseguimos autenticar o usuário do aplicativo. | Normalmente isso significa que o token de acesso incluído expirou, foi invalidado ou o usuário do aplicativo alterou uma configuração para impedir que todos os aplicativos acessassem seus dados. Recomendamos que você obter um novo token de acesso. |
Não autorizado |
Método API | Problema de capacidade ou permissões. | Use o debugador de token de acesso para verificar se o seu aplicativo possui as permissões necessárias concedidas pelo endpoint. Veja Erros de Autenticação e Autorização. |
Erro interno do servidor |
Permissão negada | A permissão não está concedida ou foi removida. | Use o debugador de token de acesso para verificar se o seu aplicativo possui as permissões necessárias concedidas pelo endpoint. |
Proibido |
O token de acesso expirou | Seu token de acesso expirou. | Obtenha um novo token de acesso. |
Não autorizado |
Permissão da API | A permissão não está concedida ou foi removida. | Use o debugador de token de acesso para verificar se o seu aplicativo tem as permissões necessárias concedidas pelo endpoint. Veja Erros de Autenticação e Autorização. |
Proibido |
Erros de integridade
Código | Detalhes | Possíveis razões e soluções | Código de Status HTTP |
|---|---|---|---|
Bloqueado temporariamente por violações de políticas | A Conta Comercial do WhatsApp associada ao aplicativo foi restringida ou desativada por violar uma política da plataforma. | Veja o documento de Aplicação de Políticas para aprender sobre violações de políticas e como resolvê-las. |
Proibido |
A conta comercial está restrita de enviar mensagens para usuários neste país. | A Conta Comercial do WhatsApp está restrita de enviar mensagens para usuários em certos países. | Veja Política de Mensagens Comerciais do WhatsApp para detalhes sobre os países permitidos para envio de mensagens na sua categoria de negócio. |
Proibido |
A conta foi bloqueada | A Conta Comercial do WhatsApp associada ao aplicativo foi restringida ou desativada por violar uma política da plataforma ou não conseguimos verificar os dados incluídos na solicitação em relação aos dados cadastrados na Conta Comercial do WhatsApp (por exemplo, o PIN de verificação em duas etapas incluído na solicitação está incorreto). | Veja o documento de Aplicação de Políticas para aprender sobre violações de políticas e como resolvê-las. |
Proibido |
Erros de criação de template
Erro | Descrição | Solução Possível |
|---|---|---|
| Um campo em seu template excedeu o limite máximo de caracteres permitido. | Consulte a mensagem de erro para detalhes específicos sobre o campo afetado e seus limites de caracteres correspondentes. |
| O cabeçalho da sua mensagem contém formatação inválida. | Consulte a mensagem de erro para detalhes específicos sobre a formatação válida. |
| O corpo da sua mensagem contém formatação inválida. | Consulte a mensagem de erro para detalhes específicos sobre a formatação válida. |
| O rodapé da sua mensagem contém formatação inválida. | Consulte a mensagem de erro para detalhes específicos sobre a formatação válida. |
| Este template tem muitas variáveis para seu comprimento. Reduza o número de variáveis ou aumente o comprimento da mensagem. | Consulte a mensagem de erro para detalhes específicos sobre a formatação válida. |
| Variáveis não podem estar no início ou no final do template. | Consulte a mensagem de erro para detalhes específicos sobre a formatação válida. |
Erros de envio de template
Erro | Descrição | Solução Possível |
|---|---|---|
| Você excedeu o número máximo de templates de mensagens que pode ter para esta conta comercial do WhatsApp. | Uma Conta Comercial do WhatsApp pode ter até 250 templates de mensagens. Veja Limites de Templates. |
Erros de migração de telefone
Erro | Descrição | Solução Possível |
|---|---|---|
| O número de telefone que você está tentando migrar já está presente na sua conta do WhatsApp. | Tente novamente com um número de telefone que não esteja presente na sua conta do WhatsApp. |
| APIs de verificação de propriedade de telefone não estão disponíveis para este caso de uso. | |
| Webhooks não foram configurados para a conta comercial do Whats |