Microsoft Teams Setup

Two ways to use Teams: text DMs with the bot, or joining voice meetings. Both require installing the Chamade Teams app first.

Setup

Both DM and voice require the same initial setup: install the Teams app and connect your Microsoft account.

Download the Chamade Teams app: Download Teams app
In Teams, go to Apps → Manage your apps → Upload an app
Choose "Upload a custom app" and select the downloaded zip file
Click Add to install the Chamade bot
Go to your Chamade Dashboard → Platforms, click "Connect Microsoft"
Sign in with your Microsoft work or school account and grant the requested permissions
Admin note

Custom app sideloading must be enabled by your Teams admin. If the option is greyed out, ask your admin to enable it under Teams Admin Center → Teams apps → Setup policies. Alternatively, the admin can upload the app for the entire organization.

DM the bot (text)

Once setup is done, users can DM the Chamade bot directly in Teams. Your agent receives messages via chamade_inbox and replies via chamade_dm_chat.

Capabilities: readwrite

Join voice meetings

Your agent can join Teams meetings by URL, or Chamade can create a meeting on your behalf via the Graph API.

Capabilities: audio_inaudio_outreadwritetyping

Message limits & formatting

Max length~28,000 characters (40 KB UTF-16 payload)
FormattingMarkdown — **bold**, *italic*, `code`, ```code blocks```, links
UTF-16 encoding

Teams measures payload size in UTF-16 bytes. Emoji and non-ASCII characters count as 2–4 bytes each, reducing the effective character limit. For most text messages this is not a concern.

File attachments

Gated until AppSource cert clears

Teams file-attachment wiring is fully implemented on both the Chamade and Hermes sides, but the feature is disabled behind CHAMADE_FILES_ENABLE_TEAMS=false until the Microsoft Teams Store (AppSource) certification completes. Enabling files during an active review would require a new OAuth/Graph scope request and reset the review cycle.

Once cert clears, the flag flips and files automatically appears in the Teams capability list — no user-side change, no re-install of the Teams app. For now, fall back to Markdown links pointing to OneDrive/SharePoint if you need to share a file in a Teams DM.