Start Transcription Bot

Learn how to send a transcription bot to a meeting and start receiving transcripts.

Overview

This cookbook walks you through the complete flow of starting a transcription bot:

  1. Create a bot to join the meeting
  2. Monitor bot status as it joins
  3. Receive live transcripts via WebSocket
  4. Fetch final transcript after meeting ends
Step 1: Create Bot

Send a POST request to create a bot. The bot will automatically join the meeting.

POST /bots
{
  "platform": "google_meet",
  "native_meeting_id": "abc-defg-hij",
  "bot_name": "My Transcription Bot",
  "language": "en"
}
View full API reference
Step 2: Monitor Status

The bot will transition through these statuses:

  • requested - Bot creation requested
  • joining - Bot is connecting to the meeting
  • awaiting_admission - Bot is waiting in the lobby
  • active - Bot is in the meeting and transcribing
  • completed - Meeting ended, transcription complete

Poll the meeting status or use WebSocket to receive real-time status updates.

Step 3: Receive Live Transcripts

Connect to the WebSocket API to receive transcript segments in real-time.

Learn about WebSocket API
Step 4: Fetch Final Transcript

After the meeting ends, fetch the complete transcript via REST API.

View Transcripts API