Déclencher l'envoi d'invitations en utilisant les APIs de Trustpilot

Cette fonctionnalité fait partie du module complémentaire Connect.

Vous pouvez utiliser une API Trustpilot pour déclencher des invitations à laisser un avis marchand qui seront envoyées par Trustpilot. Lisez ce guide pour découvrir comment les configurer.

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 déclencher des invitations 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.

Déclencher une invitation à laisser un avis marchand

Une fois que vous avez votre access token, vous pouvez utiliser notre API endpoint « Create invitation(s) ». Cette requête JSON pour un API call requiert le nom du client, l'adresse e-mail et un numéro de référence tel qu'un identifiant de commande ou un numéro de facture. Il existe également plusieurs options d'expéditeur que vous pouvez personnaliser. Voici un exemple de requête JSON :

    {
      "consumerEmail": "jean.dupont@trustpilot.fr",
      "consumerName": "Jean Dupont",
      "referenceNumber": "ref00001",
      "replyTo": "jean.dupont@trustpilot.fr",
      "locale": "fr-FR",
      "senderEmail": "jean.dupont@trustpilot.fr",
      "serviceReviewInvitation": {
      "preferredSendTime": "2013-09-07T13:37:00",
      "redirectUri": "http://fr.trustpilot.com",
      "tags": [
        "tag1",
        "tag2"
      ],
      "templateId": "507f191e810c19729de860ea"
     },
      "locationId": "ABC123",
      "senderName": "Jean Dupont"
    }

Les API calls réussis placeront en file d'attente les invitations dans Trustpilot Business, que vous pouvez voir en vous connectant à votre compte et en consultant l'historique des invitations.

Ignorer certaines options d'expéditeur telles que « senderEmail », « templateId » ou « preferredSendTime » ne pose pas de problème. Cet API endpoint utilisera automatiquement les paramètres activés dans les réglages des invitations de votre compte Trustpilot Business.

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