Intégrer le module Q&A via flux et Iframe (méthode mixte)

Le module Q&A peut être intégré via flux et Iframe sur vos pages produits : autrement appelée, la méthdode mixte;

Pour intégrer votre module Q&A via la méthode mixte, suivez les indications ci-dessous :

1. Depuis le menu latéral gauche de votre compte Avis Vérifiés, cliquez sur Questions & Answers.
2. Cliquez ensuite sur Intégration dans le menu latéral gauche de la page qui vient de s'ouvrir.
3. Cliquez sur Intégration mixte parmi les 3 onglets disponibles.

L'intégration via flux peut se faire de deux façons :

• Appel du flux sur nos serveurs
• Lecture du flux depuis vos serveurs (dépôt quotidien du flux des produits)

Dans le cas d’un appel depuis nos serveurs, l’appel doit se réaliser avec les paramètres suivants :

{{site}} : correspond à l’identifiant Site Web de votre compte Avis Vérifiés
{{site-1}} : correspond au premier caractère de l’identifiant Site Web de votre compte Avis Vérifiés
{{site-2}} : correspond au second caractère de l’identifiant Site Web de votre compte Avis Vérifiés
{{site-3}} : correspond au troisième caractère de l’identifiant Site Web de votre compte Avis Vérifiés
{{product}} : correspond à l’identifiant de votre produit

URL :

https://cl.avis-verifies.com/medias/components/html/json/{{site-1}}/{{site-2}}/{{site3}}/{{site}}/{{product}}.json Exemple : https://cl.avis-verifies.com/medias/components/html/json/5/9/8/598b6360-e762-cf54-790a85cfdcb0bdc1/TEST.json

Poser une question

Le dépôt de question s’effectue en appelant une iframe contenant une url avec des paramètres.

{{idWebsite}} : Votre identifiant Avis-Vérifiés (obligatoire)
{{token}} : correspond à un hash sha1 de votre identifiant Site Web et de votre clef secrète (obligatoire)
{{productId}} : L'identifiant du produit de la page courante (obligatoire)
{{firstName}} : Permet de préremplir le champ prénom dans le cas d'un utilisateur connecté
{{lastName}} : Permet de préremplir le champ nom dans le cas d'un utilisateur connecté
{{email}} : Permet de préremplir le champ email dans le cas d'un utilisateur connecté
{{category}} : Permet d'attribuer une catégorie à la question
{{productPage}} : Permet de sauvegarder la fiche produit afin qu'elle soit disponible depuis le BackOffice

URL :

//cl.avisverifies.com/medias/components/html/form/question/{{idWebsite}}_question.html&idWebsite= {{idWebsite}}&token={{token}}&productId={{productId}}&firstname={{firstName}}&lastname={{la stName}}&email={{email}}&category={{category }}&productPage={{productPage}}

Réponse publique
 

Le dépôt de réponse publique s’effectue en appelant une iframe contenant une url avec des paramètres.

Trois paramètres sont obligatoires pour réussir l’appel de l’iframe. Les autres permettent par exemple du pré remplissage des champs utilisateurs. 

{{idWebsite}} : Votre identifiant Avis-Vérifiés (obligatoire)
{{token}} : correspond à un hash sha1 de votre identifiant Site Web et de votre clef secrète (obligatoire). 
{{uuid}} : UUID de la question. Il est présent dans le flux JSON (obligatoire). 
{{firstName}} : Permet de préremplir le champ prénom dans le cas d'un utilisateur connecté. 
{{lastName}} : Permet de préremplir le champ nom dans le cas d'un utilisateur connecté. 
{{email}} : Permet de préremplir le champ email dans le cas d'un utilisateur connecté.

URL :

//cl.avisverifies.com/medias/components/html/form/answer/{{idWebsite}}_answer_public.html#/?&id Website={{idWebsite}}&token={{token}}&uuid={{uuid}}&firstname={{firstName}}&lastname={{lastName}}&email={{email}}

Voter pour une question/réponse

Le vote aux questions/réponses se fait via l’API.

{{idWebsite}} : votre identifiant Avis-Vérifiés (obligatoire)
{{token}} : correspond à un hash sha1 de votre identifiant Site Web et de votre clef secrète (obligatoire)
{{query}} : action que doit effectuer l’API, ici ce paramètre vaut : « vote» (obligatoire)
{{uuid}} : uuid de la question/réponse pour laquelle l’utilisateur vote (obligatoire)
{{type}} : vote positif ou négatif pour la question/réponse. Ne peut prendre que pour valeur «up» ou «down» (obligatoire)

• Méthode POST

https://qr.netreviews.eu/apiForm.php

Paramètres :

{{idWebsite}} : votre identifiant Avis-Vérifiés (obligatoire)
{{token}} : correspond à un hash sha1 de votre identifiant Site Web et de votre clef secrète (obligatoire)
{{query}} : action que doit effectuer l’API, ici ce paramètre vaut : « vote» (obligatoire)
{{uuid}} : uuid de la question/réponse pour laquelle l’utilisateur vote (obligatoire)
{{type}} : vote positif ou négatif pour la question/réponse. Ne peut prendre que pour valeur « up » ou « down » (obligatoire)

• Méthode GET

https://qr.netreviews.eu/apiForm.php?

idWebsite={{idWebsite}}&token={{token}} &query={{query}}&uuid={{uuid}}&type={{type}}

Retours :

{success: true, code: "0X0000000", message: "success"}
{success: false, code: "0X000000?", message: "{{ERROR MESSAGE}}"}
{success: true, code: "0X0000000", message: "already_voted"}

Le code d’erreur varie en fonction du type d’erreur. Par exemple lors d’une erreur de paramètre, le code sera « 0X0000003 ». {{ERROR MESSAGE}} dépend lui aussi du type d’erreur, avec le même exemple, le message sera : « INVALID PARAMETERS »

Il n’est possible pour un utilisateur de voter qu’une seule et unique fois par questions / réponses, c’est pour cela que le message « already_voted » peut être retourné par l’API, indiquant que le vote avait déjà été pris en compte.

Signaler un élément

Le dépôt de signalement s’effectue en appelant une iframe contenant une url avec des paramètres. Trois paramètres sont requis pour réussir l’appel de l’iframe. Les autres permettent par exemple du pré remplissage des champs utilisateurs. Il n’est pas possible de signaler les réponses de modérateur. 

{{idWebsite}} : Votre identifiant Avis-Vérifiés (obligatoire). 
{{token}} : correspond à un hash sha1 de votre identifiant Site Web et de votre clef secrète (obligatoire). 
{{uuid}} : UUID de l'élément à signaler. Il est présent dans le flux JSON (obligatoire). 
{{firstName}} : Permet de préremplir le champ prénom dans le cas d'un utilisateur connecté. 
{{lastName}} : Permet de préremplir le champ nom dans le cas d'un utilisateur connecté. 
{{email}} : Permet de préremplir le champ email dans le cas d'un utilisateur connecté.

URL :

//cl.avisverifies.com/medias/components/html/form/report/{{idWebsite}}_report.html#/?&idWebsite={ {idWebsite}}&token={{token}}&uuid={{uuid}}&firstname={{firstName}}&lastname={{lastName}}& email={{email}}