Générer des liens d'invitation en utilisant les APIs de Trustpilot

Cette fonctionnalité fait partie du module complémentaire Connect, qui peut être acheté en supplément des packs Premium et Advanced, et est inclus dans le pack Enterprise.

Vous pouvez utiliser une API Trustpilot pour générer des liens d'invitation qui peuvent être envoyés par l'intermédiaire de vos propres e-mails ou différents moyens de communication avec vos clients. Lisez ce guide pour découvrir comment générer des liens d'invitation uniques en utilisant une API Trustpilot.

Vous pourriez avoir besoin de l'aide d'un développeur.

Trouver votre clé API et votre clé secrète

Si votre compte dispose d'un accès API, vous pouvez créer et gérer vos clés API en suivant les étapes ci-dessous ou en vous rendant sur cette page.

  1. Sur Trustpilot Business, allez à Intégrations > Développeurs > APIs.
  2. Sous Créer une nouvelle application, nommez votre application et saisissez les domaines que vous souhaitez inclure. Cliquez sur Créer l'application.
  3. Vous trouverez l'application sous Vos applications. Cliquez sur le menu déroulant pour voir plus d'informations et trouver votre clé API et votre clé secrète.

Trouver votre Business Unit ID (BUID)

Votre Business Unit ID est un identifiant unique spécifique à votre domaine. Il est statique et ne changera que si votre domaine sur Trustpilot change. Pour trouver le BUID de votre domaine, vous devez utiliser l'endpoint « Find a business unit ». Le paramètre requis ici est le « nom » de l'unité commerciale, par ex. le domaine de votre site web. À titre d'exemple rapide, si vous souhaitez rechercher le BUID de Trustpilot, vous devriez saisir « trustpilot.com ».

Essayez vous-même et n'oubliez pas de remplacer la clé API.

https://api.trustpilot.com/v1/business-units/find?apikey={{apikey}}&name=trustpilotdemo.com

Une fois que vous avez reçu la réponse, vous devrez trouver le champ « id ». Ceci est votre BUID pour le domaine que vous venez de rechercher.

Authentification avec OAuth 2.0

Afin d'utiliser n'importe quel API endpoint privé sur Trustpilot, une authentification est requise sous forme d'un access token (jeton d'accès). Étant donné que générer des liens d'invitation est considéré comme un endpoint privé, l'objectif ici sera d'obtenir d'abord un access token, que vous pourrez réutiliser pour plusieurs API calls tant qu'il est valide. Une fois expiré, vous pouvez actualiser le token. Consultez cette page si vous voulez plus de détails et accéder à notre documentation sur l'authentification.

Pour les intégrations du côté serveur, nous recommandons l'utilisation de Grant Type: Password.

Générer un lien d'invitation à laisser un avis marchand

Une fois que vous avez votre access token, vous pouvez utiliser notre API endpoint « Generate service review invitation link ». Cette requête JSON pour un API call requiert le nom du client, l'adresse e-mail, le code de localisation et un numéro de référence tel qu'un identifiant de commande ou un numéro de facture. Voici un exemple de requête JSON complète :

    {
        "referenceId": "facture00001",
        "name": "Jean Dupont",
        "tags": [
          "tag1", 
          "Tag2"
        ],
        "locale": "fr-FR",
        "email": "jean.dupont@trustpilot.fr", 
        "redirectUri": "http://trustpilot.fr"
    }

Cet API call va générer un lien d'invitation unique que vous pouvez envoyer directement à vos clients.

Dans cette requête, vous remarquerez également des balises facultatives et des champs redirectUri. Voici une vue d'ensemble pour vous aider à mieux comprendre :

Balises facultatives

Les balises facultatives sont des données supplémentaires spécifiques sur le client ou son achat auxquelles vous avez accès. En les ajoutant au code avant que l'avis ne soit publié, vos avis seront balisés avec des données hyper pertinentes, permettant une analyse plus détaillée et un affichage des avis hautement personnalisé.

Les caractères valides sont a-z, A-Z, 0-9, tiret bas, tiret et point. Les espaces ne sont pas autorisés.

URI de redirection (Redirect URI)

Une URI de redirection (redirectUri) vous permet de rediriger le client vers n'importe quelle page web de votre choix une fois qu'il a publié son avis. Si vous ne remplissez pas le champ redirectUri, les auteurs d'avis seront redirigés vers une page Trustpilot qui confirme la publication de l'avis. Si vous souhaitez les rediriger vers une page personnalisée sur votre site web, telle que votre propre page de remerciement ou simplement votre page d'accueil, vous pouvez le faire.

Assurez-vous d'utiliser une URL complète qui inclut « http » ou « https » (par ex. https://exemple.fr fonctionnera, mais exemple.fr ne fonctionnera pas).

Related articles