Flowplayer is now part of the Wowza Video live streaming and VOD platform. Learn more →

light background
product

Webhooks a practical guide

2 minutes read
Webhooks a practical guide

A practical guide on how to use Flowplayer webhooks!

A while ago we wrote about our new webhooks https://flowplayer.com/blog/launch-of-webhooks and why they are a great feature of our platform. But as with any tool it is when you see it in a practical application you really see the value of it.

This guide aims at showing a couple of use cases on how you can use Flowplayer Webhooks in a practical way. Most of the common cases are centered around getting notified of an event in one way or another.

  1. Event happens
  2. Webhook is triggered
  3. Notification if pushed

We will show how to set up a notification of live errors that occur during a live broadcast. The notification will be sent to Slack with a set of information.

Let’s start with the webhook.

Step 1. Create a webhook

In your account menu, you find “webhooks”.

Bild%201%20Webhooks%20blog

Choose the menu and create a new webhook.

Bild%202%20Webhooks%20blog

Choose the event “Livestream error got triggered”

Bild%203%20Webhooks%20blog

Now you come to refining what events will trigger the webhook. This is good to spend some extra time on since you do not want to get too much noise in the slack channel of unrelated or not important events.

Bild%204%20Webhooks%20blog

In our case I have chosen to filter on a workspace. You can also filter on error type and a specific live source. Depending on what event you have selected the choices of what you can filter on will change as well.

Last step will be to add a url to send to

Bild%205%20Webhooks%20blog

  1. Connecting with Zapier

We love Zapier. It is a no-code solution to solve some of the plumbing needed on the web. In this example we will use Zapier to connect our webhook with Slack.

Here is the link to Zapier for the setup we will use https://zapier.com/apps/slack/integrations/webhook/1597/get-slack-notifications-for-new-information-from-a-webhook

Follow the steps outlined in the link in order to connect zapier with your slack organization and then you are ready for the next step.

Now you can start connecting your webhook

Bil%206%20Webhooks%20blog

You will get a webhook URL from Zapier to paste into the field in Flowplayer.

Bild%207%20Webhooks%20blog

Now you can test your webhook by (in this case) setting up a livestream in which you simulate issues. You will then see a message as the one below.

Bild%208%20Webhooks%20blog

Choose what Slack organization and channel you want to post to and then what attributes to post. Zapier will suggest a couple of ones based on the test you have done.

In this example we will send a message that looks like this

Bild%209%20Webhooks%20blog

Now you can test your notification to Slack!

Bild%2010%20Webhooks%20blog

Voila! Now you have a notification system to let you know if there is an issue with your livestream. This will help you get better/quicker info back to your production team on the ground who can take the necessary actions to remedy the issue.