Collectez les Avis 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.

Vous pouvez récupérer l’Url encodée à envoyer à votre client, ou vous pouvez demander à nos serveurs d’envoyer directement le mail d’invitation contenant l’Url.

Pour simplement récupérer l’Url encodée et l’envoyer via votre propres serveurs à votre client, utilisez l’API suivante :

https://api.securating.io/office/manager/invitation/token/url

Si vous souhaitez envoyer l’email d’invitation, automatiquement via notre serveur, utilisez l’API suivante:

https://api.securating.io/office/manager/invitation/token/mail

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.
survey_onlyParamètre de type booléen (0: faux / 1:vraie) qui indique si la sollicitation concerne uniquement un sondage par thématiques.
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 ».

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/office/manager/invitation/token/mail';

$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 :

Laisser un commentaire