Intégration GoHighLevel (GHL) #

Vous utilisez déjà GoHighLevel (GHL) pour gérer votre entreprise ? Cette intégration vous permet d’ajouter la messagerie basée sur l’IA de Your AI Connector à votre configuration GHL existante. Les messages reçus dans GHL sont transférés à Your AI Connector pour être traités par l’IA, et les réponses de Your AI Connector sont renvoyées via GHL au client sur le canal d’origine.

Vous utilisez un autre CRM ? Il n’a pas besoin d’un écran dédié pour fonctionner avec Your AI Connector : consultez Connecter un outil que nous ne listons pas pour les fonctions personnalisées, l’API et les webhooks.

Cela signifie que vous pouvez continuer à utiliser GHL comme centre névralgique tout en laissant l’IA gérer les conversations automatisées.

Prérequis #

• Un compte Your AI Connector actif avec votre clé API (disponible dans Paramètres → Intégrations → Clé API). Une clé API est un code unique qui permet à GHL de communiquer en toute sécurité avec votre compte.
• Un compte GoHighLevel avec les autorisations nécessaires pour créer des workflows et gérer des webhooks (notifications automatisées entre systèmes).

Comment ça fonctionne #

Workflow 1 : GHL vers Your AI Connector #

Ce workflow transfère les messages entrants de GHL vers Your AI Connector.

Étape 1 : Créer le flux de travail #

1. Dans GHL, allez dans Automatisation > Workflows.
2. Cliquez sur Créer un nouveau workflow.
3. Donnez-lui un nom explicite, tel que “Envoyer message à Your AI Connector”.

Étape 2 : Ajouter des déclencheurs #

Ajoutez un déclencheur pour chaque canal que vous souhaitez transférer :

• Client a répondu - SMS
• Client a répondu - E-mail
• Client a répondu - Message Facebook
• Client a répondu - Message privé Instagram
• Client a répondu - Chat en direct

Vous pouvez tous les ajouter ou seulement les canaux pertinents pour votre configuration.

Étape 3 : Ajouter un filtre d’étiquette (Optionnel) #

Si vous souhaitez uniquement transférer les messages de contacts spécifiques :

1. Cliquez sur Ajouter un filtre sur le déclencheur.
2. Définissez la condition sur « Le contact a un tag ».
3. Choisissez votre ou vos tags.
4. Sélectionnez si le contact doit avoir l’un ou tous les tags sélectionnés.

Étape 4 : Créer une séparation de canal #

Ajoutez une action Condition pour acheminer chaque canal vers son propre webhook :

Étape 5 : Configurer les webhooks #

Pour chaque branche, ajoutez une action Webhook / Requête HTTP :

• Méthode : POST

• URL :

  https://api.youraiconnector.com/v1/incoming_custom_channel_message?apiKey=YOUR_API_KEY
  

• Champs de données personnalisés :

Valeurs de canal par branche :

Étape 6 : Activer la réentrée #

Dans les paramètres du workflow, assurez-vous que Autoriser la réentrée est activé. Sans cela, seul le premier message de chaque contact sera transféré.

Workflow 2 : Your AI Connector vers GHL #

Ce workflow reçoit les réponses de Your AI Connector et les envoie au client via le canal GHL approprié.

Étape 1 : Créer un webhook entrant dans GHL #

1. Dans GHL, allez dans Paramètres > Développeurs / API.
2. Cliquez sur Créer un nouveau webhook (ou “Webhook entrant”).
3. Nommez-le “Messages”.
4. Enregistrez et copiez l’URL du webhook — vous en aurez besoin à l’étape suivante.

Étape 2 : Configurer Your AI Connector #

1. Dans Your AI Connector, cliquez sur Settings dans la barre latérale.
2. Sous Channels, cliquez sur Channels.
3. Faites défiler jusqu’à la carte Custom channel tout en bas de la page.
4. Collez l’URL du webhook entrant GHL que vous venez de copier dans Webhook URL (il doit s’agir d’une adresse HTTPS publique) et cliquez sur Save.

Il ne s’agit pas de la page Settings → Integrations → Webhooks. Cette page est destinée aux notifications d’événements et envoie une charge utile différente. Le relais sortant GHL est configuré sur la carte Custom channel sous Settings → Channels.

Your AI Connector enverra désormais automatiquement une notification à GHL chaque fois qu’un message est envoyé à un contact. Les données envoyées ressemblent à ceci :

{
  "contactId": "NtL97bwnhITrfIq8lWFi",
  "messageId": "s28dtg13qNuhXLoKpcLs",
  "userId": "wpDZRvaw4Hgh4whUBpwlKPRftOi2",
  "body": "Message content here",
  "toId": "qtpBsc6fiqkXTnSOeze3",
  "channel": "email"
}

Note de navigation : la clé API que vous utilisez pour le Workflow 1 et la carte Custom channel que vous utilisez ici se trouvent à des endroits différents — Settings → Integrations → API Key pour la clé, et la carte Custom channel en bas de Settings → Channels pour ce relais. La page séparée Settings → Integrations → Webhooks est destinée aux notifications d’événements et envoie une charge utile différente ; consultez Webhooks si c’est ce que vous recherchez à la place.

Étape 3 : Créer le flux de travail de réponse #

1. Dans GHL, accédez à Automation > Workflows.
2. Créez un nouveau flux de travail nommé “Send Message to Contact.”
3. Définissez le déclencheur sur Inbound Webhook et sélectionnez le webhook que vous avez créé à l’étape 1.

Étape 4 : Ajouter une action de recherche de contact #

1. Ajoutez une action Find Contact.
2. Définissez le champ de recherche sur Contact ID.
3. Utilisez la valeur : {{inboundWebhookRequest.toId}}

Étape 5 : Ajouter une vérification de tag optionnelle #

Si vous souhaitez limiter les contacts qui reçoivent des messages de Your AI Connector :

1. Ajoutez une action Condition.
2. Vérifiez si le contact possède un tag spécifique.
3. Si le tag est manquant, terminez le flux de travail (ajoutez une action “Stop” sur la branche false).

Étape 6 : Ajouter une séparation par canal #

Ajoutez une action Condition qui achemine le message en fonction de {{inboundWebhookRequest.channel}} :

Étape 7 : Configurer chaque action d’envoi #

Dans chaque action d’envoi, définissez le corps du message sur :

{{inboundWebhookRequest.body}}

Étape 8 : Activer la réentrée #

Comme pour le workflow 1, assurez-vous que l’option Autoriser la réentrée est activée dans les paramètres du workflow.

Tester l’intégration #

Tester GHL vers Your AI Connector (Workflow 1) #

1. Envoyez un message à votre numéro GHL ou à un canal connecté (par exemple, envoyez-vous un SMS).
2. Ouvrez Your AI Connector et vérifiez que le message apparaît dans Chats.
3. Vérifiez que l’étiquette du canal est correcte (SMS, e-mail, etc.).
4. Répétez l’opération pour chaque canal configuré.

Tester Your AI Connector vers GHL (Workflow 2) #

1. Dans Your AI Connector, envoyez une réponse à un contact (manuellement ou laissez l’IA répondre).
2. Ouvrez GHL et vérifiez que le contact a bien reçu le message.
3. Confirmez qu’il a été envoyé via le canal approprié.
4. Vérifiez que le contenu du message correspond.

Dépannage #

Étapes suivantes #

• Webhooks — configurez des webhooks pour d’autres événements Your AI Connector.
• Accès API — utilisez l’API pour des intégrations personnalisées au-delà de GHL.
• Canaux personnalisés — apprenez-en plus sur la messagerie via des canaux personnalisés.