Get a Microsoft Teams transcript via API

​

1. Send the bot

# the meeting ID and its passcode, as Teams shows them in the invite
curl -X POST "$API_BASE/bots" \
  -H "X-API-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"platform":"teams","native_meeting_id":"397421056486982","passcode":"X8hcQVTnGNpGelJLSv","bot_name":"Vexa"}'

• the numeric meeting ID (10–15 digits) Teams prints next to a passcode — pass the passcode in passcode, never glued onto the id;
• the thread id out of a classic …/l/meetup-join/19:meeting_…@thread.v2 link, which carries its own credential and takes no separate passcode.

​

2. Read the transcript live

curl -H "X-API-Key: $API_KEY" \
  "$API_BASE/transcripts/teams/397421056486982"

{
  "segments": [
    { "speaker": "Jane Liu", "text": "Let's lock the renewal pricing by July 1.",
      "start": 12.4, "end": 15.1, "language": "en", "completed": true, "confidence": 0.93 }
  ]
}

{ "action": "subscribe",
  "meetings": [ { "platform": "teams", "native_id": "397421056486982" } ] }

​

Microsoft Teams specifics

• Admission. The bot may wait in the lobby until a host admits it — admit it like any guest. A run that ended there reports awaiting_admission_timeout or awaiting_admission_rejected; automatic_leave.max_wait_for_admission sets how long it waits.
• Non-default clouds. On teams.live.com for personal meetings, or gov. / dod. teams.microsoft.us for GCC-High and DoD, add teams_base_host — otherwise the bot builds its URL on the world-wide host and joins a different Teams. Hosts outside the Teams web clients are rejected with 422.
• Passcodes. Only passcode is read. password, meeting_password and similar aliases are rejected with a 422 naming the right field. The passcode is kept off the stored constructed_meeting_url and out of the logs.
• Language auto-detection. Teams rides the mixed-audio lane, where a low-confidence detection discards the window rather than guessing; those windows carry language: null. Pin language on the spawn to avoid it.

​

Stop the bot

curl -X DELETE "$API_BASE/bots/teams/397421056486982" -H "X-API-Key: $API_KEY"

​

See also

• Send a bot and get a transcript — the full walkthrough, all platforms
• Meetings API — every parameter, status, and response shape
• Troubleshooting — the bot joined but there is no transcript