Pular para o conteúdo

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.

Antes de mergulhar no troubleshooting, confirme que a mensagem realmente não chegou:

  1. 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.
  2. Verifique status do contato — se está bloqueado, mensagens dele não aparecem em nenhum filtro.
  3. 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”).
  4. Pergunte horário exato da mensagem perdida. Útil para procurar nos logs.

Mensagens não chegam: Config. → Pessoas & Canais → Caixas de Entrada, o resumo no topo (caixas, Conectada, Precisa de você, paradas), os filtros "Todas", "Precisam de atenção" e "Paradas" e a lista de caixas com o status de cada uma

Como verificar:

  1. Config. → Pessoas & Canais → Caixas de Entrada → veja status do inbox. O filtro Precisam de atenção mostra só as que têm problema.
  2. 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.).

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:

  1. Em Config. → Caixas de Entrada → seu inbox WhatsApp Cloud → aba Configuração.
  2. Copie a URL do webhook e o Token de verificação Webhook.
  3. Na Meta Business Suite: WhatsApp → Configuração → Webhooks.
  4. Verifique se URL está correta.
  5. Verifique se eventos messages, message_status estão inscritos.
  6. Se necessário, remova e recadastre o webhook.

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.

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çãoO que parece
Resolver conversaA conversa nasce e já sai da lista de abertas
Marcar como pendenteSai do que espera resposta
Adiar conversaSome até a data
Silenciar conversaChega sem avisar ninguém
Atribuir equipe ou agenteFoi 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.

Sintoma: mensagem realmente chegou, mas você não está vendo por causa do filtro aplicado.

Como verificar:

  1. Na lista de conversas, mude o filtro para Todas + status Em aberto + Pendente.
  2. 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.

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.

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.

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).

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.

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:

  1. Recarregue o painel (F5).
  2. Se a mensagem aparecer, o problema é WebSocket no seu lado.
  3. Verifique com TI da sua empresa se wss://app.smart2.com.br está 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).

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

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.

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”.

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:

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”.