Help with Verification Step of Webhook Creation Using Bridge

jessica.smith

I am trying to use the Bridge API Call Utility to create a webhook on a sheet. I then want to use the Bridge Inbound Webhook integration to monitor sheet activity via the webhook and trigger a Bridge Workflow.

I am able to create the webhook, but I'm having trouble figuring out how to complete the Verification Process.

Can anyone walk me through how to complete the verification steps to enable the webhook?

A few notes...

The instructions in the API documentation are not helpful to me. Please don't respond with a hyperlink to it.
I do not want to use another 3rd party app. I'd like to do everything with Bridge if possible.
I am just trying to set up a simple proof of concept to decide if this is a feature I can use moving forward.

Genevieve P.

Hi @jessica.smith

Before we get too deep-in-the weeds with Webhook creation, can I check in and see why you're looking to go that route versus using the Smartsheet-Bridge built in integration to listen for changes?

Is there a specific activity you're looking to track?

Thanks!
Genevieve

Alex Argumedo

@jessica.smith ,

I'll try to answer your question, Smarsheet is expecting a very specific response from the webhook in order to activate, so this put the first pre-requisite, you need to be able to set 'custom messages' as responses in your webhook.

As soon as you create the webhook (as you have done already), you will get a challenge response from smartsheet server, which your webhook server needs to reply back to smartsheet server, this is the important part, your server needs to echo the message, not to send a 200 or a ok in response (those are standard responses) but the same message received.

Then your server will get a "OK" or "200" code back from the smartsheet server (standard response) indicating the webhook has been activated.

if your webhook doesn't support challenge responses (custom messages) you won't be able to activate. For instance Zapier service doesn't support custom responses, therefore it cannot be used for smartsheet webhooks (unless they have changed something lately).

set the webhook version to 1 for compatibility

jessica.smith

@Genevieve P. I may be misunderstanding what the webhook api call is capable of; however, I'm interpreting the documentation to suggest that the webhook can monitor all sheet events to trigger a callback from any change, rather then listening for a single specific event. I would need to set up 9 different integrations on a single sheet using the Smartsheet-Bridge integration route to accomplish the same thing.

Genevieve P.

Hi @jessica.smith

Thanks for clarifying! In this instance I would still suggest setting up your 9 individual Smartsheet triggers to all point to the same workflow. This would make it easier to manage down the line if your specifications change, as you can edit each individual trigger you're listening for and either disable it or re-route it to a different workflow.

I personally have not tried to verify a Webhook using Bridge and I am not sure it has the capabilities. If you would still like to set up a Webhook, I would use a separate developer account and program to create and verify the Webhook, to then subscribe the Workflow.

Cheers,
Genevieve