Objectif

Permettre à des applications externes de pouvoir souscrire à des événements iAdvize (via des urls de callback) pour recevoir des mises à jour en temps réel et déclencher un workflow automatisé.

De quoi aurais-je besoin ?

Créer une application iAdvize
Souscrire au Webhook de son choix
Créer un workflow avec une application pour déclencher l’action souhaitée

Use case

L’envoi d’un email en fin de conversation
L’envoi d’un code promo en fin de conversation
Capture de lead ou enrichissement de lead
Envoi d’une enquête fin de conversation
Dashboard suivi de CSAT en temps réel
Création de ticket dans un système externe

Marche à suivre

Pré-requis : identifier quel événement doit déclencher l’action que vous souhaitez mettre en place :

Exemples :

conversation.started
v2.conversation.pushed
v2.conversation.closed
visitor.updated
satisfaction.answered

ETAPE 1 : On surveille l’évènement Webhook (exemple clôture de la conversation)

Créez un compte ou connectez-vous à la plateforme developers
Créez votre application
Souscrivez au webhook de votre choix

Installez votre application dans la section marketplace depuis l’admin iAdvize

Exemple de payload :

V2.conversation.closed

{
"eventId": "0f0bb3af-5035-4ba3-b3fb-ff4879a3a74d",
"eventType": "v2.conversation.closed",
"platform": "ha",
"projectId": 1549,
"clientId": 335,
"conversationId": "4c8c7408-f73c-42cd-89e9-afbbee7d9024",
"operatorIds": [
15253,
15254
],
"visitorExternalId": "63429889", // déprécié. Disponible uniquement pour les conversations ONSITE. Utilisez le champ `visitorId` à la place.

"channel": "CHAT",

"visitorId": "b05f1b45-c891-4a9c-b47e-91ee6c8ffb44",

"createdAt": "2019-04-12T07:58:35.171Z",
"sentAt": "2019-04-12T07:58:35.496Z"
}

ETAPE 2 : Déclencher un appel à notre API REST/GraphQL pour récupérer la donnée recherchée (email, CSAT, contenu de la conversation….)

Dans cette étape nous allons récupérer l’email du visiteur via l’API REST en utilisant l’ID du visiteur récupéré lors de l’étape 1.

Effectuer une requête HTTP de type “GET” en précisant l’URL de la ressource (visitor) que nous cherchons à récupérer ainsi que l’ID (contact) dont nous voulons le détail GET /visitor/560.
Vérifier le champ email

ETAPE 3 : Déclencher l’action souhaitée avec l’outil de votre choix (envoi d’un email, création d’un dashboard, création d’un lead dans votre CRM…)

Schéma

Utilisation des webhooks événements pour créer une expérience sur mesure