Códigos de erro da WhatsApp Cloud API
Esta é a lista de todos os códigos de erro da WhatsApp Cloud API que documentamos, em uma tabela só, com o que cada um significa e se repetir a chamada ajuda. A maioria não ajuda: eles são determinísticos, então a mesma requisição falha do mesmo jeito e um laço de repetição transforma uma requisição ruim em um limite de taxa.
A EasyCoexistence monitora a conexão continuamente e registra os eventos de conta e de qualidade da Meta na linha do tempo da conexão, então os erros que vêm do estado de um número ficam visíveis antes de um envio falhar, e não depois.
Requisição
| Código | O que significa | Repetir |
|---|---|---|
| 100 | Um parâmetro não é suportado, está escrito errado ou malformado. | Não |
| 131008 | Um parâmetro obrigatório não foi incluído. | Não |
| 131009 | Um parâmetro está presente com um valor que o endpoint rejeita. | Não |
| 131021 | Remetente e destinatário são o mesmo número. | Não |
| 131051 | O tipo de mensagem não é suportado, muitas vezes por um limite da Coexistência. | Não |
| 131052 | A Meta não conseguiu baixar uma mídia que um cliente enviou. | Não |
| 131053 | A Meta não conseguiu fazer upload de uma mídia que você enviou. Tamanho, formato ou acesso. | Não |
Template
| Código | O que significa | Repetir |
|---|---|---|
| 132000 | A quantidade de parâmetros não corresponde ao template. | Não |
| 132001 | Não existe template com esse par de nome e idioma. | Não |
| 132007 | O template viola a política de mensagens. Reescreva e envie de novo. | Não |
| 132012 | O formato do parâmetro não corresponde ao que o template define. | Não |
| 132015 | O template está pausado após uma queda de qualidade. É temporário. | Aguarde |
| 132016 | O template foi desativado permanentemente. Ele não volta. | Não |
Janela e destinatário
| Código | O que significa | Repetir |
|---|---|---|
| 131047 | A janela de atendimento de 24 horas está fechada. Envie um template. | Não |
| 131026 | O destinatário não consegue receber a mensagem de forma alguma. | Não |
| 131050 | A pessoa saiu da lista. Não há como contornar, por design. | Não |
| 130497 | Enviar mensagens para esse país está restrito para a sua conta. | Não |
Registro e PIN
| Código | O que significa | Repetir |
|---|---|---|
| 131045 | O número nunca foi registrado para mensagens pela Cloud API. | Não |
| 133010 | O número não está registrado. O registro precisa ser concluído. | Não |
| 133006 | O número precisa ser verificado antes de poder ser registrado. | Não |
| 133005 | O PIN da verificação em duas etapas estava errado. Pare de chutar. | Não |
| 133008 | Tentativas de PIN demais. O registro fica bloqueado por um período. | Aguarde |
Acesso e conta
| Código | O que significa | Repetir |
|---|---|---|
| 190 | O token de acesso expirou ou foi invalidado. | Não |
| 368 | A conta está restrita após uma violação de política. | Não |
| 131031 | A conta está restrita, ou os dados dela não batem com os da Meta. | Não |
| 131042 | Um problema de pagamento na conta comercial bloqueia os envios. | Não |
| 131049 | A Meta bloqueou a mensagem para proteger a saúde do ecossistema. | Não |
Limites de taxa
| Código | O que significa | Repetir |
|---|---|---|
| 130429 | O limite de throughput de mensagens da conta foi atingido. | Aguarde |
| 131048 | Um limite de taxa por spam foi atingido. A causa é qualidade, não volume. | Não |
| 131056 | Mensagens demais entre o seu número e um mesmo destinatário. | Não |
| 80007 | A conta atingiu o limite de chamadas de gerenciamento. Normalmente é polling. | Aguarde |
Transitórios
Sincronização da Coexistência
Como ler a coluna de repetição
Ela tem três valores, e escolher errado entre eles é o erro mais caro desta referência inteira.
Não significa que a falha é determinística. A requisição, o template ou o estado do destinatário é o que falhou, e enviar a requisição idêntica de novo produz o erro idêntico enquanto consome throughput que você vai querer depois. Sim significa que a falha foi do lado da Meta e que um backoff realmente resolve. Aguarde significa que a condição é real, mas temporária: um limite ou um bloqueio que passa sozinho, em que repetir antes de ele passar não faz nada e pode prolongar.
Por que a maioria deles não é repetível
Porque a plataforma devolve códigos específicos em vez de genéricos. Um parâmetro malformado, um template que não existe, uma janela de mensagens fechada e um destinatário que saiu da lista são todos conhecíveis no momento da resposta, então a Meta nomeia eles em vez de falhar de forma vaga.
- Um problema de requisição não fica correto na segunda tentativa.
- Um problema de template vive no template, que a requisição não consegue mudar.
- Um problema de janela ou de saída da lista é sobre o estado do destinatário, não sobre o seu.
- Uma restrição de conta é uma decisão, e repetir não é um recurso.
O que registrar quando um desses chega
O suficiente para diagnosticar sem reproduzir, que é a diferença entre uma correção de cinco minutos e um dia de adivinhação.
- A resposta de erro completa, incluindo o trace id, que é o que o suporte da Meta pede.
- O corpo da requisição como foi enviado, e não como era pretendido. A distância entre os dois costuma ser o bug.
- O phone number id, para que um problema em um número seja distinguível de um problema em toda a conta.
- O carimbo de tempo, para que a falha possa ser conferida contra o estado da conexão naquele momento.
Os códigos que só existem na Coexistência
São dois, e eles confundem as pessoas porque parecem falhas comuns de envio. O 2593107 e o 2593108 dizem respeito os dois à sincronização do histórico de conversas, que é a etapa que copia as conversas recentes do app do WhatsApp Business quando um número é conectado pela primeira vez.
Eles não são erros de mensagem e não querem dizer que a conexão falhou. Uma sincronização que excede o limite dela ou que roda fora da janela dela deixa o número conectado e enviando normalmente, com menos histórico copiado do que se esperava. Ler isso como uma conexão quebrada leva as pessoas a desconectar e começar de novo, o que perde mais histórico em vez de recuperar.
Perguntas frequentes
Quais erros eu devo repetir?
O 131016 e o 131000, com backoff exponencial. O 130429, o 132015 e o 133008 passam sozinhos se você esperar. Todo o resto é determinístico.
Um código de erro quer dizer que meu número foi desconectado?
Em geral não. A maioria deles diz respeito à requisição, ao template ou ao destinatário. Problemas de conexão aparecem como webhooks de conta e de qualidade, e não como erros de envio.
O que é um trace id?
Um identificador na resposta de erro que permite ao suporte da Meta achar aquela requisição específica. Registre em toda falha; sem ele um chamado não pode ser tratado.
Esses códigos são iguais em todo provedor?
São. Eles vêm da Cloud API da Meta, então são idênticos independentemente de qual provedor conectou o número. Um provedor só consegue mudar com que clareza eles chegam até você.
Pronto para começar?
Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.
Começar teste grátisNada é cobrado por 3 dias. Cancele quando quiser.