← Aide & guide · Connecter un CRM

1. 🎯 Le principe

2. 📦 Ce que Rosa vous envoie

Voici un exemple complet du JSON que Rosa envoie en POST à votre URL après chaque appel terminé. Pour le mapping côté middleware, vous piochez les champs qui vous intéressent.

{
  "version": "1.0",
  "event": "call.completed",
  "rosa_call_id": "abc-123-uuid",
  "artisan_id": "d731e3ca-...",
  "occurred_at": "2026-06-02T14:35:22Z",

  "call": {
    "duration_seconds": 187,
    "started_at": "2026-06-02T14:32:15Z",
    "ended_at": "2026-06-02T14:35:22Z",
    "outcome": null,
    "dashboard_url": "https://www.rosa-ia.com/dashboard/calls/abc-123-uuid"
  },

  "caller": {
    "phone": "+33612345678",
    "name": "Pierre Martin",
    "email": "pierre.martin@example.fr",
    "address": null
  },

  "intent": "devis",
  "urgency": "normal",
  "summary": "Prospect TNS cherche une mutuelle santé pour famille de 4. Devis demandé.",
  "need_description": "Mutuelle santé TNS — famille, niveau intermédiaire",

  "appointment": {
    "date": null,
    "preference_text": "demain matin",
    "status": "to_call_back"
  },

  "proposed_price": {
    "min": 80,
    "max": 120,
    "currency": "EUR"
  },

  "tags": {
    "is_existing_client": false,
    "has_appointment": false
  }
}

Les valeurs nullsignifient « pas d'info ». Rosa envoie systématiquement TOUS les champs même vides.

3. 🔧 Choisir votre middleware

💡 Pour 2025-2026 on conseille n8n cloud (20$/mois) ou Make.com (free 1000 ops) — meilleur rapport qualité/prix que Zapier pour le volume.

4. 🟢 Tuto n8n détaillé (recommandé)

Étape par étape (sans le raccourci)

1. Créez un compte n8n sur app.n8n.cloud (ou installez en self-hosted via Docker si vous voulez tout gérer localement).
2. Une fois connecté, cliquez sur « + Add Workflow » en haut à droite. Donnez-lui un nom (ex: « Rosa → CRM »).
3. Ajoutez un node Webhook :
   • Cliquez sur le « + » au centre de l'écran
   • Tapez webhook dans la recherche
   • Choisissez « Webhook » (le simple, pas « Wait for Webhook »)
4. Dans les paramètres du node Webhook :
   • Authentication : None (c'est l'auth entrante — on s'en occupe plus tard si besoin)
   • HTTP Method : POST
   • Path : rosa-crm (ou ce que vous voulez)
   • Respond (parfois appelé « Response Mode ») : Immediately
     → n8n renvoie automatiquement un 200 OK à Rosa dès réception. Plus simple, marche très bien. Si vous voulez personnaliser la réponse, choisissez « Using 'Respond to Webhook' Node » et ajoutez un dernier node « Respond to Webhook » à la fin du workflow.
   En haut du node vous voyez 2 URLs : « Test URL » et « Production URL ». Pour configurer Rosa on prendra la Production URL(mais on testera avec la Test URL d'abord).
5. ⚠️ Important — Test URL vs Production URL. En haut du panneau Webhook, n8n affiche 2 URLs distinctes :
   • Test URL (/webhook-test/...) — active UNIQUEMENT pendant ~120 sec après que vous cliquez sur « Listen for test event ». Si vous l'appelez sans avoir cliqué, vous obtenez une erreur 404.
   • Production URL (/webhook/...) — active dès que le workflow est Activé(toggle en haut à droite). C'est l'URL à utiliser en vrai.
6. Option A — Tester avec la Test URL (rapide pour voir le payload) :
   • Cliquez sur « Listen for test event » en bas du node Webhook
   • n8n affiche « Listening… » (actif 120 sec)
   • Copiez la Test URL et collez-la dans Rosa → Cerveau Rosa → CRM, dans le champ correspondant à ce webhook (ex : pour le webhook rosa-create-note, collez dans 📝 Création note / activité). Cliquez « 🧪 Tester » à côté du champ.
   • n8n capture le payload ✅ (vous pouvez voir les données reçues)
7. Option B — Tester avec la Production URL (recommandé pour la suite) :
   • Activez le workflow via le toggle « Inactive → Active » en haut à droite
   • Copiez la Production URL (avec /webhook/, pas /webhook-test/)
   • Collez-la dans Rosa → Cerveau Rosa → CRM, dans le bon champ selon le webhook créé :
     • Path rosa-search → champ 🔍 Recherche client
     • Path rosa-create-contact → champ ➕ Création contact
     • Path rosa-update-contact → champ ✏️ Mise à jour contact
     • Path rosa-create-note → champ 📝 Création note / activité
   • Cliquez sur « 🧪 Tester » à côté du champ → vous devez voir 200 OK ✅
8. Dans n8n, allez dans Executions(menu de gauche) — vous voyez l'exécution du test avec tous les champs du payload Rosa. Cliquez dessus pour explorer les données.
9. Ajoutez un node Code derrière le Webhook pour transformer le payload :
   • Cliquez sur le « + » à droite du Webhook
   • Tapez code, choisissez « Code »
   • Mode : « Run Once for All Items »
   • Collez ce JS (ajustez selon votre CRM) :

   const data = $input.first().json.body;
   return {
     client_name: data.caller?.name || 'Inconnu',
     client_phone: data.caller?.phone,
     client_email: data.caller?.email,
     intent: data.intent,
     summary: data.summary,
     appointment: data.appointment?.preference_text,
     dashboard_url: data.call?.dashboard_url,
   };

10. Ajoutez un node de votre CRM (Monday, HubSpot, Pipedrive…) :
    • Cliquez sur le « + » à droite du Code
    • Recherchez votre CRM (ex: « Monday » → choisissez « Monday → Create Item »)
    • Connectez votre compte (OAuth)
    • Sélectionnez le Board, mappez les colonnes avec les variables (drag-and-drop depuis l'onglet « Schema » du node Code à gauche)
11. (Cette étape est facultative) Si vous avez choisi « Using 'Respond to Webhook' Node »à l'étape 4, ajoutez maintenant ce node à la fin :
    • Cherchez « respond » → choisissez « Respond to Webhook »
    • Respond With : JSON
    • Response Body : { "ok": true }
    Si vous avez gardé « Immediately », n8n renvoie automatiquement 200 OK — passez directement à l'étape suivante.
12. Cliquez sur « Save » en haut à droite. Puis activez le workflow avec le toggle « Inactive → Active ».
13. Récupérez la Production URL du node Webhook (cette fois sans « webhook-test/ »). Format :https://VOTRE-INSTANCE.app.n8n.cloud/webhook/rosa-create-note
14. Dans Rosa, collez la Production URL dans le bon champ (🔍 Recherche / ➕ Création contact / ✏️ Mise à jour / 📝 Création note), selon le path du webhook créé. Cliquez « 💾 Enregistrer CRM ».
15. Répétez les étapes 3 à 14 pour les 3 autres webhooks (paths différents : rosa-search, rosa-create-contact, rosa-update-contact). Vous aurez 4 webhooks dans le même workflow n8n, chacun branché à une action différente de votre CRM.
16. Activez le toggle « CRM connecté »en haut de l'onglet CRM de Cerveau Rosa, choisissez votre CRM dans le dropdown, et enregistrez.
17. Et voilà ✅Faites un appel test sur votre numéro Rosa : pendant l'appel le webhook Searchest appelé (Rosa connaît le client si vous l'avez), et 5 secondes après la fin de l'appel, une fiche apparaîtra dans votre CRM (via Create contact si prospect) et une note sera créée (via Create note).

5. 🟣 Tuto Make.com détaillé

1. Créez un compte sur make.com/register (free tier 1000 ops/mois).
2. Dans le dashboard, cliquez sur « + Create a new scenario » (bouton violet en haut à droite).
3. Au centre de l'écran, cliquez sur le grand « + » (premier module).
4. Recherchez « Webhooks » → choisissez le module « Webhooks → Custom webhook ».
5. Dans la fenêtre qui s'ouvre, cliquez sur « Add » :
   • Nommez le webhook (ex: « Rosa »)
   • Cliquez sur « Save »
6. Make vous donne une URL au format https://hook.eu2.make.com/abc123... Copiez-la.
7. Dans Rosa, allez dans Cerveau Rosa → CRM et collez l'URL dans le champ correspondant à l'action de ce scénario : 🔍 Recherche client, ➕ Création contact, ✏️ Mise à jour contact, ou 📝 Création note. Cliquez sur « 🧪 Tester » à côté du champ.
   💡 Il vous faut créer 4 scenarios Make (un par action) avec chacun son propre Custom webhook → ses propres modules CRM.
8. Retournez dans Make. Cliquez sur « Run once » en bas à gauche pour relancer le scenario, puis dans Rosa cliquez à nouveau sur « 🧪 Tester ».
9. Le module Webhook a maintenant capturé la structure du payload Rosa. Vous voyez un cercle vert avec « 1 ». Cliquez dessus pour voir les données reçues. ✅
10. Ajoutez votre CRM :
    • Cliquez sur le « + » à droite du Webhook
    • Recherchez votre CRM (ex: Monday) → choisissez « Create an Item »
    • Connectez votre compte (cliquez sur « Add » → entrez votre API key)
    • Sélectionnez le Board, le Group, et mappez les colonnes
    • Pour mapper une colonne, cliquez dans le champ → Make affiche les variables du Webhook → choisissez celle qui correspond (ex: caller.name → colonne « Client »)
11. Sauvegardez le scenario (icône disquette en bas à gauche).
12. Activez le scenario : toggle « OFF → ON » en bas à gauche (devient violet).
13. Et voilà ✅Chaque appel Rosa créera une fiche dans votre CRM. Pas besoin de copier une « Production URL » — celle de l'étape 6 reste valide.

6. 🟠 Tuto Zapier détaillé

1. Créez un compte sur zapier.com/sign-up (free 100 tâches/mois).
2. Dashboard → bouton « + Create Zap » en haut à gauche.
3. Configurer le Trigger :
   • Cliquez sur le bloc « Trigger »
   • Cherchez « Webhooks by Zapier » (l'app officielle Zapier)
   • Trigger event : « Catch Hook » → « Continue »
   • Vous arrivez sur l'onglet « Set up trigger ». Laissez « Child Key » vide → cliquez « Continue »
4. Zapier affiche un « Custom Webhook URL » au format :https://hooks.zapier.com/hooks/catch/12345678/abc123/Copiez-la.
5. Dans Rosa → Cerveau Rosa → CRM → collez l'URL dans le champ correspondant à l'action de ce Zap (🔍 Recherche / ➕ Création contact / ✏️ Mise à jour / 📝 Création note) → cliquez « 🧪 Tester ».
   💡 Il vous faut créer 4 Zaps (un par action), chacun avec son propre Webhook Catch et son propre module CRM.
6. Revenez sur Zapier → cliquez sur « Test trigger ». Zapier affiche le payload reçu — vous voyez tous les champs Rosa. ✅ Cliquez « Continue with selected record ».
7. Configurer l'Action :
   • Cliquez sur le bloc « Action »
   • Cherchez votre CRM (ex: « Monday.com »)
   • Choisissez l'event : « Create Item » → « Continue »
   • Connectez votre compte (OAuth ou API key selon le CRM)
8. Configurez le mapping. Pour chaque colonne du CRM, cliquez dans le champ → Zapier affiche les variables du trigger → cliquez sur la variable qui correspond (ex: « 1. Caller Name » → colonne « Client »).
9. Cliquez « Continue » → « Test step ». Vérifiez qu'une fiche test s'est bien créée dans votre CRM.
10. Cliquez sur « Publish » (bouton bleu en haut à droite).
11. Et voilà ✅

7. 📋 Exemple concret : mapping vers Monday

Imaginons un Board Monday « Appels Rosa » avec ces colonnes. Voici le mapping recommandé :

Pour Pipedrive : caller.name → Person, caller.email → Email, intent → Tag/Label, summary → Note. Pour HubSpot : crée un Contact + une Note. Adaptez selon votre flux.

8. 📥 Lookup inbound (Rosa reconnaît vos clients)

Pour que Rosa connaisse un client dès l'appel entrant (« Bonjour M. Martin, c'est pour votre contrat RC Pro AXA ? »), créez un second scenario qui répond à un GET de Rosa :

1. Créez un nouveau workflow/scenario, avec un trigger Webhook GET (ou POST si vous préférez).
2. Rosa appelle votre URL avec le paramètre ?phone=+33612345678.
3. Dans le scenario, faites une recherche dans votre CRM (« Find Item by Phone »).
4. Renvoyez un JSON au format Rosa :

   {
     "client": {
       "name": "Pierre Martin",
       "email": "pierre.martin@example.fr",
       "address": "12 rue de la Paix, Paris",
       "since": "2023-04",
       "tags": ["TNS", "premium"],
       "notes": "Client depuis 2 ans, dossier sain"
     },
     "contracts": [
       {
         "product": "RC Pro",
         "company": "AXA",
         "status": "active",
         "policy_number": "POL-2024-789",
         "premium": "450€/an",
         "next_renewal": "2026-09-01",
         "notes": "Garantie 1.5M€"
       }
     ],
     "recent_interactions": [
       {
         "date": "2026-05-12",
         "type": "appel",
         "summary": "Question sur indexation"
       }
     ]
   }

5. Copiez l'URL et collez-la dans Rosa → URL lookup.

⚠️ Le lookup a un timeout de 2 secondescôté Rosa. Si votre middleware met plus → fallback silencieux, l'appel se passe normalement mais sans la reconnaissance client. Pour des perfs maximales, n8n self-host ou un endpoint custom direct.

9. 🚨 Ça marche pas — troubleshooting

10. 💬 Besoin d'aide ?