# Códigos de erro da Cloud API do WhatsApp: o que significam e como resolver > Os erros da API do WhatsApp chegam como um código numérico, com título e mensagem, no retorno do envio ou no webhook de status failed. Cada código aponta uma causa: permissão, parâmetro, template, destinatário, pagamento, limite ou instabilidade, e a Meta indica a ação para cada um. Na AD PRO, que dispara pela API oficial, o teste em números reais pega erro de template e de variável antes de a base inteira receber. Página original: https://www.adprotecnologia.com.br/disparo-em-massa/codigos-de-erro-whatsapp-api Autor: AD PRO Tecnologia. Publicado em 2026-10-31. Atualizado em 2026-11-07. ## Onde o erro aparece e o que vem dentro dele? A Cloud API devolve o erro de dois jeitos. Quando a Meta recusa o pedido de envio, o erro volta na hora, na resposta da chamada. Quando a mensagem é aceita, mas não chega ao celular, o aviso vem depois, pelo webhook de status, com o status **failed**. Nos dois casos o erro traz um **código**, um **título**, uma **mensagem** e, em muitos casos, um campo de detalhe e um link para a documentação. O código é o que importa. Com ele, você sabe se o problema está na credencial, no texto do template, no número do contato, no pagamento ou no ritmo do envio. Para entender como o webhook entrega esses avisos, veja [o que é webhook](https://www.adprotecnologia.com.br/crm/blog/o-que-e-webhook) e o guia de [status de entrega da API](https://www.adprotecnologia.com.br/disparo-em-massa/status-de-entrega-whatsapp-api). Todos os códigos desta página foram conferidos na tabela oficial de códigos de erro da Meta em 31/10/2026. Se um código que você viu não está aqui, a tabela oficial é a fonte final, e os links ficam no fim da página. ## Quais são os erros mais comuns e o que fazer em cada um? A tabela agrupa por causa, porque é assim que se resolve na prática: primeiro descobre-se em que camada está o problema, depois se aplica a ação. **Códigos de erro da Cloud API do WhatsApp, por tipo de causa (fonte: documentação oficial da Meta)** | Tipo | Código | O que a Meta diz | Ação recomendada | | --- | --- | --- | --- | | Credencial e permissão | 0, 190 | Usuário do app não autenticado, ou token de acesso expirado | Gerar um novo token de acesso | | Credencial e permissão | 3, 10, 200 a 299, 131005 | Permissão ausente ou removida, ou conta sem elegibilidade | Conferir as permissões no depurador de token de acesso | | Parâmetro | 131008, 131009 | Parâmetro obrigatório ausente, ou valor de parâmetro inválido | Conferir a referência do endpoint e os valores aceitos | | Template | 132000 | Quantidade de valores diferente da quantidade de variáveis do template | Enviar um valor para cada variável | | Template | 132001 | Template inexistente no idioma pedido, ou não aprovado | Conferir aprovação, nome e idioma do template | | Template | 132007 | Conteúdo do template viola uma política do WhatsApp | Revisar o conteúdo conforme a revisão de templates | | Template | 132012 | Valores fora do formato exigido pelo template | Formatar os valores como o template pede | | Template | 132015, 132016 | Template pausado por baixa qualidade, ou desativado após pausas repetidas | Editar e reenviar para aprovação, ou criar um template novo | | Destinatário | 131026 | Mensagem não entregável (número sem WhatsApp, termos não aceitos ou app desatualizado) | Confirmar com o contato; usar outro canal se preciso | | Destinatário | 131047 | Mais de 24 horas desde a última resposta do contato | Enviar um template, não texto livre | | Destinatário | 131050 | Contato optou por não receber marketing da sua empresa | Não tentar de novo; acompanhar o webhook de preferências | | Destinatário | 131049 | Mensagem não entregue para proteger o engajamento do ecossistema | Esperar pelo menos 24 horas antes de reenviar o template | | Conta | 131063 | Template de marketing rejeitado porque a empresa desligou o marketing na Cloud API (opção disponível desde 06/04/2026) | Conferir a configuração de marketing da conta antes de disparar campanha | | Preço | 131065 | Template com max price (lance máximo) enviado para país sem esse recurso | Revisar a configuração de max price por país do template | | Ritmo | 130429, 131056 | Limite de vazão da Cloud API, ou mensagens demais do mesmo remetente para o mesmo contato | Reduzir a frequência e tentar mais tarde | | Conta e pagamento | 368, 131031 | Conta restrita ou desativada por violação de política | Ler a documentação de aplicação de políticas e resolver a violação | | Conta e pagamento | 131037, 131042 | Número 555 sem nome de exibição aprovado, ou problema na forma de pagamento | Aprovar o nome de exibição; revisar a cobrança (limite de crédito, moeda, fuso) | | Registro do número | 131045, 133010 | Número não registrado na plataforma | Registrar o número e tentar de novo | | Instabilidade | 131000, 131016, 131057, 133004 | Erro desconhecido, serviço indisponível, conta em manutenção ou servidor indisponível | Consultar o status da plataforma e tentar de novo mais tarde; se persistir, abrir chamado | > **O 131049 tem página própria:** O 131049 é o erro de quem dispara marketing: a Meta limita quantas mensagens de marketing cada pessoa recebe, e a que passa do limite volta com esse código. Em uma linha: espere pelo menos 24 horas antes de reenviar o template. O passo a passo completo está em [mensagem de marketing não entregue no WhatsApp](https://www.adprotecnologia.com.br/crm/blog/mensagem-de-marketing-nao-entregue-whatsapp). ## Por que o erro de template é o mais frequente em disparo? No disparo em massa, toda mensagem que a empresa começa sai por template. Por isso a maior parte dos erros de campanha mora nessa camada. Três situações explicam quase tudo: - **132000 e 132012 (variáveis).** A planilha tem uma coluna a menos, uma célula vazia ou um valor em formato errado, e o envio daquele contato falha. A causa é quase sempre a base, não o template. - **132001 (template não encontrado).** O nome está com letra diferente, o idioma não bate ou o template ainda está em análise. Cada idioma é um template separado, e a Meta não traduz sozinha. - **132015 e 132016 (qualidade).** O template recebeu muito feedback negativo ou leitura baixa e foi pausado. A pausa dura 3 horas na primeira vez e 6 horas na segunda; na terceira, o template é desativado e precisa ser substituído por um novo. Para evitar reprovação antes mesmo do envio, veja o guia de [template reprovado no WhatsApp](https://www.adprotecnologia.com.br/crm/blog/template-reprovado-whatsapp) e as regras de [templates do WhatsApp API](https://www.adprotecnologia.com.br/crm/blog/templates-do-whatsapp-api). Se o seu caso é de pausa, a causa de fundo costuma ser a [qualidade do número e dos templates](https://www.adprotecnologia.com.br/crm/blog/qualidade-do-numero-whatsapp-api). ## O que significam os erros que dependem do contato? Alguns erros não têm conserto do seu lado, porque a causa está no contato ou na regra da Meta para ele. O trabalho é reconhecer o tipo e agir certo. - **131026:** a Meta lista como causas um número que não tem WhatsApp, um contato que não aceitou os termos mais recentes e um aplicativo desatualizado. Em lista grande, parte dos 131026 costuma ser número inválido; por isso a [higienização da base](https://www.adprotecnologia.com.br/disparo-em-massa/limpeza-de-base-para-disparo) vem antes do envio. - **131047:** a conversa está fora da janela de 24 horas. Texto livre não passa; só template. Entenda a regra em [janela de 24 horas do WhatsApp](https://www.adprotecnologia.com.br/crm/blog/janela-de-24-horas-do-whatsapp). - **131050:** a pessoa pediu para não receber marketing da sua empresa. A orientação da Meta é não tentar de novo. Registre a saída na sua base e respeite o pedido, como manda a política de opt-in descrita em [opt-in no WhatsApp](https://www.adprotecnologia.com.br/crm/blog/opt-in-whatsapp). - **131056:** muitas mensagens do mesmo remetente para o mesmo contato em pouco tempo. Mensagens para outros contatos não são afetadas. Espaçar o envio resolve. ## E quando o erro é da conta, do pagamento ou do limite? Esses são os que param a operação inteira, não só um contato. Vale reconhecê-los rápido. - **368 e 131031:** a conta foi restringida ou desativada por violação de política. A ação é ler a documentação de aplicação de políticas da Meta e resolver o ponto citado. O 131031 também aparece quando os dados do pedido não batem com os da conta, como um PIN de duas etapas incorreto. - **131042:** problema de pagamento. A Meta manda revisar a configuração de cobrança: limite de crédito, moeda e fuso horário não definidos, ou solicitações pendentes. - **131037:** a Meta descreve este erro para números 555 sem nome de exibição aprovado. Resolva a aprovação do nome antes de tentar de novo. - **130429:** o limite de vazão da Cloud API foi atingido. A saída é reduzir a frequência e tentar depois. O limite de quantas pessoas diferentes você alcança por dia é outro assunto, explicado em [limite de envio do WhatsApp API](https://www.adprotecnologia.com.br/disparo-em-massa/limite-de-envio-whatsapp-api). Se o erro for de conta restrita, o caminho é recorrer pelos canais da Meta. Para entender o que leva a isso e como evitar, leia [conta restrita no WhatsApp API](https://www.adprotecnologia.com.br/disparo-em-massa/conta-restrita-whatsapp-business-api). ## Como diagnosticar um erro em cinco passos? 1. **Anote o código e a mensagem completa.** O número sozinho engana. O título e o campo de detalhe do erro trazem o contexto, como qual parâmetro falhou ou qual mídia não subiu. 2. **Descubra a camada.** Use a tabela acima: credencial, parâmetro, template, destinatário, ritmo, conta ou instabilidade. Isso define quem resolve. 3. **Veja quantos contatos tiveram o mesmo erro.** Um contato com 131026 é número ruim. Mil contatos com 132000 é problema de coluna na planilha. A proporção diz a causa. 4. **Corrija na origem.** Planilha, template, pagamento ou token. Reenviar sem corrigir só repete o erro e pode gastar qualidade do número. 5. **Reenvie só a parte que falhou, respeitando a espera.** Nos erros que pedem espera (como 131049, 24 horas), aguarde antes de repetir. Não reenvie a lista inteira. **Registro de erro para guardar a cada campanha** ```text Campanha: ____________________ Data: ___/___/_____ Template: ____________________ Idioma: ______ Código do erro: ________ Título: ______________________ Mensagem / detalhe: ____________________________________ Quantos contatos afetados: ______ de ______ enviados Camada (marque uma): [ ] credencial/permissão [ ] parâmetro [ ] template [ ] destinatário [ ] ritmo/vazão [ ] conta/pagamento [ ] instabilidade Causa confirmada: ______________________________________ Correção feita: ________________________________________ Reenvio: [ ] não precisa [ ] sim, para os ______ contatos, após ___ horas de espera Aprendizado para a próxima campanha: ___________________ ``` ## Como a AD PRO reduz erro de envio antes do disparo? > **Como a AD PRO faz:** Boa parte dos códigos da tabela nasce em três lugares: base, template e conta. Cada etapa do serviço ataca um deles. O tratamento da base (duplicados, números inválidos, DDI e DDD) reduz os 131026. A revisão de copy, variáveis e template previne os 132000, 132001 e 132012. E a conta é da própria AD PRO na API oficial, então token, permissão, pagamento e registro do número não chegam a ser problema seu. O teste em números reais fecha a conferência antes do primeiro lote. O resultado prático é que você não precisa ler webhook nem decorar tabela de código. Entenda o serviço completo em [serviço de disparo em massa](https://www.adprotecnologia.com.br/disparo-em-massa/servico-de-disparo-em-massa) e veja como o relatório funciona em [relatório de disparo em massa](https://www.adprotecnologia.com.br/disparo-em-massa/relatorio-de-disparo-em-massa). Se você prefere montar a operação por conta própria, a página do [hub de disparo em massa](https://www.adprotecnologia.com.br/disparo-em-massa) mostra os caminhos. ## Perguntas frequentes ### O que significa o erro 131063 no WhatsApp? O 131063 aparece quando a conta desligou o envio de marketing pela Cloud API, opção que a Meta oferece desde 06/04/2026: os templates de marketing passam a ser rejeitados com esse código. Se a campanha é de marketing, confira essa configuração antes de disparar. ### O que significa o erro 131026 no WhatsApp? Significa mensagem não entregável. A Meta lista como causas um número que não tem WhatsApp, um contato que não aceitou os termos mais recentes e um app desatualizado. Peça ao contato para conferir esses pontos ou use outro canal. ### O que significa o erro 131047? Significa que se passaram mais de 24 horas desde a última resposta do contato, então a conversa está fora da janela de atendimento. A solução é enviar um template aprovado em vez de texto livre. ### O que fazer quando a mensagem de marketing volta com 131049? Esperar pelo menos 24 horas antes de reenviar o template, porque reenviar antes tende a falhar de novo. O erro vem do limite que a Meta aplica a quantas mensagens de marketing cada pessoa recebe. O guia [mensagem de marketing não entregue](https://www.adprotecnologia.com.br/crm/blog/mensagem-de-marketing-nao-entregue-whatsapp) detalha o caso. ### Por que recebo o erro 132001? O template não existe no idioma pedido ou ainda não foi aprovado. Confira se o nome está idêntico, se o idioma é o mesmo do cadastro e se o status do template é aprovado. Cada idioma conta como um template separado. ### O erro 130429 é o limite diário de envio? Não. O 130429 indica que o limite de vazão da Cloud API foi atingido, ou seja, muitas mensagens por segundo. O limite de quantas pessoas diferentes você alcança em 24 horas é outro e sobe conforme a qualidade e o uso. ### Mensagem com erro é cobrada? A Meta informa que cobra por mensagem entregue. A página de limite de marketing por pessoa não diz se a mensagem barrada com 131049 é cobrada, então não conte com isso sem conferir. Na AD PRO, o saldo de disparos é debitado conforme as mensagens entregues, comprovadas no relatório. ## Fontes - [Meta for Developers, códigos de erro da WhatsApp Cloud API](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes), conferido em 2026-10-31 - [Meta for Developers, webhook de status de mensagens](https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/messages/status), conferido em 2026-10-31 - [Meta for Developers, pausa de templates](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-pausing), conferido em 2026-10-31 - [Meta for Developers, limites de envio de mensagens](https://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limits), conferido em 2026-10-31 - [Meta for Developers, preços da WhatsApp Business Platform](https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing), conferido em 2026-10-31 - [Meta for Developers, changelog da Marketing Messages API for WhatsApp](https://developers.secure.facebook.com/docs/whatsapp/marketing-messages-api-for-whatsapp/changelog), conferido em 2026-10-31 --- AD PRO Tecnologia LTDA, CNPJ 68.425.611/0001-15, São Paulo/SP. Atendimento on-line para todo o Brasil. Diagnóstico comercial gratuito de 30 minutos: https://www.adprotecnologia.com.br/#agendar. WhatsApp +55 11 98604-5939. Fatos e preços publicados: https://www.adprotecnologia.com.br/fatos