Skip to main content
This page covers Teams specifics: how to extract the meeting ID and passcode, and common join issues.

​
Supported URL formats

Vexa supports all major Teams meeting link formats:
FormatExampleSupport
Personal (teams.live.com)https://teams.live.com/meet/1234567890123?p=PASSCODEFull
Enterprise short URLhttps://teams.microsoft.com/meet/1234567890123?p=PASSCODEFull
Enterprise deep linkhttps://teams.microsoft.com/v2/?meetingjoin=true#/meet/1234567890123?p=PASSCODEFull
Legacy enterprisehttps://teams.microsoft.com/l/meetup-join/19%3ameeting_...Full (via MCP)
US Governmenthttps://gov.teams.microsoft.us/meet/...Full
DoDhttps://dod.teams.microsoft.us/meet/...Full

​
Native meeting ID and passcode

For Teams, you must pass:
  • native_meeting_id: the numeric meeting ID (10-15 digits)
  • passcode: the value of the ?p= query parameter from the URL (4-20 alphanumeric characters)
Example:
  • URL: https://teams.live.com/meet/1234567890123?p=YOUR_PASSCODE
  • native_meeting_id: 1234567890123
  • passcode: YOUR_PASSCODE
Legacy enterprise URLs (/l/meetup-join/...) do not contain an extractable numeric meeting ID. When using the MCP tool, these are handled automatically — the URL is passed directly to the bot. For direct API usage, a raw URL endpoint is planned (#161).

​
API example

curl -X POST "$API_BASE/bots" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $API_KEY" \
  -d '{
    "platform": "teams",
    "native_meeting_id": "1234567890123",
    "passcode": "YOUR_PASSCODE",
    "recording_enabled": true,
    "transcribe_enabled": true,
    "transcription_tier": "realtime"
  }'
Full API guide:

​
Common issues

​
Bot does not join

Most often:
  • wrong native_meeting_id (must be numeric only)
  • missing/wrong passcode (the p= value)

​
Bot joins but you see no transcript

Common causes:
  • transcribe_enabled=false
  • meeting audio not available to capture
See:

​
Known Limitations

  • Bot avatar/virtual camera is not visible to other participants. Teams SFU returns a=inactive for video from anonymous guest bots. Use screen share for visual content instead. (#124)
  • Intermittent false rejection on pre-join screen. In rare cases the bot may incorrectly conclude it was rejected by the meeting admin. Retrying usually succeeds. (#123)