Conversas no Syncro têm vínculo opcional com um lead (registro no CRM). Sem vínculo, a conversa existe só no chat — não aparece no kanban, não conta em métricas, não dispara automações de funil. Com vínculo, a conversa fica conectada ao lead, e tudo que rola no chat alimenta o histórico do lead (timeline, scoring, automações).
A maioria das conversas é vinculada automaticamente — quando alguém manda WhatsApp/Instagram pela primeira vez, o Syncro cria lead novo e já vincula. Mas há casos onde você precisa vincular manualmente ou trocar o vínculo depois.
Pré-requisitos
- Permissão de admin ou manager.
- Conversa aberta no
/chats.
Vínculo automático ao receber mensagem
Por padrão, quando uma conversa nova chega:
- Sistema verifica se já existe lead com aquele telefone/email/username.
- Se existe: vincula a conversa nova ao lead existente.
- Se não existe: cria lead novo e vincula automaticamente.
Pra desligar isso, vá no pipeline e desmarque toggle de auto-criação. Veja Auto-criar leads.
Conversas sem lead vinculado
Algumas situações criam conversa sem lead:
- Auto-criação foi desligada nas configurações.
- Plano atingiu limite de leads (não dá pra criar novo).
- Bug histórico raro.
Quando isso acontece, no painel lateral aparece: "Sem lead vinculado" com botões pra resolver.
Vincular a um lead existente
Se o cliente já é seu lead (de outra interação, importação, formulário) e a conversa atual ainda não tá ligada:
- No painel lateral da conversa, clique em Vincular lead existente.
- Modal abre com campo de busca: "Buscar por nome ou telefone...".
- Digite o nome / telefone / email do lead.
- Lista de leads correspondentes aparece.
- Clique no lead correto.
- Aparece o feedback Lead "{nome}" vinculado!.
- O painel lateral atualiza com dados do lead, pipeline, etapa, etc.
Criar lead novo a partir do chat
Se o cliente é totalmente novo e a conversa caiu sem vínculo:
- No painel lateral, clique em Criar lead na pipeline.
- Modal abre com:
- Pipeline (obrigatório): selecione qual funil.
- Etapa (obrigatório): muda conforme o funil.
- Nome do contato (pré-preenchido com o nome do contato do chat se disponível).
- Telefone (pré-preenchido com o número da conversa).
- Confirme.
- Sistema:
- Cria o lead no funil/etapa selecionados.
- Vincula automaticamente à conversa atual.
- Aparece feedback Lead criado e vinculado!.
Detecção de duplicatas ao criar
Quando você cria lead pelo chat, o sistema automaticamente detecta se há leads duplicados (por telefone/email):
- Antes de criar, busca por leads similares.
- Se encontra com score alto (≥70):
- Em vez de criar duplicata, vincula a conversa ao lead existente automaticamente.
- Aparece toast informativo: "Lead 'X' já existe. Conversa vinculada ao existente.".
- Se score baixo:
- Cria lead novo normalmente.
- Pode aparecer aviso "Possível duplicata encontrada" (você decide).
Veja Detectar duplicatas.
Ver lead vinculado
Quando há lead vinculado, o painel lateral mostra:
- Nome do lead
- Empresa (se houver)
- Telefone / email
- Pipeline e Etapa atual
- Tags do lead
- Valor potencial da venda
- Botões:
- Ver perfil → abre
/contatos/{id}/perfil(página detalhada do lead) - Desvincular (remove vínculo)
Desvincular lead da conversa
Pra remover o vínculo sem apagar o lead:
- No painel lateral, clique em Desvincular (ou ícone X ao lado do nome).
- Confirmação: "Desvincular este lead da conversa?".
- Confirme.
- Aparece feedback Lead desvinculado..
- A conversa volta a ficar sem lead (
lead_id=null).
⚠️ Atenção: o lead em si NÃO é apagado — continua existindo no CRM. Só o vínculo entre conversa e lead foi desfeito. Pra apagar o lead, vá em Contatos.
Trocar lead vinculado
Pra mudar pra outro lead (ex: vinculou ao errado, ou descobriu que é o mesmo lead de outra conversa):
- Clique em Desvincular primeiro.
- Depois clique em Vincular lead existente e busque o correto.
- Confirme.
Não há "trocar direto" em 1 clique — sempre desvincular antes.
Conversa vinculada a lead que tem outras conversas
Um mesmo lead pode ter múltiplas conversas vinculadas (uma no WhatsApp, outra no Instagram, outra no site). Isso é normal e desejável — você atende a mesma pessoa em vários canais e tudo agrega no mesmo lead.
Exemplo
Maria Silva é seu lead. Ela:
- Mandou WhatsApp em janeiro → conversa A vinculada a Maria.
- Curtiu post no Instagram em fevereiro → conversa B vinculada a Maria.
- Voltou a mandar WhatsApp em abril → conversa C vinculada a Maria.
Todas as 3 conversas aparecem no perfil da Maria, e cada interação alimenta a timeline dela.
O que acontece quando o lead é apagado
Se você apaga (ou arquiva) o lead vinculado:
- Conversa fica órfã (
lead_idvira null se cascade ON DELETE SET NULL). - Mensagens continuam visíveis — não são apagadas junto.
- Pra evitar perda de contexto, desvincule antes de apagar se quiser preservar o lead em outra forma.
Source automático ao criar lead pelo chat
Quando você cria lead novo pelo chat, o source é definido automaticamente:
- Conversa WhatsApp →
source = whatsapp - Conversa Instagram →
source = instagram - Conversa Site →
source = site
Isso ajuda a rastrear de onde os leads vieram.
Lead vinculado em conversa de QR Code com lid
Em alguns casos (WhatsApp via QR Code com engine GOWS), o número aparece como @lid em vez do telefone normal. O Syncro tenta resolver o número real automaticamente. Quando consegue:
- O lead é criado/vinculado com o telefone normal.
- A conversa preserva o
lidpra envio funcionar corretamente.
Quando não consegue resolver o LID:
- A conversa pode ficar bloqueada de criar lead (sistema avisa).
- Pra ver mais detalhes, veja troubleshooting no setup do WhatsApp.
Auto-vínculo via API ou automação
Você pode vincular leads programaticamente:
- Via automação: ação que vincula lead específico à conversa.
- Via API REST v1: endpoint
PUT /chats/conversations/{id}/link-lead.
Veja Automações e API.
Limites de plano
Criar lead pelo chat respeita o limite de leads do plano:
- Se atingiu limite, o botão Criar lead na pipeline falha com mensagem "Limite atingido".
- Solução: faça upgrade ou apague leads antigos.
Veja Fazer upgrade.
Próximos passos
- Pra entender o fluxo completo do funil, veja Auto-criar leads.
- Pra mesclar leads duplicados, veja Duplicatas.