Arbeiten mit Webhooks in Bots

Beim Erstellen oder Bearbeiten eines Bots können Sie einen Webhook hinzufügen, indem Sie auf das Symbol „+“ klicken, um wie gewohnt eine Aktion hinzuzufügen. Klicken Sie im Bereich der Aktionsauswahl auf „Webhook triggern“.trigger-a-webhook

Geben Sie Ihrer Aktion dann einen Namen und geben Sie die Endpunkt-URL für den Webhook ein. Wenn Ihr Webhook Daten an HubSpot weiterleiten soll, aktivieren Sie das Kontrollkästchen „Auf Webhook-Feedback warten“. (Mehr dazu weiter unten.) Speichern Sie Ihre Aktion. trigger-a-webhook-editorWenn diese Aktion in einer Konversation erreicht wurde, sendet HubSpot eine JSON-Payload an die Webhook-URL, die Sie definiert haben. Die Payload enthält die relevanten Informationen der Chat-Sitzung einschließlich der Antworten von Besuchern auf etwaige Fragen, die Kontakt-ID eines Besuchers und Informationen zum Bot.

Beispiel für Anfrage-Payload:
//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 } } } } }

Als fortgeschrittener Benutzer haben Sie auch die Möglichkeit, JSON in die Antwort Ihres Webhooks aufzunehmen. In diesem Fall können Sie den Ablauf der Unterhaltung beeinflussen oder eine benutzerdefinierte Nachricht senden.

Beispiel für Antwort-Payload:
//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. }

War dieser Artikel hilfreich?
Dieses Formular dient dazu, Feedback zu unserer Entwicklerdokumentation zu sammeln. Wenn Sie uns Ihre Meinung zu HubSpot-Produkten mitteilen möchten, teilen Sie diese bitte im Ideenforum der Community.