Microsoft Teams

​

Overview

​

Capabilities

• Join and leave meetings
• Audio and video recording
• Real-time transcription via closed captions
• Send and receive chat messages
• Audio and video input/output
• Screen sharing capture
• Custom participant name
• Video playback into meetings

​

Technical Implementation

• teams_bot_adapter.py - Main adapter implementation
• teams_ui_methods.py - UI interaction methods
• teams_chromedriver_payload.js - Browser-side JavaScript

​

Setup Requirements

​

Meeting Access

​

Guest Access (Default)

• Meetings with guest access enabled
• Public meetings shared via link
• External collaboration meetings

​

Authenticated Access

{
  "meeting_url": "https://teams.microsoft.com/l/meetup-join/...",
  "teams_settings": {
    "use_bot_login": true
  }
}

​

Closed Captions & Transcription

​

Language Configuration

{
  "meeting_url": "https://teams.microsoft.com/l/meetup-join/...",
  "teams_settings": {
    "closed_captions_language": "en-US"
  }
}

• English (en-US, en-GB, en-AU, etc.)
• Spanish (es-ES, es-MX, etc.)
• French (fr-FR, fr-CA)
• German (de-DE)
• Portuguese (pt-BR, pt-PT)
• And more - any language supported by Teams live captions

​

Chat Messages

​

Sending Messages

POST /api/v1/bots/{bot_id}/send_chat_message
{
  "message": "Hello from Attendee bot!"
}

​

Rich Text Formatting

# Send formatted message
message = "This is <b>bold</b> and this is <i>italic</i>"
bot.send_chat_message(message)

• <b> - Bold text
• <i> - Italic text
• <br> - Line breaks
• Spaces are automatically converted to   for proper rendering

​

Video Recording

{
  "meeting_url": "https://teams.microsoft.com/l/meetup-join/...",
  "teams_settings": {
    "modify_dom_for_video_recording": true
  }
}

​

Sending Media

​

Video Playback

# Play video once
bot.send_video("https://example.com/video.mp4", loop=False)

# Loop video continuously
bot.send_video("https://example.com/video.mp4", loop=True)

window.botOutputManager.playVideoWithBlobUrl(videoUrl, loop)

​

Platform-Specific Settings

{
  "meeting_url": "https://teams.microsoft.com/l/meetup-join/...",
  "bot_name": "My Teams Bot",
  "teams_settings": {
    "closed_captions_language": "en-US",
    "modify_dom_for_video_recording": false,
    "use_bot_login": false
  },
  "automatic_leave_settings": {
    "meeting_empty_timeout_seconds": 300,
    "meeting_only_bots_timeout_seconds": 120
  }
}

​

Known Limitations

• No Official SDK: Microsoft Teams doesn’t provide a public bot SDK for external developers, requiring browser automation
• Login Required Meetings: Meetings requiring Microsoft account login need authenticated bot access
• Organization Policies: Some organizations disable guest access or external participants
• Performance: Chrome automation uses more resources than native SDK implementations
• UI Dependencies: Bot functionality depends on Teams web UI structure

​

Authentication Retry Behavior

1. Bot attempts to join as guest
2. If login is required and credentials are available:
   • Bot sets use_bot_login = true
   • Retries joining with authentication
3. If credentials are not available, bot fails with error

def should_retry_joining_meeting_that_requires_login_by_logging_in(self):
    if not self.teams_bot_login_credentials:
        return False
    if self.teams_bot_login_should_be_used:
        return False
    self.teams_bot_login_should_be_used = True
    return True

​

Automatic Leave Configuration

{
  "automatic_leave_settings": {
    "meeting_empty_timeout_seconds": 300,
    "meeting_only_bots_timeout_seconds": 120,
    "authorized_user_not_in_meeting_timeout_seconds": 600,
    "silence_timeout_seconds": 900
  }
}

• meeting_empty_timeout_seconds - Leave when no participants remain
• meeting_only_bots_timeout_seconds - Leave when only bots are present
• authorized_user_not_in_meeting_timeout_seconds - Wait time for authorized user
• silence_timeout_seconds - Leave after period of no audio activity

​

Best Practices

1. Use clear bot names - Help participants identify the bot’s purpose (e.g., “Recording Bot”, “Transcription Assistant”)
2. Configure appropriate timeouts - Prevent bots from lingering in empty meetings
3. Test guest access - Verify meeting settings allow guest participants before deployment
4. Handle formatting carefully - Use supported HTML tags when sending formatted chat messages
5. Monitor bot health - Use webhooks to track bot state and handle failures
6. Respect privacy - Clearly communicate when recording or transcription is active

​

Troubleshooting

​

Bot Cannot Join Meeting

• Meeting requires Microsoft account login
• Organization has disabled guest access
• Meeting link has expired
• Meeting has reached participant limit

• Enable use_bot_login with valid credentials
• Contact meeting organizer to enable guest access
• Verify meeting URL is current and valid

​

Chat Messages Not Sending

• Chat input element not found
• Meeting has disabled chat
• Bot doesn’t have permission to send messages

• Verify chat is enabled in meeting settings
• Check bot has successfully joined the meeting
• Review browser console logs for errors

​

Captions Not Working

• Language not supported in meeting region
• Captions not enabled by meeting organizer
• Incorrect language code specified

• Verify language code matches Teams-supported languages
• Ask meeting organizer to enable live captions
• Use alternative transcription via Deepgram

​

Video Quality Issues

• Enable modify_dom_for_video_recording
• Increase browser window size for higher resolution capture
• Check network bandwidth and stability
• Verify video codec compatibility

​

Resources

• Teams Bot Adapter Source
• Teams UI Methods
• WebBotAdapter Base Class