• L’API GraphQL d’iAdvize
• Créer une application iAdvize
• 1 Webhook iAdvize :
• v2.conversation.closed

• 2 Plugins iAdvize :
• Customer Information
• Closing Form

• remonter des leads/contacts dans mon CRM
• remonter du contexte concernant les visiteurs et de leurs conversations dans mon CRM

• Pré-requis 1 : Récupération de votre clef API

• Pré-requis 2 : 

• Pré-requis 3 : création de votre App 

Rendez-vous à la prochaine étape pour comprendre l’utilisation de ces derniers !

2 - Je souhaite remonter des leads et du contexte sur mes visiteurs et leurs conversations dans mon CRM

Le système des webhooks permet aux applications externes de s’abonner aux événements (via les URL de callback) pour recevoir des mises à jour en temps réel. Lorsque vous créez votre application, vous pouvez vous abonner à une liste d’événements.

Dans cet exemple, j’utilise les webhooks pour : 

• remonter des leads/contacts dans mon CRM
• remonter du contexte concernant les visiteurs et de leurs conversations dans mon CRM

Webhook	Utilisation
v2.conversation.closed	A la clôture d’une conversation, un Webhook est envoyé à notre App CRM X iAdvize. Celle-ci contacte notre API pour avoir le détail de la conversation et l’enregistrer dans un objet CRM X “Conversation” et elle contacte également notre API pour avoir des informations à jour sur le visiteur afin de mettre à jour l’objet Visiteur de votre CRM X.

Pour plus d’infos sur nos autres webhooks disponibles : 

• https://developers.iadvize.com/documentation/webhooks#webhooks

3 - Je souhaite extraire des informations clefs de ma conversation pour les enregistrer dans mon CRM

Etape préalable

Pour faciliter l’analyse du contenu de la conversation et la recherche des informations clés à remonter dans votre CRM, il faut identifier de manière précise les questions qui seront posées au visiteur. Ainsi, vous saurez que les messages des visiteurs suivant ces questions correspondent aux éléments à remonter dans votre CRM.

iAdvize permet d’utiliser la syntaxe Markdown dans les messages envoyés aux visiteurs. Vous pouvez donc utiliser l’astuce suivante pour faciliter l’identification de vos questions dans le contenu de la conversation :

Pour chacune de vos questions (qui attend une réponse à remonter dans votre CRM), vous pouvez la préfixer par le code markdown suivant : [](Qn) (où n correspond à un numéro de question unique dans la conversation).

 

Ce markdown correspond normalement à un lien dont le texte est censé être indiqué entre les crochets. Comme il n’y a pas de texte renseigné entre les crochets, le lien sera invisible et n’apparaîtra pas côté visiteur.

En tapant Q1, l’agent voit sa question pré-enregistrée apparaitre - il peut donc la sélectionner


L’agent peut aussi se servir de la bibliothèque de questions/réponses pré-enregistrées en cliquant sur l’icône “liste”



Vue côté visiteur :

Le visiteur ne voit pas le markdown - il ne voit que les questions pré-enregistrées de l’agent

Après analyse de la conversation, vous pouvez repérer facilement les questions Q1 et Q2 et vous savez que les réponses se trouvent immédiatement après chacune de ces questions. Les réponses ainsi localisées pourront être enregistrées ensuite dans votre CRM.

⚠️ Le format des réponses est un format “conversation” et non pas un format “formulaire“. Il se peut alors que les réponses de visiteurs soient longues et/ou qu’elles comportent plusieurs informations dans une seule réponse.

• par un bot (de préqualification par exemple)
  
  
• en les déterminant en amont et créées dans les réponses pré-enregistrées d’iAdvize afin que les agents puissent les utiliser en cours de conversation.
  
  
  • Exemple : Pour la question [](Q1) Quel est votre modèle d'intérêt ? - L’opérateur pourra commencer à saisir dans la zone de composition Q1 et iAdvize proposera automatiquement la réponse préenregistrée correspondante.
    Il est alors possible de simplifier la vie des conseillers en ajoutant l’enchainement des questions dans les réponse pré-enregistrées dans iAdvize en intégrant le markdown permettant de lister les questions “Q1” “Q2” “Q3”…

1) Récupérer l’id de conversation

Solution recommandée

• Une fois la conversation terminée, vous pouvez récupérer l’id de celle-ci via le webhook de fin de conversation v2.conversation.closed

Solution alternative

• Si vous souhaitez récupérer le contenu de la conversation en temps réel c'est à dire, pendant que la conversation a lieu, vous pouvez vous abonner au webhook de début de conversation v2.conversation.pushed afin de récupérer l’ID de la conversation. Il faudra faire des requêtes de façon régulière car nous n’avons pas d’événement indiquant la réception d’un nouveau message. (polling)

2) Récupérer le contenu des conversations à partir de cet ID de conversation

Grâce à l’id des conversations, vous pouvez récupérer le contenu des conversations via la query conversation*.

*le contenu de la conversation se retrouve dans le field  messages



Si vous souhaitez récupérer des conversations d’un agent (ou bot) en particulier, vous pouvez vous abonner au webhook de clôture de conversation v2.conversation.closed et filtrer sur l’ID des opérateurs concernés.

• Allez dans l’admin iAdvize et recherchez votre application dans le Marketplace puis installez la. Suivez les étapes affichée et allez jusqu’au bout de l’installation.
  
  
• Une fois votre App installée, vous devriez avoir un écran similaire à celui-ci vous indiquant que votre App est installée :