Connecteur API JSON
La connexion API JSON de StartMsg vous permet de transmettre facilement des données importantes à toute URL externe que vous spécifiez. Par exemple, lorsqu'un événement d'activation choisi se produit, le système envoie automatiquement le format JSON à l'URL de webhook que vous avez spécifiée. Une réponse est attendue dans les 10 secondes – si elle n'est pas reçue, le système renverra la demande. C'est un excellent moyen d'intégrer StartMsg avec d'autres plateformes tierces telles que Zapier ou de créer des solutions entièrement personnalisées. Les fonctionnalités de la connexion API JSON sont facilement accessibles dans la section "Messenger Bot" du menu.
Gestion complète des connexions
Utilisation API JSON Outre la création de nouvelles connexions, vous pouvez également surveiller l'activité, modifier les connexions existantes ou supprimer les connexions dont vous n'avez plus besoin. Vous pouvez ainsi gérer facilement l'ensemble du processus de connexion aux systèmes externes, réagir rapidement aux changements et adapter la configuration à vos besoins.
Création simple d'une nouvelle connexion
Pour créer une nouvelle connexion, il suffit d'appuyer sur "Nouveau connecteur"et suivez quelques étapes simples :
- Nom du connecteurNom : Nommez la connexion afin qu'elle puisse être facilement identifiée parmi d'autres.
- URL du webhookURL : Entrez l'URL vers laquelle les données seront envoyées. Cette URL peut être obtenue à partir d'autres applications telles que Zapierou indiquez l'URL de votre application. Des données JSON seront envoyées à cette URL et le système attendra jusqu'à 10 secondes pour une réponse.
- Sélectionner une pageCe champ vous permet de sélectionner la page connectée au robot Messenger à partir de laquelle vous souhaitez collecter des données.
- Quel champ active le WebhookChamp de déclenchement : Sélectionnez le champ qui doit déclencher le webhook. Options : email, numéro de téléphone, lieu, postback, date de naissance ou formulaires webview. Par exemple, si vous sélectionnez l'email, lorsqu'une nouvelle adresse est collectée par le robot Messenger, le webhook est déclenché. Vous pouvez sélectionner plusieurs champs si nécessaire.
- Quelles données voulez-vous envoyer ?Sélectionnez les informations à envoyer lorsque le webhook est activé. Exemple de données à envoyer :
{
"psid" : "12765756″,
"Prénom" : "Test",
"Nom de famille" : "Utilisateur",
„subscribed_at”:”2024-01-15 12:19:04″,
"email" : "testuser@gmail.com",
"labels" : "Demo,Demo Label 1,new-label-test",
„page_id”:”37674343246″,
"page_name" : "Page de test",
„phone_number”:”+370628282846″,
"user_location" :"",
"postbackid" :"",
„subscriber_id”:”2251324188330310″,
„webview_form_id”:”83c567cd88″,
"Type de produit" : "Chaussures",
"Taille" : "moyenne",
"Numéro de téléphone : "88823″,
„Delivery-Date”:”2024-01-15″
}
Effacer les rapports sur les connecteurs
Vous pouvez surveiller chaque connexion créée via le tableau de bord. Le rapport d'activité vous permet de voir les 10 dernières actions et les paramètres de base. Si la connexion est activée avec succès, le code HTTP affichera "200". Dans la section des rapports, vous pouvez également voir quelles données ont été envoyées lors des dernières activations.
Ajout d'un script PHP en tant qu'URL d'un Webhook
Si vous souhaitez utiliser votre propre script pour accepter des données JSON, vous pouvez le faire en ajoutant votre URL en tant que webhook. Par exemple, si votre domaine est "https://example.com"et que le script s'appelle "test.php", l'URL du webhook sera "https://example.com/test.php". Lorsque l'événement d'activation sélectionné se produit, le système envoie des données à cette URL. Pour recevoir des données JSON, ajoutez le code suivant à votre fichier "test.php" :
$webhook_data = file_get_contents("php://input") ;
$webhook_data_array = json_decode($webhook_data, true) ;
Utilisation de StartMsg API JSON vous pouvez non seulement automatiser des opérations commerciales importantes, mais aussi personnaliser la plateforme pour qu'elle fonctionne avec d'autres applications que vous utilisez.