Responder citando mensagem (quote/reply)

Quando o cliente responde citando uma mensagem específica (recurso comum no WhatsApp e Instagram), o Syncro renderiza a citação visualmente acima da bolha da resposta — mesmo formato que aparece pro cliente. Isso preserva o contexto da conversa e ajuda você a entender exatamente sobre o que ele tá falando.

O que é quote/reply

No WhatsApp / Instagram, ao responder uma mensagem específica, o app gera uma "citação": um pequeno bloco com preview da mensagem original aparece grudado em cima da resposta. Permite que conversas complexas com várias linhas paralelas fiquem organizadas — você sabe exatamente sobre qual mensagem o outro está respondendo.

No Syncro, essa citação é renderizada idêntica ao que aparece no app do cliente.

Como aparece visualmente

Quando uma mensagem citada aparece na thread do /chats:

• Bloco cinza pequeno acima da bolha da mensagem.
• Mostra:
• Nome do autor da mensagem original (truncado).
• Preview do conteúdo:
• Texto: até 120 caracteres + "…"
• Imagem: thumbnail pequeno
• Vídeo: thumbnail com play
• Áudio: ícone 🎵 + label "🎵 Áudio"
• Documento: ícone 📎 + label "📎 Arquivo"
• Cor do bloco varia (verde claro pra outbound, branco pra inbound).

Click pra ir até a mensagem original

A citação é clicável:

1. Clique no bloco da citação.
2. A thread scrolla automaticamente até a mensagem original.
3. A mensagem original recebe destaque visual (animação pulse de 1.5 segundos) pra você identificar.

💡 Dica: se a mensagem original é muito antiga e não está carregada na thread atual, aparece um toast informando "Mensagem fora do histórico carregado". Role pra cima primeiro pra carregar mensagens antigas.

Citações aparecem nos 2 sentidos

Cliente cita você

• Cliente seleciona uma mensagem sua.
• Responde com citação.
• No Syncro, você vê a resposta dele com o bloco da sua mensagem original acima.

Você cita cliente (limitado)

Hoje no Syncro a UI não permite enviar resposta com citação direta (você ainda não consegue clicar numa mensagem do cliente e selecionar "Responder citando"). Quando você responder, vai como mensagem nova sem citação automática.

Pra contornar, mencione o que está respondendo no texto:

• "Sobre o que você perguntou às 14h:..."
• "Voltando à proposta de R$ X..."

Esse recurso de outbound quote está em roadmap mas ainda não disponível.

Tipos de mídia preservados na citação

Quando o cliente cita uma mensagem com mídia, o Syncro preserva o tipo:

Snapshot — dados imutáveis

A citação no Syncro é construída a partir de um snapshot JSON salvo no momento que a mensagem chega. Isso significa:

• A citação não consulta a mensagem original em tempo real.
• Mesmo se a mensagem original for deletada pelo cliente depois, a citação continua mostrando o conteúdo (snapshot preservado).
• Performance otimizada — sem queries adicionais ao renderizar a thread.

O snapshot armazena:

{
 "body": "Texto da msg original",
 "type": "text",
 "sender_name": "João Silva",
 "direction": "inbound",
 "media_mime": "image/jpeg",
 "media_url": "https://..."
}

Suporte por canal

WhatsApp via QR Code (QR Code)

• ✅ Suporta — citações chegam normalmente via QR Code com replyTo field.

WhatsApp Cloud API

• ✅ Suporta — citações chegam via context.id no webhook da Meta.

Instagram

• ⚠️ Suporte parcial — depende do tipo de mensagem original (story mention é caso à parte).

Site / Webchat

• Geralmente não suporta quote nativo (depende da implementação do widget).

Citações em mensagens forwarded (encaminhadas)

Mensagens encaminhadas (forward) podem ou não preservar a citação original — depende do canal:

• WhatsApp: forwards costumam perder a citação (vira mensagem nova).
• Instagram: similar.

Se o cliente faz forward de uma mensagem citada, você pode receber só o conteúdo final sem o contexto. Use a citação textual quando viável.

Não há "responder citando" pelo Syncro hoje

Limitação importante: hoje você só vê citações que chegam (inbound) — não consegue enviar respostas citando mensagens específicas pelo Syncro. Pra responder citando:

• Use o app do WhatsApp/Instagram no celular pra essa interação específica.
• No Syncro, mande mensagem normal mencionando textualmente o que está respondendo.

Esse recurso está em roadmap. Acompanhe novidades nas notas de versão.

Citações em conversas com IA / Chatbot

Se uma conversa tem agente IA atendendo:

• A IA vê o contexto da citação quando processa a mensagem.
• Ela pode reagir levando em conta o que o cliente citou.
• Se a IA responder citando, depende da implementação do agente — geralmente sai como texto normal.

Histórico antigo — citação perde detalhe

Mensagens muito antigas (antes da feature de quote ter sido implementada) podem não ter o snapshot completo. A citação aparece com placeholder "Mensagem original indisponível".

Mensagens enviadas/recebidas após o release do quote (commit da156c2 em 2026-04-29) preservam corretamente.

Erros comuns

"Citação aparece sem nome do autor"

Pode acontecer se:

• Mensagem original veio de contato sem nome cadastrado.
• Snapshot foi gerado em versão antiga do parser.

A citação ainda funciona (texto + click), mas o nome aparece genérico ou vazio.

"Citação aparece com texto cortado em 120 chars"

Comportamento intencional — preview da citação é truncada pra não ocupar muito espaço visual. Pra ver a mensagem completa, clique na citação e vá até a original.

"Click na citação não funciona"

Pode ser:

• Mensagem original não está na thread carregada (role pra cima pra carregar histórico antigo).
• Mensagem original foi deletada do banco (raro).
• Bug de renderização — atualize a página.

Próximos passos

• Pra entender envio de mídia em geral, veja Enviar mídia.
• Pra fluxo geral do chat, veja Caixa unificada.

Artigos relacionados

• Caixa unificada — visão geral
• Enviar mídia
• Mensagens rápidas