Configurer l'intégration ActiveCampaign
L'intégration ActiveCampaign envoie les coordonnées collectées par ton agent IA directement dans ton compte ActiveCampaign. Les nouveaux leads apparaissent automatiquement dans ta liste de contacts, prêts pour le suivi ou les campagnes email.
En bref
Heyloha se connecte à ActiveCampaign via ton URL API et ta clé API. Les champs standard (nom, email, téléphone) sont synchronisés automatiquement. Pour les données d'adresse, des IDs de champs personnalisés sont nécessaires.
Qu'est-ce qui est synchronisé ?
Les champs standard suivants sont automatiquement synchronisés avec ActiveCampaign :
- Prénom et nom
- Adresse e-mail
- Numéro de téléphone
L'adresse, le code postal, la ville et le pays peuvent également être synchronisés, mais nécessitent des IDs de champs personnalisés.
Le point de terminaison de synchronisation des contacts d'ActiveCampaign met automatiquement à jour les contacts existants lorsque l'email correspond.
De quoi as-tu besoin ?
- Un compte ActiveCampaign avec accès API (disponible sur tous les plans).
- Ton URL API et ta clé API (dans Paramètres > Developer).
- Un compte Heyloha actif avec au moins un agent IA.
- Optionnel : IDs de champs personnalisés pour adresse, code postal, ville et pays.
Trouver tes identifiants API dans ActiveCampaign
Va dans Paramètres
Connecte-toi à ActiveCampaign et va dans Paramètres > Developer.
Copie ton URL API
L'URL API ressemble à : https://votrecompte.api-us1.com. Ton URL peut différer selon ta région (par ex. api-eu1.com pour l'Europe). Copie l'URL exacte depuis ton compte ActiveCampaign.
Copie ta clé API
La clé API se trouve juste en dessous de l'URL API. Copie-la également.
IDs de champs personnalisés pour les données d'adresse (optionnel)
Si tu souhaites aussi synchroniser les données d'adresse, tu as besoin des IDs numériques de tes champs personnalisés :
Va dans Manage Fields
Dans ActiveCampaign, va dans Paramètres > Manage Fields.
Trouve ou crée les champs
Cherche les champs pour adresse, code postal, ville et pays. Crée-les s'ils n'existent pas encore.
Note les IDs numériques
Chaque champ personnalisé a un ID numérique unique. Note les IDs pour chaque champ d'adresse.
Configurer l'intégration dans Heyloha
Va dans Agent, puis Intégrations
Dans le menu de gauche, clique sur Agent et ouvre l'onglet Intégrations. La section Webhooks se trouve tout en haut.
Clique sur Ajouter un webhook
Dans la section Webhooks, clique sur Ajouter un webhook. Un formulaire s'ouvre pour configurer la connexion.
Choisis 'ActiveCampaign' comme plateforme
Sélectionne ActiveCampaign dans le formulaire. Le formulaire affiche les champs pour l'URL API et la clé API.
Choisis les canaux (facultatif)
Par défaut, le webhook s'applique à tous les canaux de ton agent. Pour le limiter par exemple au chat web ou à WhatsApp uniquement, sélectionne les canaux souhaités. Si tu laisses vide, la connexion s'applique à tous les canaux.
Renseigne tes identifiants API
Colle l'URL API et la clé API que tu as copiées dans ActiveCampaign.
Renseigne les IDs de champs personnalisés (facultatif)
Chaque champ personnalisé a un ID numérique unique. Tu trouves cet ID en cliquant sur le champ et en regardant le numéro dans l'URL. Note les IDs pour chaque champ d'adresse.
Nomme l'intégration
Choisis un nom facilement identifiable, par exemple 'ActiveCampaign Leads'. Ce nom est aussi utilisé comme nom de fonction interne.
Sélectionne les champs de contact
Choisis quelles informations ton agent IA doit collecter. Sélectionne au minimum une adresse e-mail.
Choisis les déclencheurs d'événements
Sélectionne quand l'intégration doit se déclencher : lors de la capture de coordonnées, de la réservation d'un rendez-vous ou de l'atteinte d'un objectif.
Décris quand la connexion doit être utilisée
Donne une instruction indiquant quand l'IA doit déclencher cette intégration.
Enregistre et active
Mets l'intégration sur 'Actif' et clique sur Enregistrer dans le formulaire. La connexion est active immédiatement.
Tester la connexion
Après l'enregistrement, teste la connexion via le bouton 'Tester la connexion'. Un contact test est envoyé à ActiveCampaign.
- Vert 'Connecté' : tes identifiants API sont valides.
- Erreur rouge : vérifie ton URL API et ta clé API.
Journal de livraison
Chaque tentative d'envoi est enregistrée dans le journal. Heyloha réessaie jusqu'à 7 fois en cas d'erreur temporaire.
Questions fréquentes
De quel plan ActiveCampaign ai-je besoin ?
Tout plan avec accès API fonctionne. La clé API est disponible dans Paramètres > Developer.
Dois-je créer des champs personnalisés pour les données d'adresse ?
Uniquement si tu veux synchroniser les données d'adresse. Pour le nom, l'email et le téléphone, aucun champ personnalisé n'est nécessaire.
Puis-je combiner ActiveCampaign avec d'autres intégrations ?
Oui. Chaque agent IA peut avoir plusieurs intégrations.
Configurer l'intégration HubSpotConfigurer l'intégration webhook générique