Solução de Problemas

Causas: sem conexão, fora da janela 24h, contato bloqueou, rate limit excedido.

Mensagens não são entregues

Quando uma mensagem fica com status de erro ou o contato não recebe, verifique os pontos abaixo.

Primeiro: confira a conexão

  1. Vá em Instâncias e veja se o status está Conectado (badge verde).
  2. Se estiver Desconectado, clique em Reconectar e leia o QR Code novamente.
  3. Se estiver Banido, veja Número banido ou bloqueado.

/instances (lista com status Conectado e Desconectado) Figura 1: Comparativo de instâncias conectadas e desconectadas

Causas frequentes

Instância desconectada

Sem conexão ativa, nenhuma mensagem é enviada. Reconecte antes de tentar de novo.

Contato bloqueou o número

Se o cliente bloqueou seu WhatsApp, a mensagem não chega. Não há como contornar isso pela plataforma.

Fora da janela de 24 horas (API oficial)

Na API oficial do WhatsApp Business, mensagens livres só funcionam dentro de 24h após a última mensagem do contato. Fora disso, use um template aprovado.

Número inválido

Confira se o telefone do contato está correto, com DDD e código do país (+55).

Muitas mensagens em pouco tempo

O WhatsApp pode limitar envios quando o volume é alto demais. Reduza a velocidade das campanhas e comece com lotes menores em números novos.

Como investigar

  1. Abra a conversa na Central de Conversas e veja o status da mensagem (enviada, entregue, lida ou erro).
  2. Em Campanhas, consulte o relatório da campanha para ver quantas falharam e o motivo.
  3. Em workflows, abra o histórico de execuções e verifique se o nó de mensagem executou com sucesso.

/chats (conversa com mensagem e ícone de erro ou status) Figura 2: Mensagem com indicador de status na Central de Conversas

O que tentar

SituaçãoAção
Instância desconectadaReconectar via QR Code
Campanha com muitas falhasPausar, revisar lista e reduzir volume
API oficial, sem resposta do contato há diasUsar template HSM aprovado
Número banidoSeguir guia de recuperação
Erro em workflowVerificar logs do nó de mensagem

Dicas para evitar falhas

  • Mantenha a instância sempre conectada — ative notificações de desconexão.
  • Limpe a base de contatos com números inválidos ou duplicados.
  • Em campanhas, siga as boas práticas anti-bloqueio.

Ainda com problemas?

Entre em contato com o suporte com o número da instância, um exemplo de contato que não recebeu e o horário do envio.

Este artigo foi útil?

Precisa de mais ajuda? Falar com suporte

Central de Ajuda