Connecter ActiveCampaign

La plupart des intégrations demandent un seul jeton. ActiveCampaign en demande deux, parce que chaque compte vit sur son propre sous-domaine : une URL d’API du type https://acmecorp.api-us1.com et une clé d’API. Les deux se trouvent sur le même écran — Paramètres → Développeur. La seconde moitié de cette page traite de ce qui surprend vraiment les gens : ce qu’ActiveCampaign fait, et ne fait pas, d’un contact une fois qu’il existe.

Pourquoi ActiveCampaign exige deux valeurs

ActiveCampaign ne place pas tous ses clients derrière un seul nom d’hôte d’API partagé. Votre compte réside sur un sous-domaine de centre de données numéroté — api-us1, api-us2, et ainsi de suite — de sorte que la clé seule n’indique pas où envoyer les données. L’URL identifie votre compte ; la clé l’authentifie.

Avant de commencer

• N’importe quel forfait ActiveCampaign convient — l’API est offerte sur tous, y compris le forfait marketing d’entrée de gamme.
• Sachez si votre compte dispose des Transactions (Deals). Les transactions relèvent du volet ventes d’ActiveCampaign et ne sont pas incluses dans les forfaits les moins chers. Si le vôtre ne les a pas, tout le contenu de cette page reste valable : les contacts, les listes et les étiquettes existent dans tous les forfaits.
• Rappelez-vous à quoi sert ActiveCampaign : à envoyer des courriels commerciaux. Une personne qui tapote votre carte n’est pas la même chose qu’une personne qui demande votre infolettre. Décidez donc dès le départ si les nouveaux contacts doivent entrer dans une automatisation d’envoi.

Étape 1 — Copiez l’URL d’API et la clé depuis Paramètres → Développeur

Pas l’adresse affichée dans votre navigateur. Votre URL de connexion ressemble à acmecorp.activehosted.com — c’est l’application, pas l’API. L’URL d’API se termine toujours par .api-us1.com (ou le numéro attribué à votre compte).

Étape 2 — Collez les deux dans Anexus

Ce que devient un contact capté dans ActiveCampaign

Anexus écrit chaque contact capté au moyen du point de terminaison sync d’ActiveCampaign, qui fait la correspondance par adresse courriel : une adresse inconnue crée un nouveau Contact, une adresse déjà présente met à jour le contact existant au lieu de le dupliquer.

Les champs de base d’un contact ActiveCampaign sont peu nombreux : courriel, prénom, nom, téléphone. Anexus transmet aussi les autres renseignements recueillis par votre formulaire d’échange — entreprise, titre du poste, message — ainsi qu’une note indiquant comment le contact a été capté. Ouvrez le vrai contact capté à l’étape 2 pour voir exactement ce qui est arrivé dans votre compte avant de construire quoi que ce soit par-dessus.

Par ailleurs, trois choses qu’on s’attend à trouver sur le contact sont des objets distincts dans ActiveCampaign :

• Listes — un contact n’appartient à une liste que s’il y est abonné, et l’appartenance à une liste porte son propre statut d’abonnement.
• Étiquettes — des libellés libres, et la façon dont la plupart des utilisateurs d’ActiveCampaign segmentent réellement. Elles figurent sur le contact, mais constituent leurs propres enregistrements.
• Transactions et comptes — le volet ventes. Une transaction est un enregistrement distinct lié à un contact, et un compte est l’objet « entreprise » d’ActiveCampaign. Ni l’un ni l’autre ne fait partie de la fiche Contact ci-dessus.

Les automatisations ne se déclenchent pas comme on le croit

À lire deux fois, car l’automatisation est généralement la raison même pour laquelle on connecte ActiveCampaign.

• Il n’existe pas de déclencheur générique « un contact a été créé ». Les automatisations d’ActiveCampaign partent d’événements comme S’abonne à une liste, Étiquette ajoutée, Soumet un formulaire ou Modification d’un champ personnalisé. Ouvrez donc le vrai contact capté à l’étape 2 et regardez ce qu’il possède réellement : quelles listes, quelles étiquettes. C’est cela qui vous indique quel déclencheur peut s’activer pour les contacts venant d’Anexus.
• Les automatisations ne sont pas rétroactives. Un contact qui existait déjà au moment où vous activez une automatisation n’y entrera pas. Construisez l’automatisation d’abord, puis commencez à capter.
• Vérifiez le réglage Exécutions du déclencheur. Réglé sur une seule fois, une personne qui revient et dont le contact est simplement mis à jour ne réintégrera pas l’automatisation. Réglé sur plusieurs fois, elle le peut — ce qui convient à une séquence de relance et convient très mal à un courriel de bienvenue.
• Comme le point de terminaison sync met à jour au lieu de dupliquer, une personne qui revient et redonne la même adresse reste un seul contact, mis à jour. C’est généralement souhaitable — mais cela signifie aussi que le second tapotement n’est pas un nouvel événement d’abonnement.

Statut d’abonnement et consentement

ActiveCampaign suit le statut par liste, et non par contact : actif, non confirmé, désabonné, en rebond. Exister dans votre compte et pouvoir recevoir des courriels sont deux états distincts.

• Un désabonnement reste un désabonnement. Si une personne s’est désabonnée de votre liste par le passé, la resynchroniser ne l’y réinscrit pas — et c’est très bien ainsi. Seule la personne peut se réabonner.
• Le double consentement laisse les gens en « non confirmé ». Si une liste exige une confirmation, le contact y reste jusqu’à ce qu’il clique dans le courriel de confirmation. Il existe, mais ne peut pas encore recevoir de courriels — ce qui ressemble exactement à une synchronisation défaillante si l’on ne sait pas où regarder.
• Si vous vendez au Canada, traitez la captation et l’abonnement comme deux événements distincts. Une carte tapotée est une conversation ; un abonnement courriel est une permission. Conservez votre propre trace de la façon dont le consentement a été donné, et à quel moment.

Synchroniser les contacts captés auparavant

Synchroniser les contacts passés, sur la carte ActiveCampaign, envoie tout ce qui a été capté avant la connexion. Deux particularités d’ActiveCampaign à prévoir :

• ActiveCampaign limite le débit de son API — cinq requêtes par seconde par compte est le plafond documenté — de sorte qu’une synchronisation volumineuse arrive progressivement, par lots, plutôt que d’un seul coup. Laissez-la se terminer.
• Si une automatisation est déjà active sur un déclencheur auquel ces contacts correspondent, une synchronisation peut y faire entrer des centaines de personnes d’un coup — et chacune recevra le courriel placé en tête. Mettez l’automatisation en pause, lancez la synchronisation, examinez le résultat, puis réactivez-la.

Quand quelque chose ne va pas

« ActiveCampaign a rejeté la clé d’API »

Vérifiez l’URL avant toute chose : elle commence par https:// ; elle se termine par .api-us<numéro>.com et non par .activehosted.com ; le numéro du centre de données correspond à celui de votre page Développeur. Si ces trois points sont bons, recopiez la clé — une clé sélectionnée à la souris perd souvent un caractère à la fin.

Ça a fonctionné pendant des mois, puis ça s’est arrêté

Deux causes propres à ActiveCampaign. Soit quelqu’un a régénéré la clé d’API sur la page Développeur — l’ancienne clé meurt à l’instant où la nouvelle apparaît —, soit l’utilisateur ActiveCampaign à qui appartenait la clé a été désactivé ou retiré du compte. Reconnectez-vous avec une clé à jour appartenant à un utilisateur actif. Le bouton Tester de la carte vous indique de quel côté se situe le problème avant de vous lancer dans des hypothèses.

Le contact est là, mais aucun courriel n’est parti

Ouvrez la fiche du contact et procédez de haut en bas : figure-t-il seulement dans une liste ? Le statut sur cette liste est-il actif plutôt que non confirmé, désabonné ou en rebond ? Et l’automatisation attendue avait-elle un déclencheur auquel ce contact correspondait réellement ? Une automatisation activée après la création du contact n’ira pas le rechercher.

Deux contacts pour la même personne

ActiveCampaign fait la correspondance sur le courriel et rien d’autre. La même personne qui donne une adresse personnelle à un événement et une adresse professionnelle au suivant constitue bel et bien deux contacts aux yeux d’ActiveCampaign, qui ne les fusionnera pas de lui-même. Fusionnez-les dans ActiveCampaign si cela compte ; il n’y a rien à changer du côté d’Anexus.

Un contact n’est jamais arrivé

Si le formulaire d’échange a été soumis sans adresse courriel valide, il n’y a rien à envoyer : ActiveCampaign identifie les contacts par courriel et n’en accepte aucun sans adresse. Vérifiez d’abord le contact dans votre Mini CRM Anexus — si le courriel y est absent ou mal formé, vous avez votre réponse.

Se déconnecter — et pourquoi la clé est le point délicat

Cliquez sur Déconnecter dans Anexus et nous cessons immédiatement d’envoyer. Les contacts déjà présents dans ActiveCampaign y restent tels quels.

La particularité d’ActiveCampaign : la clé d’API n’est pas cloisonnée par intégration, il n’existe donc aucun interrupteur qui révoque uniquement cette connexion-ci. Si vous voulez rendre l’identifiant lui-même inutilisable plutôt que simplement inutilisé, le régénérer sous Paramètres → Développeur le tue instantanément — en même temps que tout autre outil, plateforme d’automatisation ou script pointant vers le même compte. Faites-en l’inventaire avant de cliquer.

Et ensuite

• Retour à toutes les intégrations CRM
• Gérer les contacts dans Anexus — les notes ajoutées dans le Mini CRM restent dans Anexus et n’arrivent jamais dans ActiveCampaign