Configurer l'API de Trustt

Découvrez comment synchroniser les informations de Trustt avec votre CRM

SOMMAIRE 

1. Contexte

2. Créer un filtre API

3. Effectuer la requête API 

Contexte

L’API CRM Contacts permet de récupérer des informations de Trustt pour les intégrer dans une plateforme tierce. Vous pouvez par exemple automatiser l'envoi de vos optins vers votre CRM. 

Deux étapes sont nécessaires pour configurer l'API : 

• Créer un filtre API dans Trustt
• Effectuer la requête API dans la plateforme tierce 

Créer un filtre API 

Se rendre dans API et créer le filtre 

Dans Trustt au niveau de la marque, cliquez sur :

(1) "Contacts"

(2) "API"

(3) "Nouveau filtre". 

Créer le filtre 

(1) Choisissez les conditions de votre filtre. Vous pouvez par exemple créer un filtre pour récupérer les informations des optins. 

(2) Cochez les informations que vous devez récupérer. Notez que la date d'ajout, l'email et optin sont cochés par défaut. 

(3) Nommez votre filtre.

Il vous suffit maintenant d'enregistrer le filtre. 

Copier l'url du filtre 

Sur la page des filtres existants, cliquer sur "Copier" pour récupérer l’URL de la requête.

Effectuer la requête API 

Requête 

Dans votre plateforme tierce, vous devez appeler https://app.trustt.io/api_contacts en GET avec les trois paramètres suivants :

Réponse

En cas de succès, un code HTTP 200 est retourné avec ces données JSON :

{

    "nbContacts": XXX,

    "contacts": […]

    "next": ”XXX”

}

Notez que “contacts” est un tableau de maximum 500 objets avec les colonnes sélectionnées au moment de la création du filtre 

[

    {

"email": "xxxx@gmail.com",

"isOptin": true/false,

"dateAdd": "YYYY-MM-DD hh:mm:ss"

    }

]

La propriété “next” est présente si le nombre de contacts est supérieur à 500. Sa valeur sera à ajouter en paramètre à la prochaine requête pour récupérer les 500 contacts suivants.

Gestion des erreurs

Erreur - API key invalide

Si la valeur du paramètre apiKey est invalide, un code HTTP 401 est retourné avec ces données JSON :

{"data": {"error": "Unauthorized"}}

Erreur - Filtre non trouvé

Si le filtre n’existe pas dans les bases de données Trustt, un code HTTP 404 est retourné avec ces données JSON :

{"data": {"error": "Filter not found"}}

Erreur - Paramètre invalide

Si un paramètre est mal formaté, un code HTTP 422 est retourné avec ces données JSON :

{"data": {"error": "Invalid parameter found"}}

Erreur - erreur applicative

Si une erreur applicative survient lors de l’appel, un code HTTP 500 est retourné avec ces données JSON :

{"data": {"error": "Error"}}