Mensagens não chegam
Sintoma: cliente confirma que enviou mensagem mas ela não aparece no app.smart. Esta página apresenta o checklist completo de diagnóstico — do mais provável ao mais raro — para identificar onde a mensagem está sendo perdida.
Importante: confirme o sintoma primeiro
Seção intitulada “Importante: confirme o sintoma primeiro”Antes de mergulhar no troubleshooting, confirme que a mensagem realmente não chegou:
- Busque pelo número ou nome em Conversas, na aba Todos — não só na Fila. A conversa pode já ter sido atribuída a alguém.
- Verifique status do contato — se está bloqueado, mensagens dele não aparecem em nenhum filtro.
- Confirme com o cliente o número/email exato usado para enviar. Erros aqui são comuns (“eu mandei pra esse outro número que vocês têm”).
- Pergunte horário exato da mensagem perdida. Útil para procurar nos logs.
Causas em ordem de probabilidade
Seção intitulada “Causas em ordem de probabilidade”1. A caixa caiu (a causa mais comum de longe)
Seção intitulada “1. A caixa caiu (a causa mais comum de longe)”
Como verificar:
- Config. → Pessoas & Canais → Caixas de Entrada → veja status do inbox. O filtro Precisam de atenção mostra só as que têm problema.
- Se Desconectado ou erro, mensagens não estão sendo capturadas.
Solução: veja WhatsApp desconectou ou troubleshooting do canal específico (Email, Instagram, etc.).
2. Webhook desconfigurado
Seção intitulada “2. Webhook desconfigurado”Sintoma específico: envio funciona, recebimento falha. Status do inbox aparece OK.
Causa: webhook da Meta foi removido, expirou, ou aponta para URL errada.
Solução:
- Em Config. → Caixas de Entrada → seu inbox WhatsApp Cloud → aba Configuração.
- Copie a URL do webhook e o Token de verificação Webhook.
- Na Meta Business Suite: WhatsApp → Configuração → Webhooks.
- Verifique se URL está correta.
- Verifique se eventos
messages,message_statusestão inscritos. - Se necessário, remova e recadastre o webhook.
3. Contato bloqueado
Seção intitulada “3. Contato bloqueado”Sintoma: mensagens de um cliente específico não chegam, mas de outros sim.
Como verificar: abra o contato. No painel, a ação de bloqueio aparece como Desbloquear Contato quando ele está bloqueado.
Solução: desbloqueie. As próximas mensagens passam.
4. Workflow filtrando ou descartando
Seção intitulada “4. Workflow filtrando ou descartando”Sintoma: mensagens não aparecem mas você não bloqueou ninguém intencionalmente.
Causa: um workflow de conversa está mexendo na conversa assim que ela nasce, e ela some da sua vista.
Não existe ação de “descartar mensagem”. O que existe, e produz o mesmo efeito prático:
| Ação | O que parece |
|---|---|
| Resolver conversa | A conversa nasce e já sai da lista de abertas |
| Marcar como pendente | Sai do que espera resposta |
| Adiar conversa | Some até a data |
| Silenciar conversa | Chega sem avisar ninguém |
| Atribuir equipe ou agente | Foi para a fila de outra pessoa |
Como verificar: em Config. → Automação → Workflows, olhe os ativos com gatilho de conversa criada ou mensagem recebida e veja o que eles fazem. Depois abra a conversa “sumida” — as linhas do sistema dentro dela contam o que aconteceu.
Solução: desative o suspeito e mande uma mensagem de teste.
5. Filtro errado na lista
Seção intitulada “5. Filtro errado na lista”Sintoma: mensagem realmente chegou, mas você não está vendo por causa do filtro aplicado.
Como verificar:
- Na lista de conversas, mude o filtro para Todas + status Em aberto + Pendente.
- Veja se a conversa aparece agora.
Causas comuns de filtro problemático:
- Filtro Minhas + conversa atribuída a outro agente
- Filtro inbox X + conversa veio em inbox Y
- Custom view com critério restritivo demais
Solução: ajuste filtros ou aplique filtros avançados corretamente.
6. Conversa em outro inbox
Seção intitulada “6. Conversa em outro inbox”Sintoma: cliente disse que mandou em WhatsApp, você procura em WhatsApp Vendas mas não acha.
Causa: cliente mandou em WhatsApp Suporte (outro inbox seu), ou em Instagram (você nem lembrou).
Solução: busque pelo contato (Ctrl + K), não pelo inbox. Resultado mostra conversas de todos os canais.
7. SPAM / spam detectado pelo canal
Seção intitulada “7. SPAM / spam detectado pelo canal”Sintoma: mensagens de email não chegam.
Causa: servidor de email do app.smart marcou como spam ou rejeitou (politica de SPF/DKIM do remetente).
Solução:
Não há pasta de spam nem lista de remetentes liberados na caixa de e-mail do app.smart. Peça ao remetente para conferir o SPF/DKIM do domínio dele e, se continuar, fale com a gente.
8. Cliente enviou em formato não suportado
Seção intitulada “8. Cliente enviou em formato não suportado”Sintoma: mensagem específica (vídeo, sticker, mensagem de áudio longo) não aparece, outras do mesmo cliente sim.
Causa: formato não suportado pelo canal ou pelo app.smart.
Limites:
- WhatsApp: vídeo até 16MB
- Instagram: sem áudios, sem documentos
- Web Widget: anexo até 40MB
Solução: peça ao cliente para reenviar em formato mais simples (foto em vez de vídeo, texto em vez de sticker).
Quando nada acima encaixa
Seção intitulada “Quando nada acima encaixa”Não existe tela de log por caixa. O que você tem para separar “não chegou” de “chegou e sumiu”:
A conversa existe? Procure o contato na busca, sem filtro de status. Se a conversa está lá, a mensagem chegou — o problema é de visibilidade, filtro ou automação, e não de canal.
Outras caixas estão recebendo? Se só uma parou, é dela. Se todas pararam, é infraestrutura.
O painel de saúde diz algo? Em Config. → Pessoas & Canais → Caixas de Entrada, o filtro Precisam de atenção mostra as caixas fora do ar agora, e Paradas as que estão fora do ar sem movimento há 30 dias ou mais. Caixa conectada que parou de receber aparece como Conectada — ali a lista não ajuda, e vale olhar a data da última conversa.
Se a conversa não existe em lugar nenhum e a caixa aparece conectada, aí é caso de chamado.
Caso especial: mensagens chegam com delay
Seção intitulada “Caso especial: mensagens chegam com delay”Sintoma: mensagens chegam, mas com 5-30 minutos de atraso.
Causas:
- WebSocket bloqueado pela rede corporativa do agente (mensagem chega no banco mas painel não atualiza tempo real)
- Fila Sidekiq sobrecarregada (raro)
- Latência do canal (Instagram tem fama de delay)
Solução:
- Recarregue o painel (
F5). - Se a mensagem aparecer, o problema é WebSocket no seu lado.
- Verifique com TI da sua empresa se
wss://app.smart2.com.brestá liberado.
Caso especial: cliente vê “entregue” (✓✓) mas você não recebeu
Seção intitulada “Caso especial: cliente vê “entregue” (✓✓) mas você não recebeu”No WhatsApp, “entregue” significa entregue ao servidor Meta, não necessariamente ao app.smart.
Causa típica: webhook desconfigurado ou inbox desconectado depois da entrega à Meta.
Solução: mesma da causa #2 (Webhook desconfigurado).
Quando escalar para suporte
Seção intitulada “Quando escalar para suporte”Abra ticket se:
- Mensagens de todos os inboxes estão atrasadas (>5 min)
- Logs mostram mensagem recebida mas conversa não aparece no painel
- Múltiplos clientes reclamam simultaneamente (não é problema isolado)
- Já fez todos os checks acima
Inclua no ticket:
- ID do inbox afetado
- Número/email do cliente que reclamou
- Horário da mensagem perdida (do lado do cliente)
- Resultado do diagnóstico via logs
Prevenção
Seção intitulada “Prevenção”Olhe o painel de saúde
Seção intitulada “Olhe o painel de saúde”Não há monitoramento automático com mensagem de teste. O que existe, e resolve bem, é a própria lista de caixas em Config. → Pessoas & Canais → Caixas de Entrada, com os filtros Precisam de atenção e Paradas.
Uma olhada por dia, de manhã, custa dez segundos e pega quase tudo antes do cliente.
No WhatsApp Web, ligue também a reconexão automática nas configurações avançadas da caixa: o sistema detecta sozinho a caixa que parou de receber e refaz a conexão. Veja WhatsApp desconectou.
Comunicar status
Seção intitulada “Comunicar status”Em incidentes confirmados (canal externo caiu), comunique proativamente:
- Mensagem fixada em redes sociais
- Aviso no site
- Notificação em outros canais ativos
Evita acúmulo de clientes reclamando “vocês sumiram”.
Dúvidas comuns
Seção intitulada “Dúvidas comuns”Mensagens perdidas durante incidente podem ser recuperadas? Depende. WhatsApp guarda mensagens por algumas horas para tentar entregar de novo quando o webhook voltar. Após esse período, mensagem é descartada — cliente precisa reenviar.
Como saber se o problema é meu ou do provedor (Meta, Instagram)? Verifique status público dos provedores:
- Meta: status.meta.com
- Instagram: instagram-status.com
Se há incidente reportado, problema é deles. Aguarde resolução.
Posso ter mensagens chegando duplicadas? Raramente. Quando o canal reconecta depois de uma queda, ele pode reenviar mensagens, e alguma pode aparecer 2x.
Por que a mensagem chegou pra um colega e não pra mim? Provavelmente conversa foi auto-atribuída a ele. Você não recebe notificação de conversa atribuída a outro agente. Veja a conversa no filtro Todas.
Cliente enviou várias mensagens, só a última chegou. Por quê? Possível agrupamento do WhatsApp (mensagens muito próximas viram uma entrega). Geralmente não há perda de conteúdo — todas vão na mesma “thread”.