Connecter un CRM externe
Guide pas-à-pas pour connecter HubSpot, Salesforce, Pipedrive, Zoho, Freshsales ou Airtable à Metrikia. Webhooks et API inclus.
Objectif
À la fin de ce guide, votre CRM externe sera connecté à Metrikia et vos leads/deals se synchroniseront automatiquement. Vous pourrez enfin voir le vrai ROI de vos campagnes publicitaires en croisant dépenses ads et ventes réelles.
Pourquoi c'est important : Sans connexion CRM, vos métriques de revenue sont aveugles. Vous ne verrez que les leads, pas les ventes. Metrikia transforme vos données CRM en métriques d'attribution actionables.
1. HubSpot
Connexion
- Allez dans Paramètres > Intégrations > HubSpot
- Cliquez sur Connecter : une fenêtre OAuth HubSpot s'ouvre
- Sélectionnez le portail HubSpot à connecter
- Autorisez les permissions demandées (contacts, deals, pipelines)
- La synchronisation initiale démarre automatiquement
Ce qui se synchronise
| HubSpot | Metrikia | Direction |
|---|---|---|
| Contacts | Leads | Bidirectionnelle |
| Deals | Deals | Bidirectionnelle |
| Deal Stages | Pipeline stages | HubSpot → Metrikia |
| Custom Properties | Champs personnalisés | Configurable |
Mapping des champs
Metrikia mappe automatiquement les champs standard (email, nom, téléphone, montant du deal). Pour les champs personnalisés, allez dans Paramètres > Intégrations > HubSpot > Field Mapping et associez vos champs HubSpot aux champs Metrikia.
> Astuce pro : Créez une propriété HubSpot "Source Metrikia" pour voir l'attribution directement dans HubSpot. La synchronisation bidirectionnelle l'alimentera automatiquement.
2. Salesforce
Connexion
- Allez dans Paramètres > Intégrations > Salesforce
- Cliquez sur Connecter : authentification OAuth Salesforce
- Choisissez l'environnement (Production ou Sandbox)
- Autorisez l'accès API
Ce qui se synchronise
| Salesforce | Metrikia | Direction |
|---|---|---|
| Leads | Leads | Bidirectionnelle |
| Opportunities | Deals | Bidirectionnelle |
| Opportunity Stages | Pipeline stages | Salesforce → Metrikia |
| Custom Fields | Champs personnalisés | Configurable |
Mapping personnalisé
Salesforce a souvent des champs custom complexes. Dans l'écran de mapping, vous pouvez :
- Associer n'importe quel champ Salesforce à un champ Metrikia
- Créer des règles de transformation (ex: convertir un picklist Salesforce en statut Metrikia)
- Définir la priorité en cas de conflit (CRM ou Metrikia fait foi)
3. Pipedrive
Connexion
- Allez dans Paramètres > Intégrations > Pipedrive
- Entrez votre clé API Pipedrive (trouvable dans Pipedrive > Settings > Personal preferences > API)
- Cliquez sur Connecter et synchroniser
Ce qui se synchronise
| Pipedrive | Metrikia | Direction |
|---|---|---|
| Persons | Leads | Pipedrive → Metrikia |
| Deals | Deals | Bidirectionnelle |
| Deal Stages | Pipeline stages | Pipedrive → Metrikia |
> Astuce pro : Pipedrive distingue "Persons" et "Organizations". Metrikia synchronise les Persons comme Leads. Si vous utilisez les Organizations, associez-les à vos Persons pour garder le contexte.
4. Zoho CRM
Connexion
- Allez dans Paramètres > Intégrations > Zoho CRM
- Cliquez sur Connecter : authentification OAuth Zoho
- Sélectionnez l'organisation Zoho
- Autorisez les modules nécessaires (Leads, Deals, Contacts)
Ce qui se synchronise
| Zoho CRM | Metrikia | Direction |
|---|---|---|
| Leads/Contacts | Leads | Bidirectionnelle |
| Deals | Deals | Bidirectionnelle |
| Stage History | Pipeline stages | Zoho → Metrikia |
5. Freshsales
Connexion
- Allez dans Paramètres > Intégrations > Freshsales
- Entrez votre clé API Freshsales et votre domaine (ex: votre-entreprise.freshsales.io)
- Cliquez sur Connecter et synchroniser
Ce qui se synchronise
| Freshsales | Metrikia | Direction |
|---|---|---|
| Contacts | Leads | Freshsales → Metrikia |
| Deals | Deals | Bidirectionnelle |
6. Airtable
Connexion
- Allez dans Paramètres > Intégrations > Airtable
- Entrez votre clé API Airtable (ou Personal Access Token)
- Sélectionnez la base et les tables à synchroniser
- Mappez les colonnes Airtable aux champs Metrikia
Particularité : schéma flexible
Airtable n'a pas de structure fixe. C'est vous qui définissez le mapping :
- Quelle table contient vos leads ?
- Quelle colonne est l'email ? Le nom ? Le téléphone ?
- Quelle table contient vos deals ? Quel champ est le montant ?
> Astuce pro : Utilisez une vue Airtable filtrée pour ne synchroniser que les enregistrements pertinents (ex: statut ≠ "Archivé"). Cela réduit le bruit et accélère la synchronisation.
7. Webhook générique (tout CRM)
Pour les CRM non listés ci-dessus, Metrikia fournit un endpoint webhook entrant.
Configuration
- Allez dans Paramètres > Intégrations > Webhooks
- Cliquez sur Créer un endpoint
- Copiez l'URL générée (ex:
https://api.metrikia.io/api/v1/webhooks/inbound/abc123) - Configurez votre CRM pour envoyer des requêtes POST à cette URL
Payload attendu
``json
{
"event": "lead.created",
"data": {
"email": "prospect@example.com",
"firstName": "Jean",
"lastName": "Dupont",
"phone": "+33612345678",
"source": "meta",
"dealValue": 5000
}
}
`
Les événements supportés : lead.created, lead.updated, deal.created, deal.updated, deal.won, deal.lost.
8. API REST (programmatique)
Pour une intégration 100 % custom, utilisez l'API REST Metrikia.
Authentification
Créez une clé API dans Paramètres > API > Créer une clé. Passez-la en header :
`
Authorization: Bearer votre-cle-api
`
Endpoints principaux
- POST /api/v1/leads
. Créer un lead - PATCH /api/v1/leads/{id}
. Mettre à jour un lead - POST /api/v1/deals
. Créer un deal - PATCH /api/v1/deals/{id}`. Mettre à jour un deal
Documentation complète : api.metrikia.io/api/v1/docs
Vérifier que la synchronisation fonctionne
Après connexion, vérifiez :
- Paramètres > Intégrations > votre CRM → statut "Connecté" avec la date du dernier sync
- CRM > Leads → vos leads CRM apparaissent
- CRM > Deals → vos deals sont synchronisés avec les bons montants
- Modifiez un lead dans votre CRM → vérifiez que la modification apparaît dans Metrikia sous 5 minutes
> Astuce pro : Contrairement à Hyros qui passe par Zapier (coût par tâche, synchronisation différée de 5-15 min), Metrikia synchronise directement via OAuth ou API, temps réel, coût inclus. Et contrairement à GoHighLevel qui impose son CRM fermé, Metrikia s'adapte à votre stack existant.
Guide précédent
Comprendre les indicateurs du dashboard
Guide suivant
Intégrer un calendrier de prises de RDV
Pour aller plus loin, consultez notre blog, la documentation ou contactez le support.