Mensagens não entregues — diagnóstico
Mensagem cadastrada, status Ativo, evento aconteceu — e nada chegou no celular do cliente. Esse artigo é o passo a passo pra investigar onde a mensagem ficou pelo caminho.
A regra geral é: descubra em qual etapa o problema acontece antes de pedir ajuda. Cada etapa tem ferramentas próprias.
As 4 etapas que uma mensagem percorre
[Pedido / evento] → [Plugin coleta] → [Fila / agendamento] → [API Rishi] → [WhatsApp do cliente]
1 2 3 4
| Etapa | Onde investigar |
|---|---|
| 1. Plugin coleta | Logs do plugin (debug=on) |
| 2. Fila | WooCommerce → Status → Ações agendadas |
| 3. API Rishi | Logs do plugin + status da Rishi |
| 4. Entrega final | Painel da Rishi (status real do envio) |
Passo 1: ative os logs
Sem logs, você está adivinhando. Sempre comece ativando.
- Vá em WooCommerce → WhatsApp → Configurações
- Mude Debug pra Sim
- Salve
A partir desse momento, todas as ações relevantes do plugin ficam registradas em WooCommerce → Status → Logs, com a fonte (source) automation-for-whatsapp.
Lembre de desligar depois. Em produção com volume, debug ativo gera muitos logs e pode pesar o banco. Use durante a investigação e desative quando terminar.
Passo 2: dispare o evento de teste
Repita o evento que estava falhando:
- Mudança de status do pedido → mude o status do pedido manualmente (ex: de "Aguardando" pra "Processando")
- Novo pedido → crie um pedido de teste, ou use a URL
?afw_woocommerce_new_order=ORDER_IDpra disparar o gatilho num pedido existente - Outros gatilhos → reproduza a ação correspondente
Espere uns 30 segundos e prossiga.
Passo 3: leia os logs
WooCommerce → Status → Logs → Selecione o arquivo automation-for-whatsapp-... (o mais recente).
O que procurar:
Sinais de "tudo OK"
ENVIO para 5511999998888
Enviando mensagens: [...]
Servidor retornou 200: ...
→ Mensagem foi enviada à API Rishi com sucesso (HTTP 200). Se mesmo assim não chegou, o problema é etapa 4 (Rishi → WhatsApp do cliente). Próximo passo: painel Rishi.
Sinais de problema na coleta
Telefone não definido: ...
→ O plugin não conseguiu encontrar o telefone do cliente. Verifique:
- O pedido tem campo "Telefone" preenchido?
- Se sim, está num formato esperado (com DDD)?
- A mensagem usa
{{phone_number}}no destinatário?
Sinais de problema de credencial
credenciais não encontradas!
→ A chave da API ou o ID da instância estão vazios ou errados nas configurações. Vá em WooCommerce → WhatsApp → Configurações e confira.
Sinais de problema de rede
WP ERROR: cURL error 28: ...
WP ERROR: cURL error 6: Could not resolve host...
→ Servidor do site não conseguiu conectar com a API Rishi. Geralmente é problema de DNS, firewall, ou bloqueio de saída do servidor. Fala com seu host.
Sinais de erro da API Rishi
Servidor retornou 401: ...
Servidor retornou 403: ...
Servidor retornou 500: ...
| Código | O que significa |
|---|---|
| 401 / 403 | Token ou instância inválidos. Confira no painel Rishi se a instância ainda está conectada |
| 404 | URL/instância não encontrada — geralmente ID errado |
| 422 | Dados inválidos no payload (telefone fora do padrão, mensagem vazia) |
| 429 | Rate limit — muitas mensagens em pouco tempo |
| 500/502/503 | Problema do lado da Rishi. Tente novamente em alguns minutos |
Passo 4: investigue mensagens com delay (fila)
Se a mensagem tem delay (ex: lembrete Pix 30min), ela passa pela fila. Pra investigar:
- WooCommerce → Status → Ações agendadas
- Filtre por grupo:
whatsapp-messages - Veja o status:
| Status na ação agendada | O que significa |
|---|---|
| Pendente com data passada | Cron do WP não está rodando. Veja Mensagens agendadas e fila assíncrona |
| Concluída | Foi executada — confira os logs do plugin pra ver se a chamada à Rishi deu certo |
| Falha | Erro no momento de executar. Abra a ação e veja o stack trace |
| Não existe (não aparece nada) | A mensagem nunca foi agendada. Problema na etapa 1: o gatilho não disparou ou o filtro excluiu |
Passo 5: confira no painel Rishi
Se os logs do plugin dizem "Servidor retornou 200" mas o cliente não recebeu, o problema é na entrega da Rishi pro WhatsApp.
Possíveis causas:
| Causa | Como verificar |
|---|---|
| Cliente cancelou recebimento (respondeu PARAR) | Painel Rishi → Métricas da instância → Cancelamentos |
| Número inválido | Painel Rishi → Falhas de envio → motivo invalid_receiver |
| Instância desconectada | Painel Rishi → Suas Conexões → status |
| Soft-block ativado pela Rishi | Badge "Bloqueada" no painel + contador de mensagens descartadas |
| Cliente bloqueou seu número | Sem como verificar de fora — o WhatsApp não retorna isso |
Veja Conectando uma instância pra mais detalhes do painel da Rishi.
Casos comuns e soluções
Mensagens chegam às vezes
Provavelmente a fila está com gargalo. Veja Action Scheduler — se há muitas ações Pendentes com data passada, o cron está parado. Solução: ativar cron real no servidor.
Algumas mensagens não chegam, e os logs não mostram nada
A mensagem nem chegou a ser processada. Causas:
- Mensagem está inativa sem você notar
- Filtros (gateway, categoria, status) excluíram esse pedido específico
- Status de pedido não bate com o gatilho escolhido
Reproduza o cenário e ative debug — geralmente fica claro nos logs.
Mensagens chegam mas vazias ou com {{variable}} literal
A variável usada não existe nesse gatilho ou o valor não foi preenchido no pedido. Ex: usar {{tracking_code}} num gatilho que não é de rastreio. Resultado: a variável fica em branco (mensagem vazia) ou aparece literal no texto (versões antigas).
Confira se as variáveis usadas são compatíveis com o gatilho. Veja Variáveis de mensagem.
Volume alto travando o site
Se você tem 10.000 pedidos/dia e o WhatsApp tá deixando o checkout lento, mude as mensagens pra envio assíncrono = Sim. Elas entram na fila e o checkout não fica esperando.
"Mas eu mandei isso há 2 minutos e não chegou!"
Se a mensagem é assíncrona (em fila) ou tem delay, espera o tempo correto. Testes reais demoram. Pra teste rápido, use a aba Testar ou desative o async temporariamente.
Quando pedir ajuda ao suporte
Reuniu tudo isso e ainda não achou? Mande pro suporte Rishi:
- WooCommerce → Status → Copie o relatório do sistema (botão "Get system report")
- Imagem da aba Ações agendadas (filtrada por
whatsapp-messages) - Imagem das configurações da mensagem que não está chegando
- Trecho do log (
automation-for-whatsappmais recente) — anonimize números de cliente se necessário - Descrição do que esperava acontecer e o que aconteceu
Esse pacote acelera diagnóstico em ordem de magnitude.
Próximos passos
- Mensagens agendadas e fila assíncrona — pra entender a fila do Action Scheduler
- Customização via código — pra registrar logs adicionais via filtro