Setup

Product analytics : Mixpanel, Amplitude et Segment

Envoyez des événements produit depuis le CRM (ex. « Deal gagné », « Lead créé ») vers votre Mixpanel, Amplitude ou Segment et recevez des événements en retour sous forme d'activités sur le Contact (modèle BYO, le compte vous appartient).

L'intégration Product analytics utilise VOTRE compte Mixpanel, Amplitude ou Segment (modèle BYO : vous apportez votre propre compte). Le CRM ENVOIE des événements produit vers votre outil d'analytics (par exemple lorsqu'un deal est gagné ou qu'un lead est créé) et EN REÇOIT en retour, qui deviennent des activités sur le Contact correspondant. Il n'y a aucun coût, marge ou intermédiation de notre part : les événements vont directement vers votre compte et en reviennent.

L'intégration démarre inerte : rien ne se passe tant que vous n'avez pas renseigné les identifiants et activé la connexion. Tous les secrets (project token, API key, write key) sont stockés chiffrés dans le CRM et ne sont jamais réaffichés. Chaque plateforme a sa propre carte dans Paramètres → Intégrations ; l'URL de webhook est unique (/api/inbound/analytics/…) et le CRM sait de quelle plateforme il s'agit grâce au jeton présent dans l'URL.

Prérequis

Un compte Mixpanel, Amplitude ou Segment avec accès pour consulter les identifiants d'ingestion.
Mixpanel : le Project Token (Settings → Project Settings). Amplitude : l'API Key du projet (Settings → Projects). Segment : la Write Key d'une source HTTP API (Connections → Sources).
Pour recevoir des événements en retour, la possibilité de pointer un export/webhook du fournisseur vers une URL.
Dans Sellio, un accès administrateur pour enregistrer les identifiants et activer l'intégration dans Paramètres → Intégrations.

Comment ça marche

Sortant (CRM → fournisseur) : chaque événement est envoyé avec un identifiant de personne (distinct id / user id, l'email de l'enregistrement par défaut) et des propriétés. L'envoi est idempotent grâce à la clé de dédoublonnage du fournisseur : Mixpanel utilise $insert_id, Amplitude utilise insert_id et Segment utilise messageId, donc renvoyer le même événement ne le duplique pas.
Entrant (fournisseur → CRM) : lorsque le fournisseur envoie un événement en POST vers l'URL du webhook, le CRM enregistre une activité et la relie au Contact ayant l'email correspondant. Si l'email n'existe pas dans le CRM, l'activité reste non liée (rien n'est perdu).
La méthode recommandée pour envoyer des événements est l'action d'automatisation « Envoyer un événement (analytics) » (voir ci-dessous). Le bouton « Envoyer un événement test » sur la carte valide la configuration de bout en bout.

L'action d'automatisation « Envoyer un événement (analytics) »

Dans Paramètres → Automatisations, créez ou modifiez une règle et ajoutez l'action « Envoyer un événement (analytics) ». Choisissez le fournisseur (Mixpanel/Amplitude/Segment), le nom de l'événement (par ex. « Deal gagné » ; vous pouvez utiliser {{champ}} pour interpoler les données de l'enregistrement) et, en option, l'identifiant de la personne (distinct id, qui vaut par défaut {{email}}). Quand la règle se déclenche, l'événement est envoyé après validation, en best-effort. Si l'intégration n'est pas active, l'action ne fait simplement rien (gated).

💡 Exemple : une règle sur l'Opportunité avec la condition « Étape = Gagné » et l'action « Envoyer un événement (analytics) » avec l'événement « Deal Won » alimente vos entonnoirs dans Mixpanel/Amplitude à chaque deal conclu.

Mixpanel

Ouvrez Paramètres → Intégrations et trouvez la carte « Product analytics (Mixpanel) ».
Collez le Project Token (Mixpanel → Settings → Project Settings → Project Token) et choisissez la région (EU uniquement si votre projet utilise la résidence des données européenne). Cliquez sur « Enregistrer analytics ».
Cliquez sur « Activer ». Utilisez « Envoyer un événement test » avec un distinct id quelconque pour confirmer.
Pour recevoir des événements, pointez un webhook/export Mixpanel vers l'« URL du webhook ». Mixpanel ne signe pas les webhooks d'export : la sécurité repose sur le jeton imprévisible de l'URL, traitez-le donc comme un secret.

Amplitude

Dans le CRM, trouvez la carte « Product analytics (Amplitude) ».
Collez l'API Key (Amplitude → Settings → Projects → API Key) et choisissez la région. Cliquez sur « Enregistrer analytics » puis sur « Activer ».
Les événements sortants vont vers /2/httpapi. Pour recevoir des événements, pointez un export/webhook Amplitude vers l'« URL du webhook » (Amplitude ne signe pas : le jeton de l'URL est la protection).

Segment

Dans le CRM, trouvez la carte « Product analytics (Segment) ».
Créez une source HTTP API dans Segment (Connections → Sources) et collez la Write Key. En option, définissez un secret de webhook (pour exiger la signature en entrant). Cliquez sur « Enregistrer analytics » puis « Activer ».
Sortant : les événements vont vers /v1/track authentifiés par Basic auth avec la write key. Entrant : créez une destination Webhook (ou une fonction) dans Segment pointant vers l'« URL du webhook ». Par défaut, Segment ne signe pas ; si vous définissez un secret, le CRM vérifie l'en-tête x-signature (HMAC-SHA1) ; sinon, le jeton de l'URL sert de protection.

Traitez les URL de webhook et les identifiants comme des secrets. Si vous essayez d'activer sans les identifiants nécessaires, l'intégration reste inerte, et rien n'est envoyé ni reçu tant que tout n'est pas en place.

Comment tester

Sortant : cliquez sur « Envoyer un événement test » sur la carte avec un distinct id quelconque et confirmez, dans votre Mixpanel/Amplitude/Segment, que l'événement est bien arrivé (Live View / Debugger).
Automatisation : créez une règle avec l'action « Envoyer un événement (analytics) » et déclenchez-la ; vérifiez l'événement chez le fournisseur.
Entrant : faites envoyer par le fournisseur un événement vers l'« URL du webhook » pour un email existant en tant que Contact et vérifiez l'activité sur le Contact.

Dépannage

Erreur 401 / l'événement n'apparaît pas : identifiant incorrect. Mixpanel → Project Token ; Amplitude → API Key ; Segment → Write Key (authentifiée par Basic auth). Recollez le bon identifiant.
Mauvaise région : si votre projet utilise la résidence des données EU, cochez la région EU. Sinon les événements vont vers le mauvais point de terminaison et n'apparaissent pas.
L'automatisation n'envoie rien : l'action « Envoyer un événement (analytics) » est gated : si l'intégration n'est pas active, elle ne fait rien. Activez l'intégration et vérifiez le fournisseur sélectionné dans l'action.
L'entrant ne devient pas une activité : si l'email de l'événement n'existe pas dans le CRM, l'activité reste non liée (rien n'est perdu). Segment : si vous avez défini un secret, validez l'en-tête x-signature (HMAC-SHA1).
404 sur l'URL du webhook : intégration désactivée ou jeton modifié. Réactivez et recopiez l'URL.

Open this article inside the system →