Códigos de erro da WhatsApp Cloud API
Esta é a lista de todos os códigos de erro da WhatsApp Cloud API que documentamos, numa tabela, com o significado de cada um e indicação sobre se vale a pena repetir o pedido. A maioria não vale: são determinísticos, pelo que o mesmo pedido falha da mesma forma e um ciclo de repetição transforma um pedido inválido num rate limit.
A EasyCoexistence monitoriza continuamente a ligação e regista na linha temporal da ligação os eventos da própria Meta sobre a conta e a qualidade.
Pedido
| Código | O que significa | Repetir |
|---|---|---|
| 100 | Um parâmetro não é suportado, está mal escrito ou mal formado. | 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 | O remetente e o 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 transferir um ficheiro multimédia enviado por um cliente. | Não |
| 131053 | A Meta não conseguiu carregar um ficheiro multimédia que enviou. Tamanho, formato ou acesso. | Não |
Template
| Código | O que significa | Repetir |
|---|---|---|
| 132000 | O número de parâmetros não corresponde ao template. | Não |
| 132001 | Não existe nenhum template com esse par de nome e idioma. | Não |
| 132007 | O template viola a política de mensagens. Reescreva-o e volte a submetê-lo. | Não |
| 132012 | O formato do parâmetro não corresponde ao que o template define. | Não |
| 132015 | O template está em pausa após uma descida de qualidade. É temporário. | Esperar |
| 132016 | O template foi desativado permanentemente. Não voltará. | 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 todo. | Não |
| 131050 | A pessoa saiu da lista. Não há forma de contornar, por conceção. | Não |
| 130497 | O envio de mensagens para esse país está restrito para a sua conta. | Não |
Registo e PIN
| Código | O que significa | Repetir |
|---|---|---|
| 131045 | O número nunca foi registado para mensagens através da Cloud API. | Não |
| 133010 | O número não está registado. É preciso concluir o registo. | Não |
| 133006 | O número tem de ser verificado antes de poder ser registado. | Não |
| 133005 | O PIN da verificação em dois passos estava errado. Deixe de tentar adivinhar. | Não |
| 133008 | Demasiadas tentativas de PIN. O registo fica bloqueado durante um período. | Esperar |
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 das políticas. | Não |
| 131031 | A conta está restrita, ou os seus dados não correspondem aos da Meta. | Não |
| 131042 | Um problema de pagamento na conta empresarial 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 | Foi atingido o limite de throughput de mensagens da conta. | Esperar |
| 131048 | Foi atingido um limite de taxa por spam. A causa é a qualidade, não o volume. | Não |
| 131056 | Demasiadas mensagens entre o seu número e um mesmo destinatário. | Não |
| 80007 | A conta atingiu o limite de chamadas de gestão. Normalmente, polling. | Esperar |
Transitórios
Sincronização da Coexistência
Como ler a coluna de repetição
Tem três valores, e escolher mal entre eles é o erro mais dispendioso de toda esta referência.
Não significa que a falha seja determinística. O que falhou foi o pedido, o template ou o estado do destinatário, e enviar novamente o pedido idêntico produz o mesmo erro, consumindo entretanto throughput de que poderá precisar mais tarde. Sim significa que a falha ocorreu do lado da Meta e que um backoff resolve realmente o problema. Esperar significa que a condição é real, mas temporária: um limite ou bloqueio que desaparece por si; repetir antes disso não faz nada e pode prolongá-lo.
Porque é que a maioria destes códigos não permite repetir
Porque a plataforma devolve códigos específicos, em vez de códigos genéricos. Um parâmetro malformado, um template inexistente, uma janela de mensagens fechada e um destinatário que deixou de aceitar mensagens são situações conhecidas no momento da resposta. Por isso, a Meta identifica-as em vez de falhar de forma vaga.
- Um problema no pedido não fica correto à segunda tentativa.
- Um problema no template está no próprio template, que o pedido não pode alterar.
- Um problema de janela ou de recusa diz respeito ao estado do destinatário, não ao seu.
- Uma restrição da conta é uma decisão, e repetir não é um recurso.
O que registar quando um destes códigos surge
O suficiente para o diagnosticar sem o reproduzir, que é a diferença entre uma correção de cinco minutos e um dia de tentativas ao acaso.
- A resposta de erro completa, incluindo o trace id, que é o que o apoio da Meta pede.
- O corpo do pedido tal como foi enviado, não como pretendia enviá-lo. A diferença entre os dois é geralmente o erro.
- O phone number id, para distinguir um problema num número de um problema em toda a conta.
- O carimbo temporal, para verificar a falha face ao estado da ligação nesse momento.
Os códigos que só existem no Coexistence
São dois e confundem porque parecem falhas de envio normais. 2593107 e 2593108 dizem respeito à sincronização do histórico de conversas, o passo que copia conversas recentes da aplicação WhatsApp Business quando um número é ligado pela primeira vez.
Não são erros de mensagens e não significam que a ligação tenha falhado. Uma sincronização que exceda o limite ou decorra fora da respetiva janela deixa o número ligado e a enviar normalmente, mas com menos histórico copiado do que o esperado. Interpretá-los como uma ligação avariada leva a desligar e recomeçar, o que perde ainda mais histórico em vez de o recuperar.
Perguntas frequentes
Que erros devo repetir?
131016 e 131000, com backoff exponencial. 130429, 132015 e 133008 desaparecem por si se esperar. Todos os restantes são determinísticos.
Um código de erro significa que o meu número está desligado?
Normalmente, não. A maioria diz respeito ao pedido, ao template ou ao destinatário. Os problemas de ligação surgem como webhooks de conta e de qualidade, não como erros de envio.
O que é um trace id?
É um identificador na resposta de erro que permite ao apoio da Meta encontrar o pedido específico. Registe-o em todas as falhas; sem ele, um pedido de apoio não pode ser tratado.
Estes códigos são iguais em todos os fornecedores?
Sim. Vêm da Cloud API da Meta, por isso são idênticos, independentemente do fornecedor que ligou o número. Um fornecedor só pode alterar a clareza com que chegam até si.
Pronto para começar?
Configure a Coexistência do WhatsApp em minutos, não em meses. A aplicação continua a funcionar no telemóvel.
Começar período experimental gratuitoNada é cobrado durante 3 dias. Cancele quando quiser.