Intégration GoHighLevel

• Installation OAuth via la marketplace (un sous-compte par organisation)
• Synchronisation des contacts de GoHighLevel vers les contacts demeterrr (manuelle ou automatique)
• Synchronisation des utilisateurs de GoHighLevel vers les employés demeterrr (manuelle ou automatique)
• Automatisation intégrée de demande d'avis après facture payée
• Automatisation de demande d'avis après facture payée via un webhook de workflow GoHighLevel
• Déconnexion et reconnexion depuis les Intégrations

1. Allez dans Paramètres > Intégrations.
2. Cliquez sur Connecter GoHighLevel.
3. Complétez l'installation marketplace dans HighLevel et choisissez votre sous-compte.
4. Revenez dans demeterrr et confirmez le statut Connecté.

L'installation prend en charge exactement un sous-compte (location) par organisation.

Utilisez Synchroniser maintenant dans la carte GoHighLevel pour importer les contacts et les utilisateurs sur demande. Chaque synchronisation manuelle importe jusqu'à 2 500 contacts et 2 500 utilisateurs. Les fiches synchronisées conservent leurs identifiants GoHighLevel, donc les synchronisations suivantes mettent à jour les mêmes fiches au lieu de créer des doublons.

La synchronisation manuelle est le mode par défaut. Si vous préférez que demeterrr reste à jour tout seul, activez Synchronisation automatique depuis GoHighLevel sur la carte d'intégration. Les contacts nouveaux ou mis à jour et les nouveaux membres d'équipe dans GoHighLevel apparaissent alors automatiquement dans demeterrr via des webhooks signés, sans aucun bouton à cliquer. Vous pouvez la désactiver à tout moment pour revenir à la synchronisation manuelle.

Les suppressions ne sont jamais synchronisées automatiquement : supprimer un contact dans GoHighLevel ne le supprime pas de demeterrr.

Le chemin d'automatisation le plus simple une fois GoHighLevel connecté :

1. Ouvrez Paramètres > Intégrations et trouvez la carte GoHighLevel.
2. Activez Déclencher à la facture payée.
3. Choisissez la séquence à exécuter et un délai optionnel en jours.
4. Cliquez sur Enregistrer les paramètres de déclenchement.

Quand une facture est payée dans votre sous-compte HighLevel, demeterrr reçoit un webhook signé et exécute la séquence automatiquement. Chaque facture déclenche au plus une fois, les périodes de repos et les désabonnements sont respectés, et aucun workflow GoHighLevel n'est nécessaire.

Si vous voulez une logique de filtrage ou de routage dans GoHighLevel (par exemple, seulement certains types de factures), vous pouvez piloter la même automatisation depuis un workflow GoHighLevel. Une fois configurée, votre équipe n'a jamais besoin d'ouvrir demeterrr pour demander des avis.

1. Créez une séquence avec une étape Demande d'avis (voir Créer votre première séquence) et activez-la.
2. Copiez l'identifiant de la séquence depuis l'URL de la page de la séquence.
3. Allez dans Paramètres > API et créez une clé API avec la portée sequences:execute. Copiez la clé, elle n'est affichée qu'une seule fois.

1. Dans GoHighLevel, allez dans Automation > Workflows et créez un nouveau workflow.
2. Ajoutez le déclencheur Invoice et filtrez-le sur le statut Paid. (Le déclencheur Payment Received fonctionne aussi si vous encaissez des paiements hors factures.)
3. Ajoutez l'action Custom Webhook (une action premium HighLevel) et configurez-la :

• Méthode : POST
• URL : https://votre-domaine.com/api/v1/sequences/VOTRE_ID_DE_SEQUENCE/execute
• En-têtes :
  • Authorization : Bearer VOTRE_CLE_API
  • Content-Type : application/json
• Corps :

{
  "contacts": [
    {
      "email": "{{contact.email}}",
      "firstName": "{{contact.first_name}}",
      "lastName": "{{contact.last_name}}",
      "phone": "{{contact.phone}}"
    }
  ]
}

1. Enregistrez et publiez le workflow.

1. GoHighLevel déclenche le workflow et envoie le client à demeterrr.
2. demeterrr retrouve le contact par courriel, ou le crée s'il est nouveau.
3. La séquence s'exécute et la demande d'avis part par courriel ou SMS.

• Les séquences respectent la période de repos configurée, donc un client récurrent n'est pas sollicité trop tôt.
• Les contacts désabonnés sont ignorés automatiquement.
• Le point d'accès prend en charge un en-tête optionnel Idempotency-Key. Si votre workflow peut transmettre une valeur unique comme le numéro de facture, les webhooks relancés ne provoqueront pas de double envoi.

Vous pouvez réutiliser le même workflow comme action manuelle : ouvrez n'importe quel contact dans GoHighLevel et ajoutez-le au workflow à la main. Cela agit comme un bouton « envoyer une demande d'avis » directement dans GoHighLevel.

La clé API est manquante ou invalide. Vérifiez la valeur de l'en-tête Authorization.

La clé API n'a pas la portée sequences:execute. Créez une nouvelle clé avec la bonne portée.

La séquence est en pause ou en brouillon. Activez-la dans demeterrr.

L'identifiant de séquence dans l'URL du webhook est erroné. Copiez-le à nouveau depuis l'URL de la page de la séquence.

Le contact GoHighLevel n'a pas d'adresse courriel, ou il est désabonné, ou il se trouve dans la fenêtre de repos de la séquence.

1. Ouvrez Paramètres > Intégrations.
2. Cliquez sur Déconnecter dans la carte GoHighLevel.
3. Confirmez l'action.

La déconnexion arrête la synchronisation des contacts. Les webhooks de workflow continuent de fonctionner tant que la clé API reste active, car ils utilisent l'API publique et non la connexion OAuth.

• Intégration QuickBooks
• Intégration Zapier
• Séquences déclenchées par API
• Créer votre première séquence