Product analytics: Mixpanel, Amplitude e Segment

Envie eventos de produto do CRM (ex.: "Negócio ganho", "Lead criado") ao seu Mixpanel, Amplitude ou Segment e receba eventos de volta como atividades no Contato (modelo BYO: a conta é sua).

A integração de Product analytics usa a SUA conta do Mixpanel, Amplitude ou Segment (modelo BYO, "traga a sua própria conta"). O CRM ENVIA eventos de produto ao seu analytics (ex.: quando um negócio é ganho ou um lead é criado) e RECEBE eventos de volta, que viram atividades no Contato correspondente. Não há custo, margem nem intermediação nossa: os eventos vão direto para a sua conta e voltam dela.

A integração nasce inerte: nada acontece até você preencher as credenciais e ativar. Todos os segredos (project token, API key, write key) ficam cifrados no CRM e nunca são exibidos de volta. Cada plataforma tem o seu próprio cartão em Configurações → Integrações; a URL do webhook é única (/api/inbound/analytics/…) e o CRM sabe de qual plataforma se trata pelo token da URL.

Pré-requisitos

• Uma conta do Mixpanel, Amplitude ou Segment com acesso para ver as credenciais de ingestão.
• Mixpanel: o Project Token (Settings → Project Settings). Amplitude: a API Key do projeto (Settings → Projects). Segment: a Write Key de uma fonte HTTP API (Connections → Sources).
• Para receber eventos de volta, a capacidade de apontar um export/webhook do provedor para uma URL.
• No Sellio, ser administrador para salvar as credenciais e ativar a integração em Configurações → Integrações.

Como funciona

• Saída (CRM → provedor): cada evento é enviado com um identificador da pessoa (distinct id / user id, por padrão o e-mail do registro) e propriedades. O envio é idempotente pela chave de deduplicação do provedor: Mixpanel usa $insert_id, Amplitude usa insert_id e Segment usa messageId. Reenviar o mesmo evento não duplica.
• Entrada (provedor → CRM): quando o provedor faz POST de um evento na URL do webhook, o CRM registra uma atividade e a vincula ao Contato com o e-mail correspondente. Se o e-mail não existir no CRM, a atividade fica sem vínculo (nada se perde).
• A maneira recomendada de enviar eventos é a ação de automação "Enviar evento (analytics)" (veja abaixo). O botão "Enviar evento de teste" no cartão valida a configuração de ponta a ponta.

A ação de automação "Enviar evento (analytics)"

Em Configurações → Automações, crie ou edite uma regra e adicione a ação "Enviar evento (analytics)". Escolha o provedor (Mixpanel/Amplitude/Segment), o nome do evento (ex.: "Negócio ganho", que pode usar {{campo}} para interpolar dados do registro) e, opcionalmente, o identificador da pessoa (distinct id, cujo padrão é {{email}}). Quando a regra dispara, o evento é enviado pós-commit, best-effort. Se a integração não estiver ativa, a ação simplesmente não faz nada (gated).

Mixpanel

1. Abra Configurações → Integrações e localize o cartão "Product analytics (Mixpanel)".
2. Cole o Project Token (Mixpanel → Settings → Project Settings → Project Token) e escolha a região (UE só se o seu projeto usar a residência de dados europeia). Clique em "Salvar analytics".
3. Clique em "Ativar". Use "Enviar evento de teste" com um distinct id qualquer para confirmar.
4. Para receber eventos, aponte um webhook/export do Mixpanel para a "URL do webhook". O Mixpanel não assina os webhooks de export: a segurança é o token imprevisível da URL, então trate-a como secreta.

Amplitude

1. No CRM, localize o cartão "Product analytics (Amplitude)".
2. Cole a API Key (Amplitude → Settings → Projects → API Key) e escolha a região. Clique em "Salvar analytics" e depois em "Ativar".
3. Os eventos de saída vão para /2/httpapi. Para receber eventos, aponte um export/webhook do Amplitude para a "URL do webhook" (o Amplitude não assina: o token da URL é o guarda).

Segment

1. No CRM, localize o cartão "Product analytics (Segment)".
2. Crie uma fonte HTTP API no Segment (Connections → Sources) e cole a Write Key. Opcionalmente, defina um segredo de webhook (para exigir a assinatura na entrada). Clique em "Salvar analytics" e em "Ativar".
3. Saída: os eventos vão para /v1/track autenticados por Basic auth da write key. Entrada: crie um destino Webhook (ou uma function) no Segment apontando para a "URL do webhook". Por padrão o Segment não assina; se você definiu um segredo, o CRM verifica o header x-signature (HMAC-SHA1); senão, o token da URL é o guarda.

Trate as URLs dos webhooks e as credenciais como secretas. Se você tentar ativar sem as credenciais necessárias, a integração fica inerte: nada é enviado nem recebido até tudo estar no lugar.

Como testar

1. Saída: clique em "Enviar evento de teste" no cartão com um distinct id qualquer e confirme, no seu Mixpanel/Amplitude/Segment, que o evento chegou (Live View / Debugger).
2. Automação: crie uma regra com a ação "Enviar evento (analytics)" e dispare-a; verifique o evento no provedor.
3. Entrada: faça o provedor enviar um evento à "URL do webhook" para um e-mail que exista como Contato e confira a atividade no Contato.

Solução de problemas

• Erro 401/evento não aparece: credencial errada. Mixpanel → Project Token; Amplitude → API Key; Segment → Write Key (autenticada por Basic auth). Recole a credencial correta.
• Região errada: se o seu projeto usa residência de dados na UE, marque a região UE; senão os eventos vão para o endpoint errado e não aparecem.
• A automação não envia: a ação "Enviar evento (analytics)" é gated: se a integração não estiver ativa, ela não faz nada. Ative a integração e confirme o provedor selecionado na ação.
• Entrada não vira atividade: se o e-mail do evento não existe no CRM, a atividade fica sem vínculo (nada se perde). Segment: se você definiu um segredo, valide o header x-signature (HMAC-SHA1).
• 404 na URL do webhook: integração desativada ou token trocado. Reative e recopie a URL.

Abrir este artigo dentro do sistema →