Utilisation de webhooks depuis des bots

Lors de la création ou de la modification d'un bot, vous pouvez ajouter un webhook en cliquant sur le bouton + pour ajouter une action, comme vous le feriez habituellement. Dans le panneau de sélection de l'action, cliquez sur Déclencher un webhook.trigger-a-webhook

Ensuite, donnez un nom interne à votre action et saisissez l'URL de point de terminaison pour le webhook. Si votre webhook enverra des données à HubSpot en réponse à la demande, sélectionnez la case à cocher Attendre le feedback sur le webhook (découvrez-en davantage ci-dessous). Enregistrez votre action. trigger-a-webhook-editorLorsque cette action est atteinte dans une conversation, HubSpot enverra une charge utile JSON à l'URL du webhook que vous avez définie. La charge utile contient des informations pertinentes pour la session de chat, y compris les réponses des visiteurs pour toute question posée, leur ID de contact ainsi que des informations sur le bot.

Exemple de charge utile de demande :
//sample payload { "userMessage": { // Details for the last message sent to your bot "message": "100-500", // The last message received by your bot, sent by the visitor "quickReply": { // If the visitor selected any quick reply options, this will be a list of the selected options. // Will be 'null' if no options were selected. "quickReplies":[ // A list of quick reply options selected by the visitor { "value":"100-500", "label":"100-500" } ], }, "session": { "vid": 12345, // The contact VID of the visitor, if known. "properties": { // A list of properties collected by the bot in the current session. "CONTACT": { "firstname": { "value": "John", "syncedAt": 1534362540592 }, "email": { "value": "testing@domain.com", "syncedAt": 1534362541764 }, "lastname": { "value": "Smith", "syncedAt": 1534362540592 } } } } }

Les utilisateurs avancés peuvent également inclure JSON dans la réponse de votre webhook. Vous pouvez ainsi affecter le flux de la conversation ou envoyer un message personnalisé.

Exemple de charge utile de réponse :
//sample payload { "botMessage": null, // This is the message your bot will display to the visitor. "nextModuleNickname": "PromptForCollectUserInput", // If defined, this will be the next module your bot will go to. If undefined, the default configured behavior will be observed. "responseExpected": false // If true, the webhook will be triggered again with the visitor's next reply. If false, the default configured behavior will be observed. }

Cet article vous a-t-il été utile ? *
Ce formulaire est destiné à recueillir les avis sur la documentation pour les développeurs. Si vous souhaitez faire part de votre avis sur les produits HubSpot, veuillez le partager sur le forum des idéesde la communauté.