Catégorie : api

Vous pouvez sonder vos clients ou utilisateurs sur un ensemble de thématique prédéfinie.

Pour cela rien de plus simple.

Lors de la création des invitations via vos appels de l’api, renseignez simplement le paramètre « thematics » avec la liste des codes de sondage correspondant à vos questions.

Lors de la création manuelle de vos invitations depuis votre manager, renseignez le champ « thematics« , avec la liste des codes que vous souhaitez proposer.

Le code thématique est composé d’une suite de 7 chiffre comme suit :

[V][LL][R][TTT]

[V]: Visibilité du sondage  [1,2] 
  "1" sondage accessible aux webmasters.     
  "2" sondage accessible  aux webmasters et aux internautes. 

[LL]: Langue de la thématique
 "00": Français. 
 "01": Anglais.

[R]: Réservé

[TTT]: Index de la thématique.  
 "100": Accueil téléphonique.
    ...
 "900": Cadre de travail.
  

Exemple de codes thématiques génériques en Français, la liste complète est disponible depuis le manager.

Code	Thématiques	Explication affichée à votre client
1000100	Que pensez-vous de l’accueil téléphonique ?	Que diriez-vous de la qualité des conseils , de votre attente téléphonique ou de la qualité de l’écoute ?
1000200	Que pensez-vous de la préparation de commande ?	Que diriez-vous du respect de vos consignes par exemple ?
1000300	Le support technique a-t-il répondu à votre demande ?	Que pourriez-vous dire par exemple de la compétence de l’opérateur ou de son écoute ?
1000400	Qu’avez-vous pensé de votre livraison ?	Que pensez-vous de la rapidité de la livraison ? Que diriez-vous de la l’emballage à la réception ?
1000500	Notre produit est-il conforme à vos attentes ?	Que diriez-vous de la description de ce produit par exemple ?
1000510	Notre service est-il conforme à vos attentes ?	Dites-nous par exemple, si notre service vous a fait gagner du temps ou vous a été utile.
1000520	Notre intervention est-elle conforme à vos attentes?	Que pouvez-vous nous dire sur cette installation ?
1000530	Avez-vous été satisfait de votre séjour ?	Par exemple, le séjour était conforme à vos attentes, l’accueil a été aimable.
1000600	Êtes vous satisfait de notre service après-vente ?	Que diriez-vous sur les réponses que nous avons apportées à vos vos questions, par exemple.
1000800	Êtes vous satisfait de votre installations ?	Votre installation c’est passée dans les temps prévus ? Votre installation est confirme à vos attentes ?
1000900	Êtes vous satisfait du cadre de votre travail ?	Que pensez-vous par exemple, de la convivialité de l’équipe ou de l’intérêt des projets qui vous son confiés ?

Vous pouvez aussi ajouter votre propres code de sondages depuis votre manager, ces thématiques vous seront alors réservées.

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.

PARAMETRES	DESCRIPTIONS
keywebsite	La clé de vérification de votre site internet.
email	L’email de votre client.
first_name	Le prénom de votre client.
last_name	Le Nom de votre client.
company_name	Le nom de votre entreprise ou service.
product	Le code produit concernant votre avis. Si la référence n’existe pas elle est créé à la volée.
product_ean	Code EAN utilisé lors pour la mise à jour du produit.
product_desc	Description commerciale utilisé pour la mise à jour du produit.
survey_only	Paramètre de type booléen (0: faux / 1:vraie) qui indique si la sollicitation concerne uniquement un sondage par thématiques.
force_invitation	L’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.
thematics	Les codes thématiques concernant votre avis. Vous pouvez renseigner aux maximum trois codes séparées par une virgule (Voir la liste de code) .
url	L’url vers sur laquelle vous souhaitez récolter l’avis.
days	Le 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_count	Nombre de relance à effectuer, tant que le client n’a pas donner son avis, la valeur par défaut est de 3 relances.
profile_id	Identifiant 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.
webhook	Url 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_gender	La civilité de votre client (dans le cadre d’un avis professionnel B2B).
customer_bio	Le poste occupé de votre client (dans le cadre d’un avis professionnel B2B).
customer_link	L’url du site web de votre client (dans le cadre d’un avis professionnel B2B).
customer_avatar	L’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.
hashtag	Le hashtag a associer à l’Avis lors de sa création
with_gift	Paramètre de type booléen (0: faux / 1:vraie) qui indique si une contrepartie est donnée en échange de l’Avis.
gift_description	Description du type de contrepartie à associer à l’Avis
from_order	Paramè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