Códigos de erro da API do WhatsApp.
Recebeu um erro da Meta e não sabe o que fazer? Pesquise pelo número e veja o que a API está dizendo e como resolver. São 94 códigos da WhatsApp Business Platform, direto da documentação oficial.
Busque o seu código de erro.
Digite o número do erro, ou uma palavra como token, janela ou limite.
Fonte: documentação oficial de códigos de erro da Meta43 códigos encontrados
1Pedido inválido ou possível erro do servidor.Envio de mensagem
O que a API retorna
Pedido inválido ou possível erro do servidor.
Possíveis motivos e como resolver
Consulte a página Status da API do WhatsApp Business para ver as informações de status da API. Se não houver interrupções no servidor, consulte a referência do ponto de extremidade para verificar se o pedido está formatado corretamente e cumpre todos os requisitos necessários.
2Há um erro temporário por inatividade ou sobrecarga.Envio de mensagem
O que a API retorna
Há um erro temporário por inatividade ou sobrecarga.
Possíveis motivos e como resolver
Antes de tentar de novo, consulte a página Status da API do WhatsApp Business para ver as informações de status da API.
33O número de telefone comercial foi excluído.Envio de mensagem
O que a API retorna
O número de telefone comercial foi excluído.
Possíveis motivos e como resolver
Verifique se o número de telefone comercial está correto.
100O pedido incluía um ou mais parâmetros incompatíveis ou escritos de forma errada.Envio de mensagem
O que a API retorna
O pedido incluía um ou mais parâmetros incompatíveis ou escritos de forma errada.
Possíveis motivos e como resolver
Consulte a referência do ponto de extremidade para determinar quais parâmetros são compatíveis e como são escritos. Para o WhatsApp Flows com ponto de extremidade: ao configurar a chave pública da empresa, verifique se ela é uma chave RSA pública e válida de 2.048 bits no formato PEM. Verifique se não há incompatibilidade entre o ID do número de telefone que você está registrando e outro armazenado anteriormente. Verifique se o parâmetro está dentro de qualquer restrição de tamanho para o tipo.
130403Não é possível entregar a mensagem. A empresa bloqueou o usuário final no WhatsApp.Envio de mensagem
O que a API retorna
Não é possível entregar a mensagem. A empresa bloqueou o usuário final no WhatsApp.
Possíveis motivos e como resolver
Não tente novamente. Desbloqueie o usuário do WhatsApp para voltar a enviar mensagens para ele. Consulte Desbloquear um usuário.
130472A mensagem não foi enviada como parte de um experimento.Envio de mensagem
O que a API retorna
A mensagem não foi enviada como parte de um experimento.
Possíveis motivos e como resolver
Consulte Experimento de mensagem de marketing.
131000Falha ao enviar a mensagem devido a um erro desconhecido.Envio de mensagem
O que a API retorna
Falha ao enviar a mensagem devido a um erro desconhecido.
Possíveis motivos e como resolver
Tente novamente. Se o erro persistir, abra um tíquete de Suporte Direto. Para o WhatsApp Flows com ponto de extremidade: durante a definição da chave pública da empresa, ocorreu uma falha ao calcular a assinatura, fazer uma chamada ao ponto de extremidade do GraphQL ou o ponto de extremidade do GraphQL retornou um erro.
131005A permissão não foi concedida ou foi removida.Envio de mensagem
O que a API retorna
A permissão não foi concedida ou foi removida.
Possíveis motivos e como resolver
Use o depurador de token de acesso para verificar se as permissões necessárias foram concedidas ao seu app pelo ponto de extremidade. Consulte Erros de autenticação e autorização.
131008Falta um parâmetro obrigatório no pedido.Envio de mensagem
O que a API retorna
Falta um parâmetro obrigatório no pedido.
Possíveis motivos e como resolver
Consulte a referência do ponto de extremidade para determinar quais parâmetros são necessários.
131009Um ou mais valores de parâmetros são inválidos.Envio de mensagem
O que a API retorna
Um ou mais valores de parâmetros são inválidos.
Possíveis motivos e como resolver
Consulte a referência do ponto de extremidade para determinar quais valores são compatíveis com cada parâmetro. Veja a documentação Números de telefone para saber como adicionar um número a uma conta do WhatsApp Business.
131016Um serviço está temporariamente indisponível.Envio de mensagem
O que a API retorna
Um serviço está temporariamente indisponível.
Possíveis motivos e como resolver
Antes de tentar de novo, consulte a página Status da API do WhatsApp Business para ver as informações de status da API.
131021O número de telefone do destinatário e do remetente é o mesmo.Envio de mensagem
O que a API retorna
O número de telefone do destinatário e do remetente é o mesmo.
Possíveis motivos e como resolver
Envie uma mensagem para um número de telefone diferente daquele do remetente.
131026Não foi possível entregar a mensagem. Os motivos podem ser os seguintes: O número de telefone do destinatário não está registrado no WhatsApp. O destinatário não aceitou os novos Termos de Serviço e a nova Política de Privacidade. O destinatário está usando uma versão antiga do WhatsApp. É preciso usar as seguintes versões do WhatsApp (ou posteriores): Android: 2.21.15.15 SMBA: 2.21.15.15 iOS: 2.21.170.4 SMBI: 2.21.170.4 KaiOS: 2.2130.10 Web: 2.2132.6Envio de mensagem
O que a API retorna
Não foi possível entregar a mensagem. Os motivos podem ser os seguintes: O número de telefone do destinatário não está registrado no WhatsApp. O destinatário não aceitou os novos Termos de Serviço e a nova Política de Privacidade. O destinatário está usando uma versão antiga do WhatsApp. É preciso usar as seguintes versões do WhatsApp (ou posteriores): Android: 2.21.15.15 SMBA: 2.21.15.15 iOS: 2.21.170.4 SMBI: 2.21.170.4 KaiOS: 2.2130.10 Web: 2.2132.6
Possíveis motivos e como resolver
Usando um método de comunicação diferente do WhatsApp, peça ao usuário do WhatsApp para fazer o seguinte: Confirmar se é possível enviar uma mensagem para seu número de telefone do WhatsApp Business. Confirmar se nossos Termos de Serviço mais recentes foram aceitos (caso contrário, será necessário acessar Configurações > Ajuda, ou Configurações > Informações sobre o app, para aceitá-los)Atualizar para a versão mais recente do cliente do WhatsApp.
131037O número de telefone comercial 555 usado para enviar a solicitação não tem um nome de exibição aprovado.Envio de mensagem
O que a API retorna
O número de telefone comercial 555 usado para enviar a solicitação não tem um nome de exibição aprovado.
Possíveis motivos e como resolver
Altere o nome de exibição do número de telefone comercial 555. Consulte também o artigo da Central de Ajuda Como alterar o nome de exibição no WhatsApp Business.
131042Ocorreu um erro relacionado à forma de pagamento.Envio de mensagem
O que a API retorna
Ocorreu um erro relacionado à forma de pagamento.
Possíveis motivos e como resolver
Consulte Sobre a cobrança da sua conta do WhatsApp Business e verifique se a cobrança foi configurada corretamente. Problemas comuns: A conta de pagamento não está associada a uma conta do WhatsApp Business. A linha de crédito está acima do limiteA linha de crédito (conta de pagamento) não foi definida nem ativadaA conta do WhatsApp Business foi excluídaA conta do WhatsApp Business está suspensaFuso horário não definidoMoeda não definidaO pedido MessagingFor (Em nome de) está pendente ou foi recusado
131045Ocorreu uma falha ao enviar a mensagem devido a um erro de registro do número de telefone.Envio de mensagem
O que a API retorna
Ocorreu uma falha ao enviar a mensagem devido a um erro de registro do número de telefone.
Possíveis motivos e como resolver
Registre o número de telefone e tente novamente.
131047Mais de 24 horas se passaram desde que o destinatário respondeu pela última vez ao número do remetente.Envio de mensagem
O que a API retorna
Mais de 24 horas se passaram desde que o destinatário respondeu pela última vez ao número do remetente.
Possíveis motivos e como resolver
Envie um modelo de mensagem ao destinatário.
131049Essa mensagem não foi entregue para manter o engajamento saudável do ecossistema.Envio de mensagem
O que a API retorna
Essa mensagem não foi entregue para manter o engajamento saudável do ecossistema.
Possíveis motivos e como resolver
Se você receber esse código de erro e suspeitar que seja devido ao limite, espere pelo menos 24 horas antes de reenviar a mensagem de modelo. Fazer isso só resultará em outra resposta de erro, já que o limite pode estar em vigor em diferentes períodos. Consulte Limites de mensagem de modelo de marketing por usuário para mais informações.
131050Não é possível entregar a mensagem. O destinatário interrompeu o recebimento de mensagens de marketing da sua empresa no WhatsApp.Envio de mensagem
O que a API retorna
Não é possível entregar a mensagem. O destinatário interrompeu o recebimento de mensagens de marketing da sua empresa no WhatsApp.
Possíveis motivos e como resolver
Não tente enviar mensagens novamente, já que elas não serão recebidas por este usuário. Para receber uma notificação sempre que um usuário do WhatsApp interromper ou retomar o recebimento de mensagens de modelo de marketing da sua empresa, assine o webhook user_preferences.
131051O tipo de mensagem não é compatível.Envio de mensagem
O que a API retorna
O tipo de mensagem não é compatível.
Possíveis motivos e como resolver
Consulte Mensagens para ver os tipos de mensagem compatíveis antes de tentar novamente.
131052Não foi possível baixar a mídia enviada pelo usuário.Envio de mensagem
O que a API retorna
Não foi possível baixar a mídia enviada pelo usuário.
Possíveis motivos e como resolver
Não foi possível baixar a mídia incluída na mensagem do usuário do WhatsApp. Para saber mais, consulte o valor error.error_data.details em webhooks de mensagens disparados quando esta mensagem foi recebida. Peça ao usuário do WhatsApp para enviar o arquivo de mídia usando um método que não seja o WhatsApp.
131053Não foi possível carregar a mídia usada na mensagem.Envio de mensagem
O que a API retorna
Não foi possível carregar a mídia usada na mensagem.
Possíveis motivos e como resolver
Não foi possível carregar a mídia por um ou mais motivos, como um tipo de mídia não compatível. Para saber mais, consulte o valor error.error_data.details em webhooks de mensagens disparados quando houver falha no envio desta mensagem. Inspecione os arquivos de mídia que estão causando erros e confirme se eles são realmente compatíveis. Por exemplo, no UNIX, é possível usar a inspeção de arquivos por meio da linha de comando para determinar o tipo MIME:file -I rejected-file.movVocê pode então confirmar se o seu tipo MIME é compatível. Consulte Tipos de mídia compatíveis.
131057A conta comercial está em modo de manutençãoEnvio de mensagem
O que a API retorna
A conta comercial está em modo de manutenção
Possíveis motivos e como resolver
A conta do WhatsApp Business está em modo de manutenção. Talvez a conta esteja passando por uma atualização da taxa de transferência de dados.
131063Seu modelo é categorizado como Marketing, mas os modelos de marketing estão desabilitados na sua configuração da API de Nuvem.Envio de mensagem
O que a API retorna
Seu modelo é categorizado como Marketing, mas os modelos de marketing estão desabilitados na sua configuração da API de Nuvem.
Possíveis motivos e como resolver
A empresa definiu disable_marketing_messages_on_cloud_api como true na conta do WhatsApp Business. Para enviar esse modelo, use a API de Mensagens de Marketing ou reabilite os modelos de marketing na API de Nuvem definindo disable_marketing_messages_on_cloud_api como false.
132000O número de valores de parâmetros variáveis incluídos no pedido não corresponde ao número de parâmetros variáveis definidos no modelo.Envio de mensagem
O que a API retorna
O número de valores de parâmetros variáveis incluídos no pedido não corresponde ao número de parâmetros variáveis definidos no modelo.
Possíveis motivos e como resolver
Consulte o documento Modelos para saber mais sobre parâmetros e garantir que o pedido inclua valores para todos os parâmetros exigidos pelo modelo.
132001O modelo não existe no idioma especificado ou não foi aprovado.Envio de mensagem
O que a API retorna
O modelo não existe no idioma especificado ou não foi aprovado.
Possíveis motivos e como resolver
Verifique se o modelo foi aprovado e se o nome e a localidade do idioma estão corretos. Consulte o documento Modelos para saber mais sobre modelos.
132005O texto traduzido é longo demais.Envio de mensagem
O que a API retorna
O texto traduzido é longo demais.
Possíveis motivos e como resolver
Consulte o Gerenciador do WhatsApp para verificar se o seu modelo foi traduzido. Consulte o documento Qualidade do modelo para saber como verificar o status do seu modelo.
132007O conteúdo do modelo viola uma política do WhatsApp.Envio de mensagem
O que a API retorna
O conteúdo do modelo viola uma política do WhatsApp.
Possíveis motivos e como resolver
Para saber mais sobre os possíveis motivos de violação, consulte o documento Análise do modelo.
132012Os valores de parâmetros variáveis foram formatados incorretamente.Envio de mensagem
O que a API retorna
Os valores de parâmetros variáveis foram formatados incorretamente.
Possíveis motivos e como resolver
Os valores de parâmetros variáveis incluídos no pedido não estão usando o formato especificado no modelo. Consulte o documento Modelos para saber mais sobre parâmetros e formatos de modelos.
132015O modelo foi pausado por baixa qualidade e não pode ser enviado em mensagens.Envio de mensagem
O que a API retorna
O modelo foi pausado por baixa qualidade e não pode ser enviado em mensagens.
Possíveis motivos e como resolver
Edite o modelo para melhorar a qualidade e tente novamente após a aprovação.
132016O modelo foi pausado muitas vezes por baixa qualidade e foi desabilitado de forma permanente.Envio de mensagem
O que a API retorna
O modelo foi pausado muitas vezes por baixa qualidade e foi desabilitado de forma permanente.
Possíveis motivos e como resolver
Crie um modelo novo com conteúdo diferente.
132068O flow está no estado bloqueado.Envio de mensagem
O que a API retorna
O flow está no estado bloqueado.
Possíveis motivos e como resolver
Corrija o flow
132069O flow está no estado limitado e 10 mensagens usando esse flow já foram enviadas na última hora.Envio de mensagem
O que a API retorna
O flow está no estado limitado e 10 mensagens usando esse flow já foram enviadas na última hora.
Possíveis motivos e como resolver
Corrija o flow
133000Uma tentativa anterior de cancelamento do registro falhou.Envio de mensagem
O que a API retorna
Uma tentativa anterior de cancelamento do registro falhou.
Possíveis motivos e como resolver
Exclua o registro do número novamente antes de registrá-lo.
133004O servidor está temporariamente indisponível.Envio de mensagem
O que a API retorna
O servidor está temporariamente indisponível.
Possíveis motivos e como resolver
Antes de tentar novamente, consulte a página Status da plataforma do WhatsApp Business para ver as informações de status da API e verifique o valor da resposta details.
133005O PIN de verificação em duas etapas está incorreto.Envio de mensagem
O que a API retorna
O PIN de verificação em duas etapas está incorreto.
Possíveis motivos e como resolver
Verifique se o PIN incluído no pedido está correto.t { "entityMap": [object Object], "blockMap": OrderedMap { "5b063": t { "key": "5b063", "type": "unstyled", "text": "Para redefinir o PIN, desative a verificação em duas etapas e defina um novo PIN.", "characterList": List [ t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null }, t { "style": OrderedSet {}, "entity": null } ], "depth": 0, "data": Map {} } }, "selectionBefore": t { "anchorKey": "5b063", "anchorOffset": 33, "focusKey": "5b063", "focusOffset": 44, "isBackward": false, "hasFocus": true }, "selectionAfter": t { "anchorKey": "5b063", "anchorOffset": 44, "focusKey": "5b063", "focusOffset": 44, "isBackward": false, "hasFocus": true } } Veja Verificação em duas etapas.
133006O número de telefone precisa ser verificado antes do registro.Envio de mensagem
O que a API retorna
O número de telefone precisa ser verificado antes do registro.
Possíveis motivos e como resolver
Verifique e registre o número de telefone.
133008Ocorreram muitas tentativas do PIN de verificação em duas etapas para este número de telefone.Envio de mensagem
O que a API retorna
Ocorreram muitas tentativas do PIN de verificação em duas etapas para este número de telefone.
Possíveis motivos e como resolver
Tente novamente após o período especificado no valor de resposta details.
133009O PIN de verificação em duas etapas foi inserido muito rapidamente.Envio de mensagem
O que a API retorna
O PIN de verificação em duas etapas foi inserido muito rapidamente.
Possíveis motivos e como resolver
Consulte o valor da resposta details antes de tentar novamente.
133010O número de telefone não está registrado na Plataforma do WhatsApp Business.Envio de mensagem
O que a API retorna
O número de telefone não está registrado na Plataforma do WhatsApp Business.
Possíveis motivos e como resolver
Registre o número de telefone e tente novamente.
133015O número de telefone que você está tentando registrar foi excluído recentemente e a exclusão ainda não foi concluída.Envio de mensagem
O que a API retorna
O número de telefone que você está tentando registrar foi excluído recentemente e a exclusão ainda não foi concluída.
Possíveis motivos e como resolver
Espere 5 minutos antes de tentar novamente.
134011Message failed to send because WhatsApp Payments terms of service acceptance is pending for this WhatsApp Business Account.Envio de mensagem
O que a API retorna
Message failed to send because WhatsApp Payments terms of service acceptance is pending for this WhatsApp Business Account.
Possíveis motivos e como resolver
Aceite os Termos de Serviço do Pagamentos no WhatsApp usando o link fornecido na mensagem de erro antes de tentar novamente.
135000Falha ao enviar a mensagem devido a um erro desconhecido com seus parâmetros de pedido.Envio de mensagem
O que a API retorna
Falha ao enviar a mensagem devido a um erro desconhecido com seus parâmetros de pedido.
Possíveis motivos e como resolver
Consulte a referência do ponto de extremidade para determinar se a consulta ao ponto de extremidade está sendo feita com a sintaxe correta. Entre em contato com o suporte ao cliente se continuar a receber esse erro na resposta.
4O app atingiu o limite da taxa de chamadas de API.Limitação (rate limit)
O que a API retorna
O app atingiu o limite da taxa de chamadas de API.
Possíveis motivos e como resolver
Carregue o app no Painel de Apps e veja a seção Limite de volume do app para conferir se o limite de volume foi atingido. Em caso afirmativo, tente novamente mais tarde ou reduza a frequência ou a quantidade de consultas da API que o app está fazendo.
80007The WhatsApp Business Account has reached its rate limit.Limitação (rate limit)
O que a API retorna
The WhatsApp Business Account has reached its rate limit.
Possíveis motivos e como resolver
Consulte os Limites de volume da conta do WhatsApp Business. Tente novamente mais tarde ou reduza a frequência ou a quantidade de consultas da API que o app está fazendo.
130429A taxa de transferência de dados de mensagens da API de Nuvem foi atingida.Limitação (rate limit)
O que a API retorna
A taxa de transferência de dados de mensagens da API de Nuvem foi atingida.
Possíveis motivos e como resolver
O app atingiu o limite da taxa de transferência da API. Consulte Taxa de transferência de dados. Tente novamente mais tarde ou reduza a frequência com que o app envia mensagens.
131048Falha ao enviar a mensagem devido a um limite de envios que podem ser feitos deste número de telefone. É possível que muitas mensagens anteriores tenham sido bloqueadas ou marcadas como spam.Limitação (rate limit)
O que a API retorna
Falha ao enviar a mensagem devido a um limite de envios que podem ser feitos deste número de telefone. É possível que muitas mensagens anteriores tenham sido bloqueadas ou marcadas como spam.
Possíveis motivos e como resolver
Verifique seu status de qualidade no Gerenciador do WhatsApp. Consulte Limites de modelo e Qualidade do modelo.
131056Foram enviadas muitas mensagens do número de telefone do remetente para o mesmo número de telefone do destinatário em um curto período.Limitação (rate limit)
O que a API retorna
Foram enviadas muitas mensagens do número de telefone do remetente para o mesmo número de telefone do destinatário em um curto período.
Possíveis motivos e como resolver
Aguarde e realize novamente a operação se quiser enviar mensagens para o mesmo número de telefone. Você ainda poderá enviar mensagens para um número diferente sem esperar.
133016Registration or Deregistration failed because there were too many attempts for this phone number in a short period of timeLimitação (rate limit)
O que a API retorna
Registration or Deregistration failed because there were too many attempts for this phone number in a short period of time
Possíveis motivos e como resolver
O número de telefone comercial está sendo bloqueado porque atingiu o limite de tentativas de registro/cancelamento do registro. Tente novamente assim que o número for desbloqueado. Consulte a seção "Limitações" no documento Registro.
131064Ocorreu uma falha ao enviar a mensagem porque esta conta atingiu o limite de mensagens devido a violações de classificação de modelo. Isso se aplica tanto a mensagens de modelo quanto a mensagens de envio direto.Limitação (rate limit)
O que a API retorna
Ocorreu uma falha ao enviar a mensagem porque esta conta atingiu o limite de mensagens devido a violações de classificação de modelo. Isso se aplica tanto a mensagens de modelo quanto a mensagens de envio direto.
Possíveis motivos e como resolver
Analise as classificações dos seus modelos e garanta que eles estejam categorizados de forma correta. Essa restrição será removida automaticamente após o período de aplicação. Veja Qualidade do modelo para saber mais.
0We were unable to authenticate the app user.Autorização
O que a API retorna
We were unable to authenticate the app user.
Possíveis motivos e como resolver
Geralmente, isso significa que o token de acesso incluído expirou, foi invalidado ou que o usuário do app alterou uma configuração para impedir que todos os apps acessem os dados dele. Obtenha um novo token de acesso.
3Indica um problema que envolve recursos ou permissões.Autorização
O que a API retorna
Indica um problema que envolve recursos ou permissões.
Possíveis motivos e como resolver
Use o depurador de token de acesso para verificar se as permissões necessárias foram concedidas ao seu app pelo ponto de extremidade. Consulte Erros de autenticação e autorização.
10A permissão não foi concedida ou foi removida.Autorização
O que a API retorna
A permissão não foi concedida ou foi removida.
Possíveis motivos e como resolver
Use o depurador de token de acesso para verificar se as permissões necessárias foram concedidas ao seu app pelo ponto de extremidade. Consulte Erros de autenticação e autorização. Para o WhatsApp Flows com ponto de extremidade: verifique se o número de telefone usado para definir a chave pública da empresa está na lista de permissões. Verifique os requisitos de qualificação da API que você está tentando acessar. Se você não tiver acesso aos pontos de extremidade, receberá esse código de erro.
190O token de acesso expirou.Autorização
O que a API retorna
O token de acesso expirou.
Possíveis motivos e como resolver
Obtenha um novo token de acesso.
200Não foi fornecido nenhum token de acesso. A API retornará a mensagem "Provide valid app ID". Esse erro ocorre em determinados pontos de extremidade GET (como whatsapp_business_profile) quando nenhum token é incluído. Outros pontos de extremidade podem retornar os códigos de erro 190 ou 104.Autorização
O que a API retorna
Não foi fornecido nenhum token de acesso. A API retornará a mensagem "Provide valid app ID". Esse erro ocorre em determinados pontos de extremidade GET (como whatsapp_business_profile) quando nenhum token é incluído. Outros pontos de extremidade podem retornar os códigos de erro 190 ou 104.
Possíveis motivos e como resolver
Verifique se a solicitação inclui um token de acesso válido. Isso é diferente do código de erro 190 (token expirado ou inválido). Consulte Tokens de acesso.
200-299A permissão não foi concedida ou foi removida.Autorização
O que a API retorna
A permissão não foi concedida ou foi removida.
Possíveis motivos e como resolver
Use o depurador de token de acesso para verificar se as permissões necessárias foram concedidas ao seu app pelo ponto de extremidade. Consulte Erros de autenticação e autorização.
368The WhatsApp Business Account associated with the app has been restricted or disabled for violating a platform policy.Integridade
O que a API retorna
The WhatsApp Business Account associated with the app has been restricted or disabled for violating a platform policy.
Possíveis motivos e como resolver
Consulte o documento Aplicação das políticas para saber mais sobre as violações das políticas e como solucioná-las.
130497The WhatsApp Business Account is restricted from messaging to users in certain countries.Integridade
O que a API retorna
The WhatsApp Business Account is restricted from messaging to users in certain countries.
Possíveis motivos e como resolver
Para ver quais são os países permitidos para o envio de mensagens na categoria da sua empresa, consulte a Política de Mensagens do WhatsApp Business.
131031The WhatsApp Business Account associated with the app has been restricted or disabled for violating a platform policy, or we were unable to verify data included in the request against data set on the WhatsApp Business Account (e.g, the two-step pin included in the request is incorrect).Integridade
O que a API retorna
The WhatsApp Business Account associated with the app has been restricted or disabled for violating a platform policy, or we were unable to verify data included in the request against data set on the WhatsApp Business Account (e.g, the two-step pin included in the request is incorrect).
Possíveis motivos e como resolver
Consulte o documento Aplicação das políticas para saber mais sobre as violações das políticas e como solucioná-las. Você também pode usar a API de Status de Integridade, que pode fornecer mais insights sobre os motivos para o bloqueio da conta.
2388039Não é possível alterar o status do modelo de mensagemCriação de modelo
O que a API retorna
O status desse modelo de mensagem não pode ser alterado. Só é possível excluir ou adicionar modelos.
Possíveis motivos e como resolver
Isso ocorre quando você tenta editar um modelo cujo status não pode ser alterado (por exemplo, um modelo que ainda está em análise). Espera que o modelo seja aprovado ou rejeitado antes de editar. Lembre-se de que há um limite diário de edições para os modelos.
2388040limite de caracteres excedidoCriação de modelo
O que a API retorna
Um campo do modelo excedeu o limite máximo de caracteres permitido.
Possíveis motivos e como resolver
Verifique a mensagem de erro para ver detalhes específicos sobre o campo afetado e os limites de caracteres correspondentes.
2388047o formato do cabeçalho da mensagem está incorretoCriação de modelo
O que a API retorna
O cabeçalho da mensagem contém formatação inválida.
Possíveis motivos e como resolver
Verifique a mensagem de erro para ver detalhes sobre a formatação válida.
2388072formato do corpo da mensagem incorretoCriação de modelo
O que a API retorna
O corpo da mensagem contém formatação inválida.
Possíveis motivos e como resolver
Verifique a mensagem de erro para ver detalhes sobre a formatação válida.
2388073o formato do rodapé da mensagem está incorretoCriação de modelo
O que a API retorna
O rodapé da mensagem contém formatação inválida.
Possíveis motivos e como resolver
Verifique a mensagem de erro para ver detalhes sobre a formatação válida.
2388293a proporção entre palavras e parâmetros excede o limiteCriação de modelo
O que a API retorna
Esse modelo contém muitas variáveis para sua extensão. Reduza o número de variáveis ou aumente a extensão da mensagem.
Possíveis motivos e como resolver
Verifique a mensagem de erro para ver detalhes sobre a formatação válida.
2388299parâmetros iniciais ou finais não permitidosCriação de modelo
O que a API retorna
As variáveis não podem estar no início ou no fim do modelo.
Possíveis motivos e como resolver
Verifique a mensagem de erro para ver detalhes sobre a formatação válida.
2388019Limite do modelo de mensagem excedidoEnvio de modelo
O que a API retorna
You have exceeded the maximum number of message templates you can have for this WhatsApp business account.
Possíveis motivos e como resolver
Uma conta do WhatsApp Business pode ter até 250 modelos de mensagens. Consulte Limites de modelos.
2388012o número já existe na sua lista de números de telefone.Migração de telefone
O que a API retorna
O número de telefone que você está tentando migrar já está presente na sua conta do WhatsApp.
Possíveis motivos e como resolver
Tente novamente com um número de telefone que ainda não esteja presente na sua conta do WhatsApp.
2388091, 2388093o número de telefone não está qualificado para receber/verificar um código de registro porque não está sendo migrado.Migração de telefone
O que a API retorna
As APIs de verificação de propriedade do telefone não estão disponíveis para esse caso de uso.
Possíveis motivos e como resolver
Registre e verifique o número.
2388103não é possível migrar o número de telefone.Migração de telefone
O que a API retorna
Os webhooks não foram configurados para a conta de destino do WhatsApp Business.
Possíveis motivos e como resolver
Assine webhooks para seu app na conta do WhatsApp Business de destino.
2388103adicione esse número de telefone à sua conta do WhatsAppMigração de telefone
O que a API retorna
Esse número de telefone pode ser adicionado diretamente e não requer o uso de APIs de migração de telefone.
Possíveis motivos e como resolver
Registre e verifique o número.
2388103o nome registrado deve estar presente e aprovado.Migração de telefone
O que a API retorna
O número de telefone comercial deve ter um nome de exibição aprovado (name_status é APPROVED) e não pode ter pedidos de alteração de nome de exibição pendentes.
Possíveis motivos e como resolver
O nome de exibição do seu número de telefone comercial precisa ser aprovado.
2388103a conta do WhatsApp em que o número de telefone está registrado não está configurada corretamente.Migração de telefone
O que a API retorna
A conta do WhatsApp Business de origem e a opção "enviar mensagem em nome de" devem ser aprovadas.
Possíveis motivos e como resolver
A conta do WhatsApp Business pode estar usando o modelo de propriedade "Em nome de", que agora está obsoleto. Entrar em contato com o suporte.
2388103sua conta do WhatsApp não tem uma conta de pagamento.Migração de telefone
O que a API retorna
Sua conta do WhatsApp deve ter uma linha de crédito ativa para que você possa enviar mensagens após a migração.
Possíveis motivos e como resolver
Configure uma linha de crédito e compartilhe-a com o cliente empresarial.
2388103ocorreu um erro ao migrar o número de telefone.Migração de telefone
O que a API retorna
Ocorreu um erro ao migrar seu número de telefone.
Possíveis motivos e como resolver
Tente novamente mais tarde. Se isso não funcionar, entre em contato com o suporte.
2388103esse número de telefone pertence a uma conta diferente do Gerenciador de Negócios.Migração de telefone
O que a API retorna
As contas do WhatsApp Business de origem e destino devem representar a mesma empresa.
Possíveis motivos e como resolver
Migre o número de telefone para uma conta do WhatsApp Business que envia mensagens para a mesma empresa que a conta do WhatsApp Business de origem.
2388103sua conta do WhatsApp precisa ser aprovadaMigração de telefone
O que a API retorna
Para que você possa migrar números de telefone, a conta do WhatsApp Business de destino precisa ser aprovada.
Possíveis motivos e como resolver
Confira se a verificação da empresa foi concluída e se o status de análise da conta do WhatsApp Business está aprovado.
2388103o pedido "Mensagens para" da sua conta do WhatsApp deve ser aprovadoMigração de telefone
O que a API retorna
O cliente precisa aprovar o pedido "Mensagens para" da conta do WhatsApp Business de destino.
Possíveis motivos e como resolver
Peça ao cliente para aceitar seu pedido de "Mensagens para" no Meta Business Suite.
2494100a conta está no modo de manutenção.Migração de telefone
O que a API retorna
O número de telefone comercial está em modo de manutenção.
Possíveis motivos e como resolver
Tente novamente dentro de alguns minutos.
200005insights sobre o modelo indisponíveisInsights de modelo
O que a API retorna
Os insights sobre o modelo ainda não estão disponíveis para esta conta do WhatsApp Business.
Possíveis motivos e como resolver
No momento, não é possível habilitar insights sobre o modelo para esta conta do WhatsApp Business.
200006não é possível desabilitar insights sobre o modeloInsights de modelo
O que a API retorna
Operação inválida. Depois de habilitados, os insights sobre o modelo não poderão ser desabilitados.
Possíveis motivos e como resolver
Depois de habilitados para uma conta do WhatsApp Business, os insights sobre o modelo não podem ser desabilitados.
200007insights sobre o modelo não habilitadosInsights de modelo
O que a API retorna
Template Insights have not been enabled for this WhatsApp Business Account
Possíveis motivos e como resolver
Para habilitar os insights sobre o modelo, consulte Como confirmar as análises de modelos.
2593079Esta WABA já foi marcada para migração para uma identificação de solução diferenteConta (WABA)
O que a API retorna
Esta WABA já foi marcada para migração para uma identificação de solução diferente
Possíveis motivos e como resolver
O modelo de propriedade da conta OBO está obsoleto. Entre em contato com o suporte para obter ajuda.
2593085Invalid WhatsApp Business Account for OBO MobilityA WABA não é qualificada para transferência de propriedade do tipo OBO. Os motivos possíveis são os seguintes: A WABA já pertence ao cliente comercial (ou seja, já usa o modelo de compartilhamento da WABA). O cliente comercial ainda não aceitou o pedido de OBO no Meta Business Suite.Conta (WABA)
O que a API retorna
A WABA não é qualificada para transferência de propriedade do tipo OBO. Os motivos possíveis são os seguintes: A WABA já pertence ao cliente comercial (ou seja, já usa o modelo de compartilhamento da WABA). O cliente comercial ainda não aceitou o pedido de OBO no Meta Business Suite.
Possíveis motivos e como resolver
Informamos que o modelo de propriedade da conta OBO está obsoleto. Entre em contato com o suporte para obter ajuda.
2593107You have exceeded the maximum number of times to call the synchronization api for this phone number.Sincronização
O que a API retorna
You have exceeded the maximum number of times to call the synchronization api for this phone number.
Possíveis motivos e como resolver
Só é possível chamar esse ponto de extremidade uma vez para sincronizar os contatos do número de telefone empresarial e uma vez para sincronizar o histórico de mensagens. Consulte Como integrar usuários do app de negócios. Desfaça a integração do cliente empresarial e depois refaça o processo de integração dele.
2593108O pedido de sincronização só pode ser feito em até 24 horas depois da integraçãoSincronização
O que a API retorna
O pedido de sincronização só pode ser feito em até 24 horas depois da integração
Possíveis motivos e como resolver
Só é possível iniciar a sincronização dos contatos e do histórico de mensagens de um usuário integrado do app WhatsApp Business dentro de 24 horas depois da integração do usuário. Consulte Como integrar usuários do app de negócios. Desfaça a integração do usuário e depois refaça o processo de integração dele.
100(#100) Invalid parameterAPI de Marketing
O que a API retorna
Message must be a template message.
Possíveis motivos e como resolver
Você está tentando enviar uma mensagem sem modelo. O tipo de mensagem deve ser template. Tente novamente usando um modelo de marketing.
Status HTTP: 400 Solicitação inválida
131009(#131009) Parameter value is not validAPI de Marketing
O que a API retorna
One or more parameter values are invalid.
Possíveis motivos e como resolver
Você pode estar usando um parâmetro inválido. Verifique se você está usando um parâmetro válido e tente novamente. A sincronização de anúncios pode estar incompleta. Aguarde dez minutos e tente novamente. Se o problema persistir, entre em contato com o suporte.
Status HTTP: 400 Solicitação inválida
131055(#131055) Method not allowedAPI de Marketing
O que a API retorna
Only marketing template messages are supported
Possíveis motivos e como resolver
É possível que você tenha tentado enviar uma mensagem sem modelo ou usando um modelo de autenticação ou utilidade. Experimente enviar novamente usando um modelo de mensagem de marketing.
Status HTTP: 400 Solicitação incorreta
134100(#134100) Only marketing messages supportedAPI de Marketing
O que a API retorna
You're only able to send marketing messages on this API.
Possíveis motivos e como resolver
Disponível na versão 23.0 da API Graph. Você está tentando enviar um modelo de utilidade ou autenticação. Somente modelos categorizados como MARKETING são compatíveis.
Status HTTP: 400 Solicitação inválida
134101(#134101) Your template is still syncingAPI de Marketing
O que a API retorna
When you send a message from a template, the template syncing process can take up to 10 minutes to complete. Wait a few minutes, and then try sending your message again.
Possíveis motivos e como resolver
Disponível na versão 23.0 da API Graph. Você está tentando enviar um modelo criado recentemente antes de concluir a sincronização de anúncios. A sincronização de anúncios pode levar até dez minutos. Aguarde dez minutos e tente novamente.
Status HTTP: 400 Solicitação inválida
134102(#134102) Template unavailable for useAPI de Marketing
O que a API retorna
Please check your eligibility status to ensure you are onboarded or contact Meta's customer support.
Possíveis motivos e como resolver
Disponível na versão 23.0 da API Graph. Não foi possível concluir a sincronização de anúncios para o modelo que você está tentando enviar ou sua conta pode não estar qualificada para a API de MM para WhatsApp. Verifique seu status de qualificação. Se o valor marketing_messages_lite_api_status da conta do WhatsApp Business for ONBOARDED e o problema persistir, entre em contato com o suporte.
Status HTTP: 500 - Erro de servidor interno
132018(#132018) Template validation errorAPI de Marketing
O que a API retorna
There's an issue with the parameters in your template.
Possíveis motivos e como resolver
Analise os erros, atualize os parâmetros conforme necessário e reenvie sua mensagem usando um modelo configurado corretamente.
Status HTTP: 400 Solicitação inválida
1752041(#1752041) Duplicate RequestAPI de Marketing
O que a API retorna
Duplicate Request is thrown when a client has already been invited to onboard by any partner.
Possíveis motivos e como resolver
Cada cliente empresarial pode ter apenas um pedido de integração. Somente o primeiro parceiro que chamar a API de intenção poderá enviar o pedido com sucesso. Quando um cliente é integrado, todas as contas do WhatsApp Business (WABA) qualificadas são incluídas no processo de forma automática. Se você receber um erro indicando que o pedido de integração já foi feito, não será necessária nenhuma ação adicional, pois todas as contas do WhatsApp Business qualificadas desse cliente serão integradas automaticamente.
Status HTTP: 400 Solicitação inválida
Conteúdo reproduzido da documentação da Meta, que pode ser alterada a qualquer momento. Consulte sempre a referência oficial de códigos de erro.
Por que a Meta bloqueia as suas mensagens?
Os erros de envio são os que mais aparecem no dia a dia de quem opera a API Oficial. Nesse vídeo do nosso canal, explicamos três dos mais comuns e o que fazer para evitá-los.
- 131049
- 131026
- 130472
Como ler a resposta de erro.
Toda falha da API devolve um objeto error com o código, uma descrição e um identificador de rastreamento.
{
"error": {
"message": "(#130429) Rate limit hit",
"type": "OAuthException",
"code": 130429,
"error_data": {
"messaging_product": "whatsapp",
"details": "Cloud API message throughput has been reached."
},
"error_subcode": 2494055,
"fbtrace_id": "Az8or2yhqkZfEZ-_4Qn_Bam"
}
}| Propriedade | Tipo | O que é |
|---|---|---|
code | Número inteiro | Código de erro. Desenvolva o tratamento de erros do app em torno de códigos de erro em vez de subcódigos ou códigos de status da resposta HTTP. |
details | String | Descrição do erro e do motivo mais provável. Também pode conter informações sobre como resolver o erro. Por exemplo, qual parâmetro é inválido ou quais valores são aceitáveis. |
error_subcode | Número inteiro | Obsoleto. Não será retornado em respostas da versão 16.0 ou posteriores. Subcódigo da Graph API. Nem todas as respostas incluirão um subcódigo. Por isso, desenvolva a própria lógica de tratamento de erros em relação às propriedades code e details. |
fbtrace_id | String | Identificação de rastreamento que você pode incluir ao entrar em contato com o Suporte Direto. A identificação pode ajudar a depurar o erro. |
message | String | Combinação do código de erro e do título. Por exemplo: (#130429) Rate limit hit. |
messaging_product | String | Produto de mensagens. Será sempre a string whatsapp para respostas da API de Nuvem. |
type | String | Tipo de erro. |
Trate os erros pelo campo code.
A própria Meta recomenda montar o tratamento de erros em cima do código, e não do error_subcode nem do status HTTP. O error_subcode está obsoleto e não é retornado nas versões 16.0 ou posteriores. Se precisar abrir chamado com o suporte da Meta, guarde o fbtrace_id: é ele que permite rastrear a requisição.
Os erros que mais aparecem.
O que significa o erro 131049 da API do WhatsApp?
Essa mensagem não foi entregue para manter o engajamento saudável do ecossistema. Se você receber esse código de erro e suspeitar que seja devido ao limite, espere pelo menos 24 horas antes de reenviar a mensagem de modelo. Fazer isso só resultará em outra resposta de erro, já que o limite pode estar em vigor em diferentes períodos. Consulte Limites de mensagem de modelo de marketing por usuário para mais informações.
O que significa o erro 131026 da API do WhatsApp?
Não foi possível entregar a mensagem. Os motivos podem ser os seguintes: O número de telefone do destinatário não está registrado no WhatsApp. O destinatário não aceitou os novos Termos de Serviço e a nova Política de Privacidade. O destinatário está usando uma versão antiga do WhatsApp. É preciso usar as seguintes versões do WhatsApp (ou posteriores): Android: 2.21.15.15 SMBA: 2.21.15.15 iOS: 2.21.170.4 SMBI: 2.21.170.4 KaiOS: 2.2130.10 Web: 2.2132.6 Usando um método de comunicação diferente do WhatsApp, peça ao usuário do WhatsApp para fazer o seguinte: Confirmar se é possível enviar uma mensagem para seu número de telefone do WhatsApp Business. Confirmar se nossos Termos de Serviço mais recentes foram aceitos (caso contrário, será necessário acessar Configurações > Ajuda, ou Configurações > Informações sobre o app, para aceitá-los)Atualizar para a versão mais recente do cliente do WhatsApp.
O que significa o erro 130472 da API do WhatsApp?
A mensagem não foi enviada como parte de um experimento. Consulte Experimento de mensagem de marketing.
Cansado de caçar erro da API na mão?
No Connecta Desk você opera a API Oficial com quem é Meta Business Partner, e conta com o nosso time quando a Meta devolve um erro.