Vous avez la possibilité d'envoyer vos preuves d'achat/service en toute autonomie, grâce à la méthode d'automatisation API.
Si votre page d'accueil affiche l'alerte suivante, prenez connaissances des informations ci-dessous pour bénéficier de la nouvelle méthode de collecte, ou contactez nos équipes pour vous accompagner :
✨ Nouvelle Plateforme
Prérequis
Nous vous conseillons de nous transférer les commandes des 3 derniers mois pour collecter des avis pertinents.
Configuration
- Rendez-vous dans le menu latéral gauche
Paramètres, puis Récupération des commandes.
- Choisissez alors API dans le bandeau de configuration.
- Cliquez sur le bouton permettant de créer votre compte API.
- Une fois le compte créé, vous pouvez visualiser vos paramètres API : URL, Identifiant site web et Clé secrète.
- Générez votre clé secrète en cliquant sur Voir la clé.
En cas de problème, vous pourrez à nouveau générer cette clé.
Structurer et envoyer la requête
L'API Skeepers utilise OpenID Connect Client Credential grant pour authentifier les requêtes. Dans ce mode, ce n'est pas un utilisateur précis qui est authentifié : ce sont vos identifiants client qui sont vérifiés, puis un access_token générique est renvoyé.
Cette autorisation (OpenID Connect Client Credential grant) est utilisée pour l'authentification de machine à machine.
https://auth.skeepers.io/realms/skeepers/protocol/openid-connect/token
-
Authorization: Set to
Basic <base64 encoded "clientId:clientSecret"> -
Content-Type: Set to
application/x-www-form-urlencoded
-
grant_type: Set to
client_credentials -
scope: Set to
openid
POST https://auth.skeepers.io/realms/skeepers/protocol/openid-connect/token HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Authorization: Basic <base64 encoded "clientId:clientSecret">
grant_type="client_credentials" & scope="openid"
Veuillez cliquer sur ce lien (Swagger) afin d’avoir accès au guide pour paramétrer et simuler vos requêtes de preuves d’achat ou prestation de service.
C'est ici, dans la partie Authentication que vous devrez ajouter l'identifiant de votre site web :
Retrouver les codes d'intégration
Pour retrouver votre clé secrète et l'identifiant de votre site web :
- Rendez-vous dans le menu latéral gauche d'Avis Vérifiés
Administration, puis
Mon compte.
- Les informations se trouvent alors à droite de la page dans la partie Code d'intégration.
Suivre la collecte
Vous avez la possibilité de vérifier la transmission et l'intégration de vos preuves d’achat/service ainsi que l'état de la demande d'avis.
Pour cela, rendez-vous dans le menu latéral gauche Collecte, puis Suivi des demandes d'avis
Si vous souhaitez collecter uniquement des avis marque, vous devez retirer la variable produit de votre appel API.
En savoir plus dans la documentation API : Submit Purchase Event > solicitation_parameters > purchase_event_type.