Connecter Zapier, Integromat ou tout autre application tiers à votre chatbot grâce au connecteur JSON API

Connecter Zapier, Integromat ou tout autre application tiers à votre chatbot grâce au connecteur JSON API

07 Apr, 2020 740 Bot Messenger
Imprimer la rubrique

 

Le connecteur API JSON, est un module de KiliBot qui permet l'envoie des données en format JSON à n'importe quelle URL externe que vous avez fournie. Une fois qu'un événement spécifique mentionné ci-dessous est déclenché, le système envoie des données JSON à l'URL de votre webhook fourni et il attend 10 secondes pour obtenir une réponse. Si le système ne reçoit pas de réponse dans les 10 secondes, il enverra une autre demande de poste à votre webhook. Vous pouvez alors traiter vos données comme vous le souhaitez. Cette fonction peut être utilisée pour connecter notre système avec une application tierce comme Zapier, Integromat ou votre propre application personnalisée.

Avant de commencer :

  • Vous devez avoir un compte Facebook existant et actif.

  • Vous devez préalablement avoir importé votre page Facebook sur KiliBot et la connexion bot activé.

Pour savoir comment importer une page Facebook sur KiliBot c'est par ici

 

Créer une connexion JSON : 

  • Connecter vous à votre compte KiliBot
  • Rendez-vous dans la section "Bot Messenger"

 

  • Une fois dans la section "Bot Messenger", rendez-vous dans l'onglet "KiliConnect : Connecteur JSON API"

 

 

Vous accédez à présent à la liste de vos connexions JSON API

Ce espace vous permet de créer de et de gérer toutes vos connexions JSON API 

Pour créer une nouvelle connexion, cliquez sur le bouton "Nouvelle connexion", et renseigner les différents champs suivant les indications ci-dessous :

 

  • Nom de la connexion : C'est le champ de ce qui sera votre nom de connexion.
  • URL du webhook : C'est le champ de l'URL du webhook pour recevoir des données. Vous pouvez mettre n'importe quelle URL de webhook dans ce champ pour recevoir des données que vous pouvez obtenir de n'importe quelle application tierce comme zapier ou votre propre application personnalisée. Le système enverra les données à l'URL du webhook que vous avez fournie en format JSON comme ci-dessous et il attendra 10 secondes pour obtenir une réponse.

 

{  
                       "psid":"12765xxxx",
                       "first_name":"KiliBot",
                       "last_name":"Konnect,
                       "subscribed_at":"2020-01-25 12:20:04",
                       "email":"[email protected]",
                       "labels":"Demo,Demo Label, Kilibot-test",
                       "page_id":"37674343246",
                       "page_name":"Test Page",
                       "phone_number":"+000000000",
                       "user_location":"",
                       "postbackid":""
                    }
  • Sélectionnez une page : Dans cette section, vous verrez la liste de vos pages, vous devez donc sélectionner la page à partir de laquelle vous voulez collecter les données.
  • Quel changement déclenche l'envoi des données ?

 

Afin que le connecteur JSON API se déclenche et envoi des données à votre URL Webhook certains événements ou changement doivent se produire. Il y a au total 6 changements déclencheurs possibles sur KiliBot :

  • Email : Cela signifie que lorsque tout nouvel e-mail est collecté dans votre chatbot, alors la connexion ce déclenche et les données de vos choix sont envoyées à l'URL de webhook indiqué.
  • Numéro de téléphone : Cela signifie que lorsqu'un numéro de téléphone est collecté dans votre chatbot, alors la connexion ce déclenche et les données de vos choix sont envoyées à l'URL de webhook indiqué.
  • Emplacement : Cela signifie que lorsque l'emplacement d'un abonné est collecté dans votre chatbot, alors la connexion ce déclenche et les données de vos choix sont envoyées à l'URL de webhook indiqué.
  • Date de naissance : Cela signifie que lorsque une date de naissance est collecté dans votre chatbot, alors la connexion ce déclenche et les données de vos choix sont envoyées à l'URL de webhook indiqué.
  •  Postback id : Cela signifie que lorsqu'une personne accède à un postback spécifique de votre chatbot, alors la connexion ce déclenche et les données de vos choix sont envoyées à l'URL de webhook indiqué.
  • Formulaire WebForm : Cela signifie que lorsqu'un formulaire Webform spécifiue est renseigné dans votre chatbot, alors la connexion ce déclenche et les données de vos choix sont envoyées à l'URL de webhook indiqué.
 

 

  • Quelles données vous voulez envoyer  ?

Dans cette section vous devez sélectionner les données qui seront envoyé à l'URL de Webhooks lors du déclenchement.​ Le connecteur JSON API de KiliBot vous permet d'envoyer 13 différents données :

  • Psid : Identifiant unique de l'abonné
  • Abonné à : Date à laquelle l'abonné à rejoint votre chatbot
  • Postback id : Identifiant du Postback 
  • Prénom : Prénom de l'abonné
  • Nom de famille : Nom de famille de l'abonné
  • Email : Adresse E-mail de l'abonné (Si disponible)
  • identifiant de la page : Ientifiant de la page Facebook
  • Nom de la page : Nom de la page Facebook
  • Numéro de téléphone : Numéro de téléphone de l'abonné  (Si disponible)
  • Emplacement : Emplacement de l'abonné  (Si disponible)
  • Etiquettes : Etiquette rataché au profils de l'abonné  (Si disponible)
  • Données du formulaire : Informatins fournis dans le formulaire Webform
  • Date de naissance : Date de naissance de l'abonné  (Si disponible)

 

Note :

  • Voir le rapport de déclenchement : Vous pouvez voir le rapport de votre connexion si elle est déclenchée. Ici le code http : 200 signifie que la connexion a été déclenchée avec succès et qu'il n'y a pas d'erreur. Vous pouvez voir la liste des données dans la section "Post Data" qui a été envoyée lorsque la connexion s'est déclenchée. Il suffit de cliquer sur le bouton de visualisation et de voir les 10 dernières activités de votre connexion.
  • Ajoutez votre propre URL de script personnalisé comme URL de webhook en utilisant PHP : 

Supposons que votre domaine soit https://example.com et que votre nom de script soit test.php, votre URL de webhook sera donc https://example.com/test.php. Lorsque la connexion se déclenchera, le système enverra des données à cette URL. Vous pouvez maintenant voir les données récupérées dans le fichier en ajoutant les codes ci-dessous..

$webhook_data= file_get_contents("php://input");
$webhook_data_array=json_decode($webhook_data,true);

 

Nous espérons que cet article a répondu à vos attentes.

Si vous des questions ou rencontrer des problèmes avec KiliBot n'hésiter pas à ouvrir un ticket afin qu'un agent du service client vous assiste. 

N’oubliez pas de vous abonnez à notre page Facebook www.facebook.com/kilibot.inter et à notre chaîne Youtube afin de ne rien rater de nos dernières  news et conseils pour mieux mettre KiliBot au service de la croissance de votre entreprise.