GHL (GoHighLevel)
Ce que ca fait
GHL envoie les événements CRM en temps réel vers DURUM.ai via des Workflows. Chaque événement est automatiquement associé à votre compte grace à votre client_key.
| Événement GHL | Type dans DURUM.ai | Quand |
|---|---|---|
| Contact créé | Lead | Nouveau contact dans votre CRM |
| Formulaire soumis | Application | Le prospect remplit un formulaire de qualification |
| Rendez-vous créé | Booking | Un rendez-vous est réservé |
| Rendez-vous no-show | No-show | Le prospect ne se présente pas |
| Opportunité gagnee | Vente | Un deal est marque comme gagne |
Configuration étape par étape
Vous devez créer un Workflow GHL par type d'événement. Voici les étapes détaillées pour chaque.
Workflow 1 : Lead (nouveau contact)
- Connectez-vous à votre compte GHL
- Dans le menu latéral, allez dans Automation puis Workflows
- Cliquez sur Create Workflow (ou Créer un workflow)
- Choisissez Start from Scratch (commencer à partir de zero)
- Nommez le workflow :
DURUM - Lead - Configurer le déclencheur (Trigger) :
- Cliquez sur Add New Trigger
- Sélectionnez Contact Created
- Cliquez sur Save Trigger
- Ajouter l'action webhook :
- Cliquez sur le + sous le trigger
- Cherchez et sélectionnez Webhook
- Dans le champ URL, entrez :
https://app.durum.ai/api/webhook/lead?client_key=VOTRE_CLE&source=ghl - Méthode : POST
- Laissez le body par défaut (GHL envoie automatiquement les données du contact)
- Cliquez sur Save Action
- Activez le workflow en cliquant sur le toggle Publish (en haut à droite)
Workflow 2 : Application (formulaire soumis)
- Créez un nouveau workflow : Create Workflow puis Start from Scratch
- Nommez-le :
DURUM - Application - Trigger : sélectionnez Form Submitted (ou Survey Submitted selon votre configuration)
- Sélectionnez le ou les formulaires concernes
- Action : ajoutez un Webhook
- URL :
https://app.durum.ai/api/webhook/application?client_key=VOTRE_CLE&source=ghl - Méthode : POST
- URL :
- Activez le workflow
Workflow 3 : Booking (rendez-vous créé)
- Créez un nouveau workflow :
DURUM - Booking - Trigger : sélectionnez Appointment Status Changed
- Filtrez sur le statut Booked (ou Confirmed)
- Action : ajoutez un Webhook
- URL :
https://app.durum.ai/api/webhook/booking?client_key=VOTRE_CLE&source=ghl - Méthode : POST
- URL :
- Activez le workflow
Workflow 4 : No-show (absence au rendez-vous)
- Créez un nouveau workflow :
DURUM - No-Show - Trigger : sélectionnez Appointment Status Changed
- Filtrez sur le statut No Show
- Action : ajoutez un Webhook
- URL :
https://app.durum.ai/api/webhook/no-show?client_key=VOTRE_CLE&source=ghl - Méthode : POST
- URL :
- Activez le workflow
Workflow 5 : Vente (opportunité gagnee)
- Créez un nouveau workflow :
DURUM - Vente - Trigger : sélectionnez Opportunity Status Changed
- Filtrez sur le statut Won
- Action : ajoutez un Webhook
- URL :
https://app.durum.ai/api/webhook/sale?client_key=VOTRE_CLE&source=ghl - Méthode : POST
- URL :
- Activez le workflow
Comment tester
- Créez un contact de test dans GHL (utilisez un email facilement identifiable, par exemple
test@votredomaine.com) - Le workflow devrait se declencher automatiquement
- Attendez 30 secondes puis allez dans DURUM.ai, page Logs Data
- Vous devriez voir l'événement apparaitre avec le statut
successouqueued - Supprimez le contact de test dans GHL après vérification
Dépannage GHL
| Problème | Solution |
|---|---|
| L'événement n'apparaît pas dans Logs Data | Vérifiez que le workflow est Publish (actif). Vérifiez l'URL (pas d'espace, client_key correct) |
Statut quarantined dans les logs | Le formulaire n'est pas encore reconnu. Normal pour un nouveau formulaire. L'agence le categorisera. |
| Erreur 401 dans les logs GHL | Vérifiez que &source=ghl est présent dans l'URL |
| Erreur 429 (Too Many Requests) | Trop de webhooks en même temps. Contactez l'agence. |
Formulaires inconnus et quarantaine
Si un formulaire GHL envoie des données mais n'est pas encore reconnu par DURUM.ai, l'événement est mis en quarantaine automatiquement. L'agence le categorisera dans la page Matching, et les prochains événements de ce formulaire seront automatiquement reconnus. Vous n'avez rien à faire.