Load the app in the App Dashboard and view the Application Rate Limit section to verify that the app has reached its rate limit. If it has, try again later or reduce the frequency or amount of API queries the app is making.

Carregue o aplicativo no Painel de Aplicativos e visualize a seção Limite de Taxa de Aplicativo para verificar se o aplicativo atingiu seu limite de taxa. Em caso afirmativo, tente novamente mais tarde ou reduza a frequência ou a quantidade de consultas de API que o aplicativo está fazendo.

Use the access token debugger to verify that your app has been granted the permissions required by the endpoint. See Troubleshooting.

Use o depurador de token de acesso para verificar se seu aplicativo recebeu as permissões exigidas pelo endpoint. Consulte Solução de problemas.

Use the access token debugger to verify that your app has been granted the permissions required by the endpoint. See Troubleshooting.
Ensure that the phone number used to set the business public key is allowlisted.

Use o depurador de token de acesso para verificar se seu aplicativo recebeu as permissões exigidas pelo endpoint. Consulte Solução de problemas.
Certifique-se de que o número de telefone usado para definir a chave pública comercial esteja na lista de permissões.

Typically this means the included access token has expired, been invalidated, or the app user has changed a setting to prevent all apps from accessing their data. We recommend that you get a new access token.

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 acessem seus dados. Recomendamos que você obtenha um novo token de acesso.

Use the access token debugger to verify that your app has been granted the permissions required by the endpoint. See Troubleshooting.

Use o depurador de token de acesso para verificar se seu aplicativo recebeu as permissões exigidas pelo endpoint. Consulte Solução de problemas.

The app has reached the API's throughput limit. See Throughput. Try again later or reduce the frequency with which the app sends messages.

O aplicativo atingiu o limite de taxa de transferência da API. Consulte Taxa de transferência. Tente novamente mais tarde ou reduza a frequência com que o aplicativo envia mensagens.

See WhatsApp Business Account Rate Limits. Try again later or reduce the frequency or amount of API queries the app is making.

Consulte Limites de taxas da conta comercial do WhatsApp. Tente novamente mais tarde ou reduza a frequência ou a quantidade de consultas de API que o aplicativo está fazendo.

See the endpoint's reference to determine which values are supported for each parameter, and see Phone Numbers to learn how to add a phone number to a WhatsApp Business Account.

Consulte a referência do endpoint para determinar quais valores são suportados para cada parâmetro e consulte Números de telefone para saber como adicionar um número de telefone a uma conta do WhatsApp Business.

A conta do WhatsApp Business associada ao aplicativo foi restringida ou desativada por violar uma política da plataforma ou não foi possível verificar os dados incluídos na solicitação com relação aos dados definidos na conta do WhatsApp Business (por exemplo, o PIN de duas etapas incluído na solicitação). está incorreto).

See the Policy Enforcement document to learn about policy violations and how to resolve them.
You can also use the Health Status API, which may provide additional insight into the reason or reasons for the account lock.

Consulte o documento Aplicação de políticas para saber mais sobre violações de políticas e como resolvê-las.
Você também pode usar a API Health Status, que pode fornecer informações adicionais sobre o motivo ou motivos do bloqueio da conta.

Falha no registro ou cancelamento de registro porque houve muitas tentativas para esse número de telefone em um curto período de tempo

The business phone number is being blocked because it has reached its registration/deregistration attempt limit. Try again once the number is unblocked. See "Limitations" in the Registration document.

O número de telefone comercial está sendo bloqueado porque atingiu o limite de tentativas de registro/cancelamento de registro. Tente novamente quando o número for desbloqueado. Consulte “Limitações” no documento de registro.

Muitas mensagens enviadas do número de telefone do remetente para o mesmo número de telefone do destinatário em um curto período de tempo.

Wait and retry the operation, if you intend to send messages to the same phone number. You can still send messages to a different phone number without waiting

Aguarde e tente novamente a operação, caso pretenda enviar mensagens para o mesmo número de telefone. Você ainda pode enviar mensagens para um número de telefone diferente sem esperar

A mensagem não foi enviada porque há restrições sobre quantas mensagens podem ser enviadas deste número de telefone. Isso pode ocorrer porque muitas mensagens anteriores foram bloqueadas ou sinalizadas como spam.

Check your quality status in the WhatsApp Manager and see the Quality-Based Rate Limits documentation for more information.

Verifique seu status de qualidade no Gerenciador do WhatsApp e consulte a documentação Limites de taxa com base na qualidade para obter mais informações.

See the endpoint's reference to determine which parameters are supported and how they are spelled.
Ensure when setting the business public key, it is a valid 2048-bit RSA public key in PEM format.

Ensure there is no mismatch between the phone number id you are registering and a previously stored phone number id.

Ensure your parameter is under any length restriction for the type.

Consulte a referência do endpoint para determinar quais parâmetros são suportados e como eles são escritos.
Ao definir a chave pública comercial, certifique-se de que ela seja uma chave pública RSA válida de 2.048 bits no formato PEM.

Certifique-se de que não haja incompatibilidade entre o ID do número de telefone que você está registrando e um ID de número de telefone armazenado anteriormente.

Certifique-se de que seu parâmetro esteja sob qualquer restrição de comprimento para o tipo.

See About Billing For Your WhatsApp Business Account and verify that you have set up billing correctly.

Common problems:


Payment account is not attached to a WhatsApp Business Account
Credit line is over the limit
Credit line (Payment Account) not set or active
WhatsApp Business Account is deleted
WhatsApp Business Account is suspended
Timezone not set
Currency not set
MessagingFor request (On Behalf Of) is pending or declined
Exceeded conversation free tier threshold without a valid payment method

Consulte Sobre o faturamento da sua conta do WhatsApp Business e verifique se você configurou o faturamento corretamente.

Problemas comuns:


A conta de pagamento não está vinculada a uma conta comercial do WhatsApp
A linha de crédito ultrapassou o limite
Linha de crédito (conta de pagamento) não definida ou ativa
A conta comercial do WhatsApp foi excluída
Conta comercial do WhatsApp está suspensa
Fuso horário não definido
Moeda não definida
A solicitação MessagingFor (em nome de) está pendente ou recusada
Limite do nível gratuito de conversação excedido sem uma forma de pagamento válida

Check the WhatsApp Business Platform Status page to see API status information before trying again.

Verifique a página de status da plataforma WhatsApp Business para ver as informações de status da API antes de tentar novamente.

A conta comercial do WhatsApp associada ao aplicativo foi restrita ou desativada por violar uma política da plataforma.

Consulte o documento Aplicação de políticas para saber mais sobre violações de políticas e como resolvê-las.

A mensagem não foi enviada porque há restrições sobre quantas mensagens podem ser enviadas deste número de telefone. Isso pode ocorrer porque muitas mensagens anteriores foram bloqueadas ou sinalizadas como spam.

Check your quality status in the WhatsApp Manager and see the Quality-Based Rate Limits documentation for more information.

Verifique seu status de qualidade no Gerenciador do WhatsApp e consulte a documentação Limites de taxa com base na qualidade para obter mais informações.

Check the WhatsApp Business Platform Status page to see API status information. If there are no server outages, check the endpoint reference and verify that your request is formatted correctly and meets all endpoint requirements.

Verifique a página Status da plataforma WhatsApp Business para ver informações de status da API. Se não houver interrupções no servidor, verifique a referência do endpoint e verifique se sua solicitação está formatada corretamente e atende a todos os requisitos do endpoint.

Use the access token debugger to verify that your app has been granted the permissions required by the endpoint. See Troubleshooting.

Use o depurador de token de acesso para verificar se seu aplicativo recebeu as permissões exigidas pelo endpoint. Consulte Solução de problemas.

A mensagem não foi enviada devido a um erro desconhecido.
Ao definir uma chave pública comercial, houve falha ao calcular a assinatura, chamar o endpoint GraphQL ou o endpoint GraphQL retornou um erro.

Check the WhatsApp Business Platform Status page to see API status information before trying again.

Verifique a página de status da plataforma WhatsApp Business para ver as informações de status da API antes de tentar novamente.

Não foi possível entregar a mensagem. Os motivos podem incluir:


O número de telefone do destinatário não é um número de telefone do WhatsApp.
Envio de um modelo de autenticação para um usuário do WhatsApp que possui o código de chamada do país +91 (Índia). Atualmente, os modelos de autenticação não podem ser enviados para usuários do WhatsApp na Índia.
O destinatário não aceitou nossos novos Termos de Serviço e Política de Privacidade.
Destinatário utilizando versão antiga do WhatsApp; deve usar a seguinte versão do WhatsApp ou superior:


Andróide: 2.21.15.15
SMBA: 2.21.15.15
iOS: 2.21.170.4
SMBI: 2.21.170.4
KaiOS: 2.2130.10
Rede: 2.2132.6

A mensagem não foi entregue para criar uma experiência de usuário de alta qualidade. Consulte Limites de mensagens do modelo de marketing por usuário.

Using a non-WhatsApp communication method, ask the WhatsApp user to:


Confirm that they can actually send a message to your WhatsApp business phone number.
Confirm that they have accepted our latest Terms of Service (Settings > Help, or Settings > Application information will prompt them to accept the latest terms/policies if they haven't done so already)
Update to the latest version of the WhatsApp client.

Usando um método de comunicação que não seja o WhatsApp, peça ao usuário do WhatsApp para:


Confirme se eles podem realmente enviar uma mensagem para o seu número de telefone comercial do WhatsApp.
Confirme se eles aceitaram nossos Termos de Serviço mais recentes (Configurações > Ajuda ou Configurações > Informações do aplicativo solicitarão que eles aceitem os termos/políticas mais recentes, caso ainda não o tenham feito)
Atualize para a versão mais recente do cliente WhatsApp.

Check the WhatsApp Manager to verify that your template has been translated. See Quality Rating and Template Status.

Verifique o Gerenciador do WhatsApp para verificar se seu modelo foi traduzido. Consulte Classificação de qualidade e status do modelo.

Mais de 24 horas se passaram desde a última resposta do destinatário ao número do remetente.

The WhatsApp Business Account is in maintenance mode. One reason for this could be that the account is undergoing a throughput upgrade.

A conta WhatsApp Business está em modo de manutenção. Um motivo para isso pode ser que a conta esteja passando por uma atualização de rendimento.

See Messages for supported message types before trying again with a supported message type.

Consulte Mensagens para conhecer os tipos de mensagens compatíveis antes de tentar novamente com um tipo de mensagem compatível.

We were unable to download the media for one or more reasons, such as an unsupported media type. Refer to the error.error_data.details value for more information about why we were unable to download the media.
Ask the WhatsApp user to send you the media file using a non-WhatsApp method.

Não foi possível baixar a mídia por um ou mais motivos, como um tipo de mídia incompatível. Consulte o valor error.error_data.details para obter mais informações sobre por que não foi possível fazer download da mídia.
Peça ao usuário do WhatsApp para enviar o arquivo de mídia usando um método que não seja do WhatsApp.

O modelo foi pausado muitas vezes devido à baixa qualidade e agora está permanentemente desativado.

O número de valores de parâmetros variáveis incluídos na solicitação não corresponde ao número de parâmetros variáveis definidos no modelo.

See Message Template Guidelines and make sure the request includes all of the variable parameter values that have been defined in the template.

Consulte Diretrizes para modelos de mensagens e certifique-se de que a solicitação inclua todos os valores de parâmetros variáveis que foram definidos no modelo.

The variable parameter values included in the request are not using the format specified in the template. See Message Template Guidelines.

Os valores dos parâmetros variáveis incluídos na solicitação não usam o formato especificado no modelo. Consulte Diretrizes para modelos de mensagens.

Make sure your template has been approved and the template name and language locale are correct. Please ensure you follow message template guidelines.

Certifique-se de que seu modelo tenha sido aprovado e que o nome do modelo e a localidade do idioma estejam corretos. Certifique-se de seguir as diretrizes do modelo de mensagem.

We were unable to upload the media for one or more reasons, such as an unsupported media type. Refer to the error.error_data.details value for more information about why we were unable to upload the media.
We recommend that you inspect any media files that are causing errors and confirm that they are in fact supported.
For example, in UNIX you can use file inspection via the command line to determine its MIME type:
file -I rejected-file.mov
You can then confirm if its MIME type is listed in our list of supported media types.
For more reliable performance when sending media, refer to Media HTTP Caching and uploading the media.

Não foi possível fazer upload da mídia por um ou mais motivos, como um tipo de mídia incompatível. Consulte o valor error.error_data.details para obter mais informações sobre por que não foi possível fazer upload da mídia.
Recomendamos que você inspecione todos os arquivos de mídia que estejam causando erros e confirme se eles são de fato suportados.
Por exemplo, no UNIX você pode usar a inspeção de arquivos através da linha de comando para determinar seu tipo MIME:
arquivo -eu rejeitei-arquivo.mov
Você pode então confirmar se o tipo MIME está listado em nossa lista de tipos de mídia suportados.
Para obter um desempenho mais confiável ao enviar mídia, consulte Cache HTTP de mídia e upload de mídia.

O fluxo está em estado limitado e 10 mensagens usando esse fluxo já foram enviadas na última hora.

O modelo está pausado devido à baixa qualidade, por isso não pode ser enviado em uma mensagem modelo.

Please wait a few minutes before attempting to register this phone number

Aguarde alguns minutos antes de tentar registrar este número de telefone

O número de telefone que você está tentando registrar foi excluído recentemente e a exclusão ainda não foi concluída.

A mensagem não foi enviada devido a um erro desconhecido nos parâmetros da sua solicitação.

See the endpoint's reference to determine if you are querying the endpoint using the correct syntax. Contact customer support if you continue receiving this error code in response.

Consulte a referência do endpoint para determinar se você está consultando o endpoint usando a sintaxe correta. Entre em contato com o suporte ao cliente se continuar recebendo este código de erro em resposta.

Check the WhatsApp Business Platform Status page to see API status information and check the response details value before trying again.

Verifique a página Status da plataforma WhatsApp Business para ver as informações de status da API e verifique o valor dos detalhes da resposta antes de tentar novamente.

Falha na mensagem devido a um erro relacionado a método de pagamento vinculado a conta Whatsapp do número.

Falha no disparo da mensagem pois ela ficou pendente de envio por um periodo maior que 1 dia. O re-envio da mensagem deve ser feito.

Falha no envio ou recebimento da mensagem devido a um limite atingido dentro de uma janela de tempo.

Falha na mensagem devido a um erro relacionado ao certificado vinculado a conta do Whatsapp.

Erro ocorre porque um novo certificado foi submetido na conta do Whatsapp, sob outra identidade, e ainda não passou pelo processo de aprovação.

A mensagem não pode ser entregue devido a janela de 24 hrs de conversação ter sido encerrada. Somente templates podem ser enviados nesse intervalo.

A mensagem não foi entregue devido ao número ter recebido restrição em quantas mensagens podem ser enviadas para o Usuário, com bate em mensagens anteriores terem sido bloqueadas ou marcadas como spam.

Falha no envio de mensagens para o usuário do número pois ele pode ter tido o seu número alterado.

Falha no envio da mensagem com um documento que possui legenda. Não esta suportado atualmente.

Falha no envio da mensagem pois o identificador único da mídia enviada já existe na base do número e houve conflito ao realizar o upload.

Acesso negado a integração, podendo ser vários motivos como: envio de mídia inválido, credenciais inválidas, erro de certificado, app expirado ou número já registrado no Whatsapp.

Verifique todos os dados de parâmetros necessários para o envio da mensagem, incluindo dados de título e sessão em disparo de listas.

If you’re trying to send a List Message, check if each row’s ID is unique.
If you’re trying to send a Single Product Message, it’s possible that you have sent the wrong catalog_id. Please go back to the Commerce Manager and check it again.
If you’re trying to send a Multi-Product Message, check that your product_retailer_id is unique per section. Also make sure the header and body objects are present and have an assigned value.

Verifique o tipo de valor que pode ser enviado na mensagem, ou validar os IDs dos itens da sua mensagem interativa ou lista de produtos.

Falha no envio da mensagem pois ou mais parâmetros adicionais não necessários foram enviados.

Verifique a quantidade de parâmetros adicionados na mensagem e tente enviar a mensagem novamente.

Erro originado por upload de mídia incorreta, endpoint não econtrado ou dado do último contato não bate com o disparo atual.

Erro recebido devido a uma sobrecarga no sistema pelo lado da integração e permitir a mesma ter um tempo de se recuperar.

Retrying the request should resolve this error. If this does not resolve the error, contact support.

A mensagem não pode ser entregue. Verificar a documentação da Meta sobre o motivo ou entrar em contato com o BSP.

A user_identity_changed system notification requires acknowledgement

A mensagem não pode ser entregue devido ao destinatário potencialmente ter alterado sua identidade no Whatsapp.

A mensagem não pode ser entregue a uma violação de politica de integridade na conta do número, e disparos foram bloqueados.

O número de parâmetros enviados não bate com a quantidade de parâmetros esperada para o envio da mensagem

Falha no disparo do Template, pois ele se encontra inativo, não está cadastrado ou não foi encontrado no idioma especificado.

Template enviado para o destinatário, mas o mesmo não conseguiu baixar os dados do template para visualiza-lo.

O conteudo da mensagem no Template enviado, ao ser traduzido, excedeu o limite de caracteres permitido na mensagem.

Política de formatação de texto e/ou caracteres no Template excedido

O template possui uma quantidade excedente de caracteres ou texto em uma formataçao não permitida.