Inbound webhooks integration overview

Applies to

Bridge by Smartsheet

With inbound webhooks, you can generate and expose webhook endpoints to trigger workflows or actions on Bridge.

The Inbound Webhook Utility is currently only compatible with JSON payload objects.

Triggers

Workflow triggers

Workflow triggers are a list of preset triggers you can use to run a Bridge workflow. When you use workflow triggers, you won’t have to specify the request body or headers.

With this method, you specify the workflow and any preset state values; then a request URL will be generated. Any requests to this URL will start the specified workflow, passing any request body data to the workflow, available using the {{runtime}} handlebar reference.

Each trigger has a unique URL that contains a UID, so we know what trigger has been requested.

This solution doesn’t support webhooks, which include a challenge request. This will require a new custom integration to be built. 

Chat triggers

Chat triggers are a list of preset workflow triggers you can use to run a Bridge workflow for a specified user and chat channel. When you use chat triggers, you won’t have to specify the request body and headers.

With this method, you specify the workflow, channel, user email, and any preset stateValues; then a request URL will be generated. Any requests to this URL will start the specified workflow on the chat channel, passing any request body data to the workflow, available using the {{runtime}} handlebar reference.

Each trigger has a unique URL that contains a UID so we know what trigger has been requested.

Advanced triggers

You can be more flexible with what workflows you trigger. If you can set the request body and headers, you’ll be able to determine dynamically what workflows or chat workflows can be triggered using a single endpoint. 

Secret

When registering the extension, you can specify a secret as the value for the Inbound-Webhook-Secret header that must be passed for any calls to the extension webhooks.

If you do not specify a secret, a random UUID will be generated for you.

Workflow request URL

This URL is unique to each workspace and will be generated when you set up the extension. You can also use this URL when you want to make a structured request to run one or more Bridge workflows.

Chat Request URL

This URL is unique to each workspace and will be generated when you set up the extension.

You can also use this URL when you want to make a structured request to run one or more Bridge workflows on a chat channel for one or more users.