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

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

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 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 > API.
  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 le endpoint « Find a business unit ». Le paramètre requis ici est le « nom » de l'unité commerciale, comme par exemple le domaine de votre site internet. Ainsi, si vous souhaitez rechercher le BUID de Trustpilot, saisissez « trustpilot.com ».

Essayez vous-même et pensez à remplacer la clé API.

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

Après avoir 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 la page des statuts 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 extrêmement 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 (redirectURI)

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 incluant http/https. Par exemple, https://example.com serait valide, mais example.com ne le serait pas.

Pour plus d'informations sur la façon de démarrer avec l'authentification API privée de Trustpilot, consultez cet article. 

Related articles