Collectez les avis client via l’API

Vous pouvez utiliser l’API de Securating pour envoyer des invitations à vos clients afin qu’ils vous donnent leur avis sur vos produits et/ou services.

Pour cela rien de plus simple.

Avec Securating les avis sont récoltés directement sur votre site Internet à l’aide d’une Url encodée.

Pour envoyer l’email d’invitation, automatiquement via notre serveur, utilisez l’API suivante:

https://api.securating.io/invitation/create

Ces deux API utilisent les mêmes paramètres, qui doivent être envoyés à l’aide d’une requête HTTP POST.

PARAMETRESDESCRIPTIONS
keywebsiteLa clé de vérification de votre site internet.
emailL’email de votre client.
first_nameLe prénom de votre client.
last_nameLe Nom de votre client.
company_nameLe nom de votre entreprise ou service.
productLe code produit concernant votre avis. Si la référence n’existe pas elle est créé à la volée.
product_eanCode EAN utilisé lors pour la mise à jour du produit.
product_descDescription commerciale utilisé pour la mise à jour du produit.
survey_onlyParamètre de type booléen (0: faux / 1:vraie) qui indique si la sollicitation concerne uniquement un sondage par thématiques.
force_invitationL’API ne permet pas la création d’invitations successives trop rapprochées dans le temps ( < 24 heures) pour un même email.
En positionnant ce paramètre avec une valeur quelconque, l’API vous permettra de passer outre cette vérification.
Il est conseillé de ne positionner ce paramètre que dans des phase de tests.
thematicsLes codes thématiques concernant votre avis. Vous pouvez renseigner aux maximum trois codes séparées par une virgule (Voir la liste de code) .
urlL’url vers sur laquelle vous souhaitez récolter l’avis.
daysLe nombre de jour d’attente avant d’envoyer l’invitation par mail à votre client. Par default un délais de 6 jours est appliqué.
recall_countNombre de relance à effectuer, tant que le client n’a pas donner son avis, la valeur par défaut est de 3 relances.
profile_idIdentifiant du modérateur à l’origine de la demande de sollicitation. Ces identifiants doivent préalablement créés depuis votre manager. Ce paramètre est optionnel.
webhookUrl d’alerte informant des changements d’état de la sollicitation. Par exemple si l’url indiqué est « https://ws.monsite.com/securating?id=123456 ».

Nos robots contacteront votre url en ajoutant un paramètre step.
step=invitation-created: lors de la réception de la demande
step=mail-send: lors de l’envoi du mail d’invitation
step=mail-recall: lors de l’envoi d’une relance.
step=link-opened: lorsque votre client a affiché le formulaire de sais d’avis.
step=review-saved: lorsque votre client aura enregistré son avis.

A l’étape « review-saved« , des paramètres supplémentaires sont ajoutés:
– « rating » indique la note donnée avec l’avis.
– « comment » contient le commentaire associé à l’avis (codé en base64)

Nos robots attendent un retour contenant « ok » ou « success ».
customer_genderLa civilité de votre client (dans le cadre d’un avis professionnel B2B).
customer_bioLe poste occupé de votre client (dans le cadre d’un avis professionnel B2B).
customer_linkL’url du site web de votre client (dans le cadre d’un avis professionnel B2B).
customer_avatarL’url du logo de votre client (dans le cadre d’un avis professionnel B2B).
meta_<keys>Informations retournées via les web_hook sans traitement particulier.
hashtagLe hashtag a associer à l’Avis lors de sa création
with_giftParamètre de type booléen (0: faux / 1:vraie) qui indique si une contrepartie est donnée en échange de l’Avis.
gift_descriptionDescription du type de contrepartie à associer à l’Avis
from_orderParamètre de type booléen (0: faux / 1:vraie) qui indique si l’Avis fait suite à une commande.
order_<fields>Informations associées au produit ou au service commandé.
order_date: La date de la commande
order_number: Le numéro de la commande
order_item_type: le type d’item [product/service] de commande
order_item_code: Le code de l’item
order_item_desc: La description de l’item
order_service_start: La date de début du service
order_service_end: La date de fin du service

L’exemple ci-dessous vous montre une utilisation en language PHP.

<?

function httpPost($url, $data){
	$options = array(
		'http' => array(
     		'header'  => "Content-type: application/x-www-form-urlencoded\r\n",
        	'method'  => 'POST',
        	'content' => http_build_query($data)
    	)
    );
	$context  = stream_context_create($options);
	return file_get_contents($url, false, $context);
}

$api = 'https://api.securating.io/invitation/create';

$returnedLink = httpPost(
	$api,
	array(
		'keywebsite' => 'ma-cle-de-verification',
		'email' => 'mon-email-ici',
		'first_name' => 'prenom-de-mon-client-ici',
		'last_name' => 'nom-de-mon-client-ici',
		'company_name' => 'mon-entreprise-ici',
		'days' => '0',
		'product' => '25:0001',                    
		'thematics' => '1000100,1000200,1000400',                    
		'url' => 'https://mon-site-web/ma-page-web'
	)
);


echo 'link: <a href="'.$returnedLink.'">Click on me</a>';

?>

Votre clé de vérification est disponible en téléchargement depuis la rubrique site de votre manager. C’est la même clé utilisée pour la vérification de votre site.

Tester l’API en recevant une invitation à déposer un avis sur Securating.com

Votre adresse électronique :
Votre Prénom :
zéro moins huit ( 1 , 5 , -3 , 24 , …)

Laisser un commentaire