Webhooks are user-defined HTTP callbacks triggered by an event in a web application. Dolby.io Communications APIs use webhooks to asynchronously let your application know when events happen, for example conference creation, conference end, participant added, removed etc.

The webhook can be configured through the developer portal.

Preparing your application for webhook integration

1. Set up your platform or application with an HTTPS endpoint to receive the Dolby.io webhook events.
2. Copy and save the endpoint URL to use while configuring webhooks.

Configuring webhooks

To integrate your service with the webhook mechanism you'll need to configure within your developer dashboard.

1. Select the SIGN IN link located in the upper right corner of the Dolby.io page. Log in using your email and password.

2. Click the DASHBOARD link visible in the upper right corner of the website.

3. Select your application from the APPLICATIONS category located on the left side menu.

4. Select the Communications APIs category from the drop-down menu visible under your application.

5. Select the Settings tab at the top of the window.

6. Scroll down to the Webhooks category.

7. Click the ADD WEBHOOK button.

8. Enter the URL of your application endpoint and select events that you want to receive.

9. To finish, click the ADD button.

Testing webhooks

To test your application for webhook notifications, Dolby provides a tool at webhooks.dolby.io. You can register a webhook listener service there and configure the service URL on the developer dashboard.

  • https://webhooks.dolby.io/{id} - Provide an ID, which can be a random string, to generate a URL. Please note that this ID is not protected, and is publicly accessible, so should only be used for testing. Configure the generated URL in your developer dashboard for the webhook events you want to listen for.
  • https://webhooks.dolby.io/{id} - Open this URL in your browser to watch the incoming webhook notifications.