Bot Completed

Payload Structure

Field Details

• data (object) Required

  Properties:

  • audio (string (uri) | null) Required Signed URL to download the audio recording. Valid for 4 hours. Null if audio recording is not available or has been deleted

  • bot_id (string (uuid)) Required The UUID of the bot that completed

  • data_deleted (boolean) Required Whether the bot's data (artifacts, recordings) has been deleted. True if data has been permanently removed

  • diarization (string (uri) | null) Required Signed URL to download the speaker diarization data. Valid for 4 hours. Null if diarization is not available or has been deleted

  • duration_seconds (integer | null) Required

  • event_id (string (uuid) | null) Required The UUID of the calendar event associated with this bot. Null for non-calendar bots

  • exited_at (string (date-time) | null) Required ISO 8601 timestamp when the bot exited the meeting. Null if exit time is not available

  • joined_at (string (date-time) | null) Required ISO 8601 timestamp when the bot joined the meeting. Null if join time is not available

  • participants (object[]) Required List of participants who joined the meeting with their names and metadata. Empty array if participant information is not available

  • raw_transcription (string (uri) | null) Required Signed URL to download the raw transcription file. Valid for 4 hours. Null if raw transcription is not available or has been deleted

  • sent_at (string (date-time)) Required ISO 8601 timestamp when this webhook was sent

  • speakers (object[]) Required List of speakers detected in the meeting with their names and metadata. Empty array if speaker information is not available

  • transcription (string (uri) | null) Required Signed URL to download the processed transcription file. Valid for 4 hours. Null if transcription is not available or has been deleted

  • transcription_ids (string[] | null) Required Array of transcription job IDs from the transcription provider. Null if transcription was not enabled or if IDs are not available

  • transcription_provider (string | null) Required The transcription provider used (e.g., 'gladia', 'deepgram', 'assemblyai'). Null if transcription was not enabled or if provider information is not available

  • video (string (uri) | null) Required Signed URL to download the video recording. Valid for 4 hours. Null if video recording is not available or has been deleted

• event (string) Required The webhook event type

• extra (object | null) Required Additional metadata provided when creating the bot. This is user-defined data that can be used for correlation or tracking

Example

{
  "data": {
    "audio": null,
    "bot_id": "examplebot_id",
    "data_deleted": true,
    "diarization": null,
    "duration_seconds": null,
    "event_id": null,
    "exited_at": null,
    "joined_at": null,
    "participants": [],
    "raw_transcription": null,
    "sent_at": "examplesent_at",
    "speakers": [],
    "transcription": null,
    "transcription_ids": [],
    "transcription_provider": null,
    "video": null
  },
  "event": "exampleevent",
  "extra": null
}