Como o Lead Conversions liga lead e venda

"Quantos leads de agosto fecharam em agosto?" é uma pergunta que não se responde chamando API: são dezenas de milhares de contatos no Talk, centenas de milhares de vendas na fonte e, muitas vezes, um CRM antigo no meio. O módulo espelha tudo em duas tabelas locais, num formato só, e a pergunta passa a ser uma consulta de um segundo.

Conceitos

Lead (entrada) é a primeira conversa de um contato no Talk. As conversas seguintes da mesma pessoa são toques, não leads novos.

Venda é um registro vindo de uma fonte: ERP, painel ou planilha.

Venda atribuída é a venda cuja pessoa tem um lead no Talk. É ela que entra no cálculo da taxa de conversão.

Sem lead é a venda que não encontrou ninguém. Ela não desaparece: fica no painel, em "Qualidade do cruzamento", porque é justamente a parte que mais diz sobre o estado do cadastro.

Consultor da venda é quem atendeu o lead no Talk, na primeira conversa. O vendedor que a fonte registrou aparece ao lado, para comparação.

Canal e caixa: o canal é WhatsApp, Instagram, Facebook ou Site; a caixa é a sub-trilha dentro dele — cada número de WhatsApp, cada conta de Instagram.

As três chaves

O encontro entre lead e venda é tentado nesta ordem:

1. CPF ou CNPJ, só dígitos. No Talk fica em contact.identifier.
2. Telefone, com e sem o nono dígito. Não é chave reserva: metade dos leads não tem CPF.
3. E-mail.

Quando encontra, o módulo enriquece o cadastro: a pessoa que só tinha telefone ganha o CPF que veio da venda. A venda seguinte dela, mesmo chegando só com CPF, encontra o lead.

Segurança

O módulo é visível apenas para administradores da conta. Credenciais de banco e API ficam criptografadas e não voltam para a tela. O SQL aceita apenas SELECT e WITH, em transação somente leitura, com teto de 30 segundos. Blocos de código rodam em sandbox sem rede e sem acesso a arquivo. Endereços de rede interna são bloqueados por padrão.