Avec l’intégration Agillic, chaque personne qui s’inscrit est créée ou mise à jour comme destinataire dans Agillic. Agillic n’utilise pas de listes ici : les destinataires sont ajoutés à vos données Agillic, et vous construisez vos groupes cibles dans Agillic.
Ce dont vous avez besoin
- Un compte Agillic sur la plateforme européenne d’Agillic, et un utilisateur qui peut créer des clés d’API (généralement un administrateur).
Étape 1 : créer une clé d’API dans Agillic
- Dans Agillic, ouvrez Settings et trouvez les clés d’API (API credentials).
- Créez une nouvelle clé et donnez-lui un nom que vous reconnaissez, par exemple « Scratcher ».
- Copiez la Developer key (aussi appelée API key) et le Secret. Le secret ne s’affiche qu’une seule fois.
Les autorisations dont la clé a besoin
Scratcher utilise la clé pour lire vos champs de données personnes (person data), retrouver les destinataires par e-mail, et créer et mettre à jour des destinataires. Si Agillic vous permet de limiter la clé, elle a besoin d’un accès en lecture et en écriture aux destinataires et d’un accès en lecture aux données personnes. Aucun autre accès n’est nécessaire.
Étape 2 : connecter Agillic à Scratcher
- Dans Scratcher, allez dans Paramètres > Intégrations et cliquez sur Agillic.
- Collez la Developer key et le Secret.
- Cliquez sur Installer l’intégration. Scratcher se connecte à Agillic pour les vérifier.
Étape 3 : l’activer dans une campagne
- Dans l’éditeur, allez dans Connecter > Intégrations > Agillic et cliquez sur Activer.
- Si vous avez connecté plusieurs comptes, choisissez-le sous Choisir un compte.
- Sous Correspondances de champs, associez chaque Champ Scratcher à un champ de données personnes Agillic.
- Sous Champ e-mail unique, choisissez le champ Agillic que vous utilisez pour l’e-mail : « Choisissez le champ Agillic que vous utilisez pour l’e-mail (assurez-vous qu’il est également unique dans Agillic) ». Seuls les champs texte uniques sont listés. Si vous le laissez vide, Scratcher utilise le champ EMAIL.
- Sous Filtrer par consentements (facultatif), choisissez votre case de consentement marketing, pour n’envoyer que les personnes qui ont dit oui.
- Cliquez sur Enregistrer, puis sur Tester.
Bon à savoir : Agillic n’a pas de liste à choisir, Scratcher commence donc à envoyer dès que vous cliquez sur Activer. Activez l’intégration avant la mise en ligne de la campagne, ou configurez-la tout de suite.
Correspondance des champs
- L’adresse e-mail est toujours envoyée vers le champ e-mail unique. Vous n’avez pas besoin de l’associer.
- La liste des champs affiche vos données personnes Agillic, avec leurs types. Les dates sont envoyées au format d’Agillic, par exemple 31.12.2025.
- Si vous avez un champ de données personnes pour l’opt-in, associez-y le champ Accepté d’un consentement.
Ce qui est envoyé, et quand
Scratcher recherche le destinataire par e-mail. S’il n’existe pas, il est créé ; sinon, il est mis à jour. Les nouveaux inscrits sont envoyés en une à deux minutes, et les leads existants sont envoyés quand vous activez l’intégration. Sous Paramètres > Intégrations > Statut de livraison, vous voyez si chaque lead était nouveau ou existait déjà dans Agillic.
Dépannage
- « Agillic API request failed with status code ... » : Agillic n’a pas accepté la requête. 401 ou 403 signifie que la clé a été supprimée ou n’a pas les accès nécessaires ; connectez une nouvelle clé.
- Un message d’Agillic au sujet d’un champ : une valeur ne correspond pas au type du champ, ou un champ obligatoire manque. Vérifiez les correspondances.