Mensagens não chegam, deram erro ou número bloqueado? Entenda os motivos e soluções
Está com problemas no envio de mensagens pelo WhatsApp Oficial (API)? A maioria das falhas ocorre devido às regras de proteção da Meta (janela de 24h, qualidade do número ou templates reprovados). Veja como identificar se o erro é operacional ou técnico.
PASSO A PASSO PARA DIAGNÓSTICO DE FALHAS:
- Verifique a "Janela de 24 horas" Se o cliente não respondeu nas últimas 24 horas, você NÃO pode enviar mensagens livres.
Solução: Envie um "Modelo de Mensagem" (Template) aprovado para reabrir a conversa. Se tentar enviar texto livre, dará erro.
- Consulte o Status do Envio (Códigos de Erro Comuns) A plataforma retorna códigos da Meta que explicam a falha. Os mais frequentes são:
-
Erro 131047 (Janela fechada): Use um template.
-
Erro 131026 (Não entregue): Número inválido ou sem WhatsApp.
-
Erro 131050 (Bloqueio): O cliente optou por não receber mensagens de marketing.
-
Erro 130472 (Experimento): O número do cliente está em teste pela Meta e não pode receber mensagens de empresas temporariamente. (Não há solução, é restrição da Meta).
- Verifique seus Créditos e Status do Número
-
Sem saldo? Vá em "Configurações > Gestão Financeira > Créditos Octa".
-
Número Desconectado/Banido? Acesse seu Gerenciador de Negócios da Meta e verifique a "Qualidade do Número".
EVITANDO O BANIMENTO (BOAS PRÁTICAS):
O bloqueio ou banimento do número é uma ação automática da Meta, baseada em suas análises e denúncias de usuários. Para manter sua "Saúde do número" (Classificação Verde):
-
Não faça SPAM: Só envie mensagens para quem aceitou receber (Opt-in).
-
Aqueça o número: Se o número é novo, aumente o volume de envios gradualmente. Não dispare milhares de mensagens no primeiro dia.
-
Respeite o Opt-out: Se o cliente pedir para parar, pare. Denúncias derrubam sua qualidade rapidamente.
-
Humanize os Templates: Use variáveis (ex: Olá {nome}) para evitar que o sistema marque como robô/spam repetitivo.
SITUAÇÃO ESPECÍFICA? ENTENDA MELHOR O CENÁRIO:
É fundamental entender a divisão de papéis para resolver seu problema mais rápido:
-
Papel da Meta (Detentora do WhatsApp): Define as regras, aprova/reprova templates, monitora a qualidade e decide sobre bloqueios ou banimentos.
-
Papel da Octadesk (BSP - Provedora Oficial): Fornece a tecnologia para integrar o WhatsApp ao sistema.
Nota: A Octadesk não tem poder para "desbanir" um número manualmente, pois isso é uma sanção da Meta. Nós ajudamos você a ajustar sua operação e orientamos no processo de apelação junto à Meta.
QUANDO FALAR COM O SUPORTE?
-
Se aparecerem erros de API (código 500 ou "Erro desconhecido/Genérico").
-
Se você tem créditos, o número está "Verde/Conectado", o template está aprovado, mas o envio falha mesmo assim.
-
Para dúvidas sobre como configurar templates complexos.
Canais de Atendimento:
-
Chat de Ajuda: Dentro da plataforma.
-
WhatsApp: (11) 96913-9476
OBSERVAÇÕES IMPORTANTES📝:
-
Templates Reprovados: Revise ortografia, espaçamento e evite pedir dados sensíveis (número de cartão completo). A Meta reprova templates com erros gramaticais ou formatação estranha.
-
Ouvidoria: Caso seu problema técnico persista após atendimento no suporte nos encaminhe uma Ouvidoria no e-mail: [email protected]
LINKS ÚTEIS:
-
Status da Plataforma: https://status.octadesk.com/
-
Tutorial: Boas práticas para qualidade do número (Base de Conhecimento).
-
Tutorial: Como criar modelos de mensagem aprovados (Base de Conhecimento).


Ótimo