clientflow_backend/docs/CLIENTFLOW_V466_SAFE_OPPORTUNITY_LINKING.md

ClientFlow v4.6.6 — Safe Opportunity Linking

Objetivo: reduzir o risco de associar automaticamente uma mensagem/task do Chatwoot à oportunidade ou cliente fiscal errado.

Alterações principais

• conversation_id passa a ser a correspondência forte para associar task a oportunidade.
• contact_id do Chatwoot passa a ser correspondência fraca: só associa automaticamente se existir exatamente uma oportunidade aberta recente para esse contacto.
• Se houver mais de uma oportunidade aberta recente para o mesmo contact_id, a task é marcada para revisão de associação e não é criada/atualizada uma nova oportunidade automaticamente.
• A página de detalhe da task deixa de usar contact_id do Chatwoot como se fosse ID local de cliente.
• O link “Ver cliente” passa a aparecer apenas quando existe cliente fiscal local seguro.
• No Centro de trabalho, uma associação ambígua aparece como ação humana: “Associar oportunidade”.

Regra operacional

Chatwoot contact_id identifica o contacto/conversa, não necessariamente o cliente fiscal. O cliente fiscal continua a ser confirmado na oportunidade antes de orçamento/fatura/envio.