Overview

Webhooks provide a way for your application to receive real-time notifications about specific events. By configuring webhooks, you can automate workflows and seamlessly integrate our platform with your application.

Configuration

To set up a webhook, follow these steps:

  1. Navigate to Settings: Go to the Integrations Page and open the Public API section;
  2. Enter Webhook URL: Specify the endpoint where webhook events should be sent;
  3. Save Changes: Click Save to activate the webhook.

Event Notifications

When a meeting analysis is completed, the system sends three POST requests to the configured webhook URL. The request payloads are in JSON format, as shown below:

Successful Analysis:

{
    "message": "File analyzed successfully",
    "meeting_id": "9433976b-cfa3-4373-9afb-eb0b7a5915df"
}

Failed Analysis:

{
    "message": "File analyzed failed"
}

Your server must respond with an HTTP 200 OK status code and no response body to acknowledge receipt of the webhook. The second and third POST requests are sent only as retries in case the initial request is not acknowledged. If your server successfully responds with 200 OK, no further retries will be made.

Team-Level Webhooks

For meetings that are shared with a team, webhooks are triggered for all team members who have view access to the meeting. This ensures that relevant users receive timely notifications about the meeting’s analysis status.

The meeting owner must have Share Access to the teams they wish to share with. If they do not have Share Access, the webhook notification will be sent only to them.

To manage access permissions, go to the Team Sharing page and update the sharing settings for each team member.