Certaines interfaces nécessitent l'insertion d'une clé API, d'un identifiant de liste et/ou d'un identifiant de formulaire. Ces informations vous permettent de connecter votre compte CleverReach à une interface externe. Ces clés sont obligatoires pour se connecter, par exemple, à Magento, Veyton, Shopware et Wordpress.
Création/localisation d'une clé API
Vous pouvez trouver ces informations directement dans votre compte. Il suffit d'aller sur [Mon compte] > [Extras] > [SOAP API]. Si vous n'avez pas encore créé de clé API, vous devez insérer une clé - si votre utilisateur est autorisé à le faire. Cliquez sur [Créer une clé API] et saisissez les données.
But de l'utilisation : | nom interne à des fins administratives |
Droits d'accès : | définit les droits de la clé ("droits de lecture et d'écriture" ou "droits de lecture uniquement") |
Vous pouvez maintenant copier la clé API nouvellement créée et la saisir pour vous connecter à une interface externe.
Localisation des identifiants de liste
L'identifiant de la liste est un identifiant unique du groupe de destinataires concerné. Vous trouverez l'ID de la liste dans les paramètres généraux du groupe de destinataires sous [Paramètres] > [Général].
Localisation des identifiants de formulaires
Chaque formulaire possède un identifiant unique qui vous permet, par exemple, de déclencher le double opt-in via une interface externe (en fonction de l'interface). Vous trouverez l'ID du formulaire dans les paramètres généraux du formulaire sous [Paramètres] > [Informations].
Remarques importantes :
- La clé API créée est valable pour l'ensemble du compte. Si vous souhaitez vous connecter à plusieurs plateformes externes (par exemple Shopsystem et Wordpress), vous n'avez pas besoin de créer une nouvelle clé API pour chaque plateforme. L'ID de la liste détermine le groupe auquel un enregistrement sera affecté. Bien entendu, vous pouvez utiliser une clé API différente pour chaque plateforme externe si votre configuration l'exige.
- Lorsque vous utilisez notre API, veillez à sélectionner "Droits de lecture et d'écriture", faute de quoi aucune donnée ne sera transférée. L'option "Droits de lecture uniquement" est uniquement destinée aux connexions API qui vous permettent simplement de lire des données sans les transférer.
- Vous pouvez créer de nouvelles clés API et supprimer ou désactiver les clés existantes à tout moment. Veuillez noter que vous devez adapter votre connexion à une plateforme externe chaque fois que vous modifiez vos clés API.
- Pour obtenir un ID de liste, vous devez d'abord créer un groupe de destinataires.
- Pour obtenir un identifiant de formulaire, vous devez créer un formulaire pour le groupe de destinataires concerné.
- Si vous souhaitez utiliser l'API, vous devez vous assurer que la fonction client SOAP de votre serveur web est activée.