Connexion API : fonctionnalités des bots

iAdvize vous permet de déployer de nouvelles capacités conversationnelles en utilisant vos sources de données (informations sur l’état de livraison, informations produit, données CRM, données personnalisées disponibles via les API. . . ) directement dans votre stratégie d’automatisation du bot.

Grâce à l’intelligence augmentée connectée d’iAdvize, les bots pourront traiter des demandes simples et répétitives en toute autonomie, permettant à vos conseillers de se concentrer sur des conversations de plus grande valeur qui requièrent leur expertise.

Quels sont les prérequis ?

- Travailler avec une API GraphQL ou Rest API
- Votre API doit retourner les charges utiles JSON
- Idéalement, avoir un minimum de connaissances API ou inclure les développeurs dans le processus de connexion de votre API à iAdvize et de création d’un scénario de bot avec une connexion API

Les avantages pour vos visiteurs

Les visiteurs peuvent obtenir des informations personnelles auprès d’un bot, concernant leur compte, leurs commandes ou toute autre information que votre marque détient sur eux et qui peut être extraite de l’API de votre entreprise.

Par exemple : obtenir le statut de leur dernière commande.

API_1.png

 

Ils peuvent également obtenir des suggestions de produits personnalisées, d’un bot, qui seront tirées de l’API de votre catalogue et qui leur seront suggérées en fonction de critères tels que les produits de leurs achats antérieurs.

Par exemple, le top 3 best-sellers de l’année dans la catégorie des casques Bluetooth, ou la pompe qui s’adapte au vélo acheté le mois dernier.

API_2.png

 

Le bot peut suggérer aux visiteurs des liens vers des articles de la FAQ ou de la base de connaissances de votre marque, en répondant aux questions qu’ils ont posées.

Par exemple, le bot pourrait envoyer un lien vers l’article expliquant comment récupérer son mot de passe.

API_3.png

 

Configuration de votre connexion API

En tant qu’administrateur, connectez votre API.

Vous pouvez connecter votre API à la plateforme iAdvize, en allant dans la section Automation, sous-section Connexion API.

API_4.png

 

A partir de là, configurez les "inputs" dans votre connexion API : c’est l’information que vous voudrez demander aux visiteurs dans le scénario bot.

Par exemple, leur ID client.

API_5.pngAPI_6.png

NB. Il est également possible de définir des données personnalisées (Custom Data) en tant qu'input de votre connexion API.
Voici la nomenclature à respecter dans ce cas : customData.<mon_libelle_custom_data>
ex : customData.cust_email

 

Vous pouvez ensuite fournir un token de sécurité ou un mot de passe afin de vous connecter en toute sécurité à votre API. Ils seront chiffrés avant d'être stockés dans la base de données iAdvize; après la sauvegarde de la configuration de votre API, seuls les 4 derniers caractères seront affichés (comme on le voit sur la capture d’écran).

API_7.png

 

Ensuite, vous pouvez saisir l’URL de votre API et choisir

- la méthode GET si vous souhaitez utiliser des données de votre API
- la méthode POST si vous voulez envoyer des données à votre API.
- la méthode PUT si vous voulez mettre à jour des données à votre API.

Si votre API utilise des paramètres dans l’URL, vous pouvez les fournir ici (voir exemple sur la capture d’écran avec le paramètre {order_id}). Veuillez noter que le format du paramètre peut être différent dans votre API.

API_8.png

 

Si votre API utilise des en-têtes, vous pouvez fournir les clés et les valeurs ici.

API_9.png

 

Si vous souhaitez envoyer des données à votre API en configurant une API POST, vous pouvez fournir votre corps de requête en JSON ici.

Exemple: envoyer l’e-mail d’un client à votre CRM.

API_10.pngAPI_11.png

 

Ensuite, vous pouvez configurer les données extraites dont vous aurez besoin, c’est-à-dire les informations que votre bot pourra renvoyer aux visiteurs dans son scénario.

Exemple: statut de la commande.

API_12.jpeg

API_13.png

 

Ensuite, testez votre connexion API pour vous assurer que tout est bien configuré!

API_14.png

 

NB. Il peut arriver qu'une requête API échoue. Voici les raisons pour lesquelles l’action alternative en cas d’échec de la requête doit être activée (liste non exhaustive) :

Il n’y a pas de réponse de l'API connectée:
- Le serveur de l'API ne réponds plus
- URL incorrectement configurée dans la connexion API
- L'API a besoin d'un token / de s'authentifier
- L'API met plus de 6 secondes à répondre

Il y a une réponse API mais elle mal configurée dans la connexion API ou l'API client:
- Chemin JSON mal configuré dans la connexion API
- Variable vide

La requête du visiteur n'est pas au bon format :
- Si le texte du visiteur ne correspond pas au format de réponse configuré (texte, montant d’argent, distance, durée etc. )

 

Utilisation de votre connexion API dans votre scénario de bot

Maintenant que votre connexion API est pleinement opérationnelle, vous pouvez l’utiliser dans des scénarios de bots pour poser des questions aux visiteurs et obtenir automatiquement une réponse de votre bot avec des informations personnalisées de votre API.

Par exemple: demander à un visiteur son ID de commande et répondre automatiquement avec le statut de la commande.

Pour ce faire, vous devrez utiliser à la fois la carte Connexion et la carte Rich contenu dans votre scénario de bot.

API_15.png

 

En savoir plus :
- Configurer un bot scenario
- Connectez les bots à vos applications