Webhooks

There are times when you want the content of a bot to be dynamic. This might be either to fetch some information, or even to save the result of the Forms that the user has completed. In order to "call out" or integrate with other platforms and systems, we have Webhooks.

A Webhook is an API that you can send data to, and in this case it is something that is accessible via a HTTP POST request. As a result, to use a webhook you will need a URL that will receive the information. You can specify this under the Webhook part of the Settings page.

Think of the Webhook Endpoint as an address where you'd like to post a letter to. Inside the letter is the contents of the form that the user has completed.

Once you've setup the webhook, any Function blocks you have in your content will call out to this URL and pass the relevant data with it. As there is one webhook URL per bot, you may need a way to distinguish between one event and the other. We do this by specifying a handler name in the settings of a block.

You can specify any handler name you like, however you then use this name to differentiate between events. By doing so you can have one webhook that supports handling the events from two different blocks.

For more information about building a API that can handle these webhook events, please read our WBB SDK documentation which provides examples and more details.

Quick StartSDK