Server Side WebHooks

Integrating Custom Business Processes into Cinema8 Videos

A webhook (also called a web callback or HTTP push API) is a way for an app to provide other applications with real-time information. A webhook delivers data to other applications as it happens, so you receive data immediately. Cinema8 Webhooks allow you to inject your own business processes into interactive videos.

Creating a Webhook

Let’s go over the steps to add a webhook.

First, return to the main menu and click on the Integrations button.

Then click the Webhooks button. Click the Add Webhook button.

Let’s look at the webhook settings:

1. Enter the name of the webhook.
2. Enter the URL where data will be posted. You can also create custom headers to increase security.
3. Specify the name of the header.
4. Enter values for the header to validate requests.
5. Click to add additional headers.
6. Enable this to pause the video until the webhook responds.
7. Enable this to include earlier interaction data in the webhook.
8. Click Save to apply your settings.

Adding Webhook to Video

Now, create a test webhook by following the steps above.

The test URL uses a simple echo service that returns two example values: discountCode and imageUrl.

To display them in your video:

1. Add two HTML elements to your video.
2. In the Source Code field of the first HTML tool, add:
   DiscountCode: ${discountCode}
3. In the second HTML tool, add:
   <img src="${imageUrl}" />

Next, add a Clickable Area element to trigger the webhook.

Set its On Click action to Execute Webhook.

Once clicked, the webhook is activated and sends data to the HTML elements in the video.

Click here to view a sample video 

How to Use Webhook Parameters in Interactive Videos