Erros de entrega de mensagens

Erros de entrega de mensagens significam que a Meta aceitou sua mensagem, mas não conseguiu entregá-la – por causa do cliente, da janela de 24 horas, do faturamento, da mídia ou da sua conta. Abaixo, eles estão ordenados aproximadamente pela frequência com que ocorrem.

Erro 131042 - Problema de pagamento

O que é afetado: Conta inteira · Tentar novamente ajuda? Depois de corrigir · Onde corrigir: WhatsApp Manager > Configurações de pagamento

O que você vê: Mensagens de modelo falham com o erro 131042, um problema de pagamento relacionado à elegibilidade da empresa.
Diagnóstico simples: A Meta não consegue cobrar da conta: não há cartão ou linha de crédito válidos, o cartão foi recusado ou expirou, ou faltam a moeda e o fuso horário. Isso é comum logo após a migração de outro provedor cuja linha de crédito ainda está vinculada. Mensagens com falha não são cobradas.

Solução 1 – Abordagem sugerida
1. WhatsApp Manager > Configurações de pagamento: adicione ou atualize um cartão válido ou verifique se a linha de crédito está ativa.
2. Confira se o cartão permite pagamentos internacionais e se não está vencido.
3. Confira se há uma moeda e um fuso horário definidos na conta.
4. Migrou de outro provedor? Peça para ele remover a linha de crédito e reconecte a conta.
5. Envie uma mensagem de teste antes de reiniciar as campanhas.

Solução 2 – Verificada pela Chakra: Verificação em andamento. Se a Solução 1 não resolver o problema, abra um chamado com o suporte da Chakra.

Erro 131026 - Mensagem não entregue

O que é afetado: Este cliente · Tentar novamente ajuda? Não, a menos que o cliente resolva o problema · Onde corrigir: O telefone do cliente

O que você vê: Mensagens para um contato falham com o erro 131026, mensagem não entregue.
Diagnóstico simples: O número não está no WhatsApp, o cliente não aceitou os termos mais recentes do WhatsApp, o aplicativo está desatualizado ou o cliente bloqueou sua empresa. A Meta não informa qual é o caso.

Solução 1 – Abordagem sugerida
1. Confira se o número está no WhatsApp (abra wa.me/ seguido do número).
2. Entre em contato com o cliente por outro meio (SMS, ligação, e-mail) e peça para atualizar o WhatsApp, aceitar os termos mais recentes e conferir se seu número não está em Configurações > Privacidade > Bloqueados.
3. Peça para o cliente enviar primeiro uma mensagem para o número da sua empresa.
4. Após falhas repetidas, pare de enviar mensagens e marque o contato como indisponível.

Solução 2 – Verificada pela Chakra: Verificação em andamento. Se a Solução 1 não resolver o problema, abra um chamado com o suporte da Chakra.

Erro 131049 - Não entregue para manter um ecossistema saudável

O que é afetado: Marketing para este cliente · Tentar novamente ajuda? Sim, após 24h ou mais (nunca para números dos EUA +1) · Onde corrigir: Horário e público da campanha

O que você vê: Mensagens de modelo de marketing para alguns contatos falham com o erro 131049.
Diagnóstico simples: A Meta limita quantas mensagens de marketing cada pessoa recebe de todas as empresas. Este cliente atingiu esse limite. Ele se aplica a todas as empresas, inclusive às verificadas. Números dos EUA (+1) não podem receber mensagens de modelo de marketing.

Solução 1 – Abordagem sugerida
1. Não reenvie imediatamente.
2. Tente novamente após pelo menos 24 horas, deixando intervalos maiores a cada tentativa – ou aguarde a resposta do cliente, que abre uma janela de 24 horas em que qualquer mensagem é entregue.
3. Para números dos EUA (+1), use SMS ou e-mail.
4. Envie mensagens de marketing apenas para contatos engajados que aceitaram recebê-las; use um modelo de utilidade classificado corretamente para atualizações transacionais.

Solução 2 – Verificada pela Chakra: Verificação em andamento. Guia completo: https://chakrahq.com/help/chat/faqs/whatsapp-api-error-code-troubleshooting/whatsapp-error-131049

Erro 131047 - Janela de 24 horas expirada

O que é afetado: Mensagens comuns para este cliente · Tentar novamente ajuda? Use um modelo em vez disso · Onde corrigir: Caixa de entrada ou fluxo do bot

O que você vê: Uma mensagem comum (sem modelo) falha com o erro 131047, mensagem de reengajamento.
Diagnóstico simples: Já se passaram mais de 24 horas desde que o cliente enviou uma mensagem, então só é possível enviar modelos aprovados. Em casos raros, a Meta retorna esse erro por engano dentro da janela.

Solução 1 – Abordagem sugerida
1. Envie um modelo aprovado.
2. Quando o cliente responder, as mensagens comuns voltarão a funcionar por 24 horas.
3. Confira se os fluxos do bot não enviam mensagens comuns após longos períodos de espera.

Solução 2 – Verificada pela Chakra: Verificação em andamento. Se a Solução 1 não resolver o problema, abra um chamado com o suporte da Chakra.

Erro 131050 - Usuário optou por não receber mensagens de marketing

O que é afetado: Marketing para este cliente · Tentar novamente ajuda? Não · Onde corrigir: Em nenhum lugar – respeite a escolha

O que você vê: Mensagens de modelo de marketing para um contato falham com o erro 131050.
Diagnóstico simples: O cliente escolheu parar de receber mensagens de marketing da sua empresa. Somente ele pode reativá-las.

Solução 1 – Abordagem sugerida
1. Pare de enviar mensagens de marketing para este contato e exclua-o das transmissões de marketing.
2. Modelos de utilidade e de autenticação, além de respostas comuns, continuam funcionando.

Não faça isto: Não envie conteúdo de marketing como modelo de utilidade para contornar a opção de não receber mensagens – isso viola a política do WhatsApp.

Solução 2 – Verificada pela Chakra: Verificação em andamento. Se a Solução 1 não resolver o problema, abra um chamado com o suporte da Chakra.

Erro 131053 - Erro no envio de mídia

O que é afetado: Esta mensagem · Tentar novamente ajuda? Depois de corrigir · Onde corrigir: O arquivo de mídia

O que você vê: Uma mensagem com imagem, vídeo ou arquivo falha com o erro 131053.
Diagnóstico simples: O tipo de arquivo não é compatível, o arquivo é muito grande ou o link não é um link público direto (por exemplo, um link de compartilhamento do Google Drive).

Solução 1 – Abordagem sugerida
1. Confira o arquivo: imagens JPEG ou PNG de até 5 MB; vídeos MP4 de até 16 MB; áudio de até 16 MB; documentos de até 100 MB.
2. Envie o arquivo diretamente ou use um link público direto que abra o próprio arquivo.
3. Reenvie.

Solução 2 – Verificada pela Chakra: Verificação em andamento. Se a Solução 1 não resolver o problema, abra um chamado com o suporte da Chakra.

Erro 131052 - Não é possível baixar a mídia enviada pelo cliente

O que é afetado: Um arquivo recebido · Tentar novamente ajuda? Peça para o cliente reenviar · Onde corrigir: Cliente

O que você vê: Um arquivo enviado pelo cliente não abre na caixa de entrada e aparece o erro 131052.
Diagnóstico simples: O WhatsApp não conseguiu baixar o arquivo – ele pode estar corrompido, não ser compatível ou estar temporariamente indisponível.

Solução 1 – Abordagem sugerida
1. Peça para o cliente enviar o arquivo novamente.
2. Se falhar novamente, peça para enviar como documento em vez de foto.

Solução 2 – Verificada pela Chakra: Verificação em andamento. Se a Solução 1 não resolver o problema, abra um chamado com o suporte da Chakra.

Erro 130403 - A empresa bloqueou este usuário

O que é afetado: Este cliente · Tentar novamente ajuda? Não, até você desbloquear · Onde corrigir: Lista de bloqueados da sua empresa

O que você vê: Mensagens falham com o erro 130403, informando que sua empresa bloqueou este usuário.
Diagnóstico simples: Alguém da sua equipe bloqueou o número deste cliente.

Solução 1 – Abordagem sugerida
1. Confira se o bloqueio foi intencional (spam, abuso). Se foi, mantenha-o.
2. Caso contrário, desbloqueie o usuário no local onde ele foi bloqueado (para números do aplicativo WhatsApp Business, na lista de contatos bloqueados do aplicativo) e reenvie.

Solução 2 – Verificada pela Chakra: Verificação em andamento. Se a Solução 1 não resolver o problema, abra um chamado com o suporte da Chakra.

Erro 131051 - Tipo de mensagem não compatível

O que é afetado: Esta mensagem · Tentar novamente ajuda? Depois de corrigir · Onde corrigir: Tipo de mensagem ou aplicativo WhatsApp Business

O que você vê: Uma mensagem enviada falha com o erro 131051 ou uma mensagem recebida aparece como não compatível.
Diagnóstico simples: Enviada: o tipo de mensagem não é compatível. Recebida: o cliente enviou algo que a API não consegue exibir, como uma enquete ou mídia de visualização única.

Solução 1 – Abordagem recomendada
1. Mensagens de saída: envie um tipo compatível (texto, mídia, localização, contato, interativa ou modelo).
2. Mensagens recebidas em um número do app WhatsApp Business: veja a mensagem no app ou peça ao cliente para reenviá-la como texto.

Solução 2 – Verificada pela Chakra: Verificação em andamento. Se a Solução 1 não resolver o problema, abra um chamado com o suporte da Chakra.

Erro 135000 - Erro genérico do usuário

O que é afetado: Esta mensagem · Tentar novamente ajuda? Depois de corrigir · Onde corrigir: Conteúdo do modelo ou da mensagem

O que você vê: Uma mensagem falha com o erro 135000, um erro genérico do usuário.
Diagnóstico simples: A Meta não conseguiu identificar uma causa específica. Na prática, geralmente é um problema de formato do modelo ou uma restrição do modelo.

Solução 1 – Abordagem recomendada
1. Confira as variáveis e o formato do modelo.
2. Experimente outro modelo aprovado; se funcionar, recrie o modelo que está falhando.
3. Ainda falha? Abra um chamado informando o horário da falha.

Solução 2 – Verificada pela Chakra: Verificação em andamento. Se a Solução 1 não resolver o problema, abra um chamado com o suporte da Chakra.

Erro 131037 - O número 555 precisa de um nome de exibição aprovado

O que é afetado: Este número · Tentar novamente ajuda? Depois de corrigir · Onde corrigir: WhatsApp Manager

O que você vê: Mensagens enviadas de um número 555 (fornecido pela Meta) falham com o erro 131037.
Diagnóstico simples: Números 555 fornecidos pela Meta não podem enviar mensagens até que o nome de exibição seja aprovado.

Solução 1 – Abordagem recomendada
1. Defina o nome de exibição no WhatsApp Manager e aguarde a aprovação.
2. Ou envie mensagens do seu próprio número comercial verificado.

Solução 2 – Verificada pela Chakra: Verificação em andamento. Se a Solução 1 não resolver o problema, abra um chamado com o suporte da Chakra.

Erro 131021 - Remetente e destinatário são iguais

O que é afetado: Esta mensagem · Tentar novamente ajuda? Não · Onde corrigir: Número do destinatário

O que você vê: Uma mensagem falha com o erro 131021.
Diagnóstico simples: Você tentou enviar uma mensagem para o número da sua própria empresa. Isso geralmente acontece durante os testes.

Solução 1 – Abordagem recomendada
1. Envie para outro número.

Solução 2 – Verificada pela Chakra: Verificação em andamento. Se a Solução 1 não resolver o problema, abra um chamado com o suporte da Chakra.

Erro 131057 - Conta em modo de manutenção

O que é afetado: Toda a conta, por pouco tempo · Tentar novamente ajuda? Sim, depois de aguardar · Onde corrigir: Nada para corrigir – aguarde

O que você vê: As mensagens falham com o erro 131057, conta em modo de manutenção.
Diagnóstico simples: A Meta está fazendo a manutenção da conta, geralmente durante uma atualização da capacidade de envio.

Solução 1 – Abordagem recomendada
1. Aguarde – geralmente de alguns minutos a algumas horas – e depois reenvie.

Solução 2 – Verificada pela Chakra: Verificação em andamento. Se a Solução 1 não resolver o problema, abra um chamado com o suporte da Chakra.

Ainda com problemas?

Abra um chamado com o suporte da Chakra e informe o número do cliente, o horário da mensagem que falhou e o código de erro exato. Referência da Meta: https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes