Product analytics: Mixpanel, Amplitude e Segment
Invia eventi di prodotto dal CRM (ad es. "Trattativa vinta", "Lead creato") a Mixpanel, Amplitude o Segment e ricevi eventi in ritorno come attività sul Contatto (modello BYO, quindi l'account è tuo).
L'integrazione Product analytics usa IL TUO account Mixpanel, Amplitude o Segment (modello BYO, "bring your own account"). Il CRM INVIA eventi di prodotto ai tuoi analytics (ad esempio quando una trattativa viene vinta o un lead viene creato) e RICEVE eventi in ritorno, che diventano attività sul Contatto corrispondente. Non c'è costo, margine o intermediazione da parte nostra: gli eventi vanno direttamente al tuo account e tornano da esso.
L'integrazione parte inerte: non succede nulla finché non inserisci le credenziali e attivi. Tutti i segreti (project token, API key, write key) sono memorizzati cifrati nel CRM e non vengono mai mostrati di nuovo. Ogni piattaforma ha la propria scheda in Impostazioni → Integrazioni; l'URL del webhook è univoco (/api/inbound/analytics/…) e il CRM riconosce la piattaforma dal token nell'URL.
Prerequisiti
- Un account Mixpanel, Amplitude o Segment con accesso per visualizzare le credenziali di ingestione.
- Mixpanel: il Project Token (Settings → Project Settings). Amplitude: l'API Key del progetto (Settings → Projects). Segment: la Write Key di una source HTTP API (Connections → Sources).
- Per ricevere eventi in ritorno, la possibilità di puntare un export/webhook del provider a un URL.
- In Sellio, accesso da amministratore per salvare le credenziali e attivare l'integrazione in Impostazioni → Integrazioni.
Come funziona
- In uscita (CRM → provider): ogni evento viene inviato con un identificativo della persona (distinct id / user id, di default l'email del record) e delle proprietà. L'invio è idempotente tramite la chiave di dedup del provider: Mixpanel usa $insert_id, Amplitude usa insert_id e Segment usa messageId, quindi rinviare lo stesso evento non lo duplica.
- In entrata (provider → CRM): quando il provider invia un evento in POST all'URL del webhook, il CRM registra un'attività e la collega al Contatto con l'email corrispondente. Se l'email non esiste nel CRM, l'attività resta scollegata (nulla va perso).
- Il modo consigliato per inviare eventi è l'azione di automazione "Invia evento (analytics)" (vedi sotto). Il pulsante "Invia evento di test" sulla scheda convalida la configurazione dall'inizio alla fine.
L'azione di automazione "Invia evento (analytics)"
In Impostazioni → Automazioni, crea o modifica una regola e aggiungi l'azione "Invia evento (analytics)". Scegli il provider (Mixpanel/Amplitude/Segment), il nome dell'evento (ad es. "Deal won"; puoi usare {{campo}} per interpolare i dati del record) e, opzionalmente, l'identificativo della persona (distinct id, che di default è {{email}}). Quando la regola scatta, l'evento viene inviato dopo il commit, in modalità best-effort. Se l'integrazione non è attiva, l'azione semplicemente non fa nulla (gated).
Mixpanel
- Apri Impostazioni → Integrazioni e trova la scheda "Analisi prodotto (Mixpanel)".
- Incolla il Project Token (Mixpanel → Settings → Project Settings → Project Token) e scegli la regione (solo EU se il tuo progetto usa la residenza dati europea). Clicca "Salva analytics".
- Clicca "Attiva". Usa "Invia evento di test" con un distinct id qualsiasi per confermare.
- Per ricevere eventi, punta un webhook/export di Mixpanel all'"URL webhook". Mixpanel non firma i webhook di export: la sicurezza è affidata al token imprevedibile nell'URL, quindi trattalo come segreto.
Amplitude
- Nel CRM, trova la scheda "Analisi prodotto (Amplitude)".
- Incolla l'API Key (Amplitude → Settings → Projects → API Key) e scegli la regione. Clicca "Salva analytics" e poi "Attiva".
- Gli eventi in uscita vanno a /2/httpapi. Per ricevere eventi, punta un export/webhook di Amplitude all'"URL webhook" (Amplitude non firma: il token nell'URL è la protezione).
Segment
- Nel CRM, trova la scheda "Analisi prodotto (Segment)".
- Crea una source HTTP API in Segment (Connections → Sources) e incolla la Write Key. Facoltativamente, imposta un segreto per il webhook (per richiedere la firma in entrata). Clicca "Salva analytics" e "Attiva".
- In uscita: gli eventi vanno a /v1/track autenticati tramite Basic auth della write key. In entrata: crea una destinazione Webhook (o una function) in Segment che punti all'"URL webhook". Per impostazione predefinita Segment non firma; se imposti un segreto, il CRM verifica l'header x-signature (HMAC-SHA1); altrimenti, il token nell'URL è la protezione.
Tratta gli URL dei webhook e le credenziali come segreti. Se provi ad attivare senza le credenziali necessarie, l'integrazione resta inerte, e nulla viene inviato o ricevuto finché tutto non è a posto.
Come testare
- In uscita: clicca "Invia evento di test" sulla scheda con un distinct id qualsiasi e conferma, nel tuo Mixpanel/Amplitude/Segment, che l'evento sia arrivato (Live View / Debugger).
- Automazione: crea una regola con l'azione "Invia evento (analytics)" e attivala; verifica l'evento presso il provider.
- In entrata: fai inviare al provider un evento all'"URL webhook" per un'email che esiste come Contatto e verifica l'attività sul Contatto.
Risoluzione dei problemi
- Errore 401/l'evento non appare: credenziale sbagliata. Mixpanel → Project Token; Amplitude → API Key; Segment → Write Key (autenticata tramite Basic auth). Incolla di nuovo la credenziale corretta.
- Regione sbagliata: se il tuo progetto usa la residenza dati EU, seleziona la regione EU. Altrimenti gli eventi vanno all'endpoint sbagliato e non appaiono.
- L'automazione non invia: l'azione "Invia evento (analytics)" è gated: se l'integrazione non è attiva, non fa nulla. Attiva l'integrazione e conferma il provider selezionato nell'azione.
- In entrata non diventa un'attività: se l'email dell'evento non esiste nel CRM, l'attività resta scollegata (nulla va perso). Segment: se hai impostato un segreto, convalida l'header x-signature (HMAC-SHA1).
- 404 sull'URL del webhook: integrazione disattivata o token cambiato. Riattiva e ricopia l'URL.