Add Webhooks to your videoasks

Do you want to send your Videoask data straight to a web app or URL?

If you’re on a paid plan, you can set up Webhooks to receive notifications when messages are sent or received via your videoask.

What are Webhooks?

Webhooks are automatic notifications triggered by specific events. 

For VideoAsk, this event is a message from a respondent or the creator of a videoask. The notification containing the response data will be sent immediately to your Webhook URL.

Please note that Webhooks are an advanced feature intended for those who know how to work with them. We are unable to provide detailed instructions for code development or troubleshooting.

View our Webhook API documentation to learn more.

When will my Webhook trigger?

Once enabled, a Webhook delivery will trigger once a videoask is completed or abandoned and all video and/or audio media is transcoded. A videoask is considered completed or abandoned when a respondent either:

a) Reaches the final step or end screen of your videoask

b) Closes the window or tab in which they are viewing your videoask

or

c) Remains idle on a step in your videoask for 1 hour or longer, in which case their session times out and their responses are submitted

Transcoding the video/audio files to .mp4 files and generating a thumbnail might take a couple of minutes, depending on quality of connection and size of the file (ie length of the recording). We will only send the Webhook once the transcoding process has finished.

How to set up Webhooks

1

Select the videoask you want to integrate with a Webhook and click Connect

2021-03-26_16-54-20.png

2

In your Connect panel, select Webhooks

2020-12-11_18-33-23.png

3

Click Connect

2021-03-26_16-58-33.png

4

Type the address of your Target URL into the text field. You can use https://requestbin.com to collect test submissions.

2021-03-26_17-12-33.png

5

Toggle the switches to choose which events will trigger notifications and click Save.

  • form_response is triggered when a videoask is completed/abandoned and all audio or video media has been transcoded¬†
  • form_response_transcribe triggers when a videoask has been completed or abandoned and¬†all media has been transcribed
  • form_author_message is triggered when a message is created by you, the videoask creator
  • form_contact_message is triggered when a message is created by a contact
  • form_contact_tagged¬†is triggered when a tag is added to a contact
  • form_contact_untagged¬†is triggered when a tag is removed from a contact

2021-03-26_17-11-16.png

6

By default the idle deadline time is set to 60 minutes. The idle deadline is the amount of time a respondent sits idle on a videoask (ie is on the videoask page but has not reached the final step). You can customize this between 15 and 240 minutes.

2021-03-26_17-04-28.png

7

To test your Webhook, click View delivieries

2020-12-11_18-42-41.png

8

Click Send test response

2021-03-26_17-18-07.png

9

Now watch your notifications roll in! To copy any of the deliveries, click Copy code

2021-03-26_17-19-14.png

Add more Webhooks

If you want to add more Webhooks, just click Connect next to Add another Webhook, and repeat the steps above.

2021-03-26_17-01-27.png

Edit or delete a Webhook

If you want to change an existing Webhook or remove it completely:

1

Click Edit next to your Webhook.

2020-12-11_18-42-41.png

2

Make any desired changes and click Save to update your Webhook. Or click Delete this webhook to remove it.

2021-03-26_17-09-20.png

Can't find what you're looking for?