Blog / channel guide
Hermes Agent Microsoft Teams Setup for Work Accounts
To add Hermes Agent to Microsoft Teams, register a bot in Microsoft Entra ID, enable the Teams channel, grant the assistant Microsoft Graph permissions with admin consent, and paste the bot credentials into the Hermes Agent deployment screen. Then prove one reply in a one-to-one chat before installing the app for a team.
- 01
Register the bot in Entra ID
Create an app registration in Microsoft Entra ID, note the application (client) ID, and create a client secret for the assistant.
- 02
Enable the Teams channel
In the bot configuration, enable the Microsoft Teams channel and set the messaging endpoint or the managed connection mode the platform supports.
- 03
Grant Microsoft Graph permissions
Add the permissions the workflow needs, such as reading channel messages and posting replies, and keep the list as small as the use case allows.
- 04
Consent as a tenant administrator
Ask a Teams or Entra administrator to grant tenant-wide consent. Without admin consent the bot installs but stays silent.
- 05
Deploy Hermes Agent with Teams selected
Choose a model, select Microsoft Teams as the channel, paste the client ID and secret, and start the deployment.
- 06
Test a one-to-one chat
Open the assistant in Teams, send a direct message, and confirm a reply before adding it to a channel or a group chat.
Four-step path
How do you connect Hermes Agent to Microsoft Teams?
Five checkpoints cover the work: register the bot, grant Graph permissions, consent as an admin, deploy with the credentials, then test a one-to-one chat.
- Step 01
Register the bot in Entra ID
Create an app registration in Microsoft Entra ID, note the application (client) ID, and create a client secret for the assistant.
- Step 02
Enable the Teams channel
In the bot configuration, enable the Microsoft Teams channel and set the messaging endpoint or the managed connection mode the platform supports.
- Step 03
Grant Microsoft Graph permissions
Add the permissions the workflow needs, such as reading channel messages and posting replies, and keep the list as small as the use case allows.
- Step 04
Consent as a tenant administrator
Ask a Teams or Entra administrator to grant tenant-wide consent. Without admin consent the bot installs but stays silent.
- Step 05
Deploy Hermes Agent with Teams selected
Choose a model, select Microsoft Teams as the channel, paste the client ID and secret, and start the deployment.
- Step 06
Test a one-to-one chat
Open the assistant in Teams, send a direct message, and confirm a reply before adding it to a channel or a group chat.
What does Microsoft Teams require that Slack does not?
Teams adds a Microsoft Entra tenant to the picture. You need an app registration, a client secret, and tenant admin consent before the bot can read or post anything in a work account.
Personal Microsoft accounts behave differently from work accounts. A managed Hermes Agent deployment for Teams is designed for organization tenants, where an administrator can consent once for the whole company.
Which permissions should the Teams assistant have?
Start with the ability to receive messages and post replies, then add channel or file reading only when the workflow genuinely needs it. Broad Graph permissions are the most common source of over-privileged assistants.
- Message read and send permissions for the assistant conversation.
- Channel message reading only for channels the assistant summarizes.
- No directory, mailbox, or file scope unless a documented workflow requires it.
- Record every permission in the deployment notes so it can be reviewed later.
Why does the Teams bot install but never answer?
The most common cause is missing tenant admin consent. A second frequent cause is a client secret that expired or was regenerated after the deployment was created.
- Confirm an administrator granted consent for the exact permissions requested.
- Check the client secret expiry date and rotate before it lapses.
- Verify the bot is enabled in the Teams admin center and not blocked by an app policy.
- Confirm the deployment status is running rather than provisioning or failed.
How do you keep a Teams assistant governable?
Keep one assistant per purpose, restrict it to the channels it needs, and require approval for anything that posts outside the assistant conversation.
Teams is a regulated surface in many organizations. Document who owns the app registration, who can rotate the secret, and which channels the assistant may read so that access reviews are straightforward.
How should you roll Teams out across the company?
Start with one team and one channel, keep the bot read-only at first, and widen permissions only after the replies are consistently useful.
A staged rollout keeps the blast radius small. If a reply is wrong in a private chat, nobody notices; if it is wrong in an all-company channel, the cost is immediate.
Which primary sources support this page?
Product behavior is checked against the current deployment flow. These external links provide the upstream project or channel documentation used for setup details.
Direct answers
Frequently asked questions
Do I need a Microsoft 365 administrator?
For a work account, yes. An administrator must grant tenant consent before the assistant can read or post in Teams.
Can Hermes Agent work with a personal Microsoft account?
Organization tenants are the supported path. Personal accounts lack the tenant-level consent model that Teams apps rely on.
Can the assistant post in channels, not just direct messages?
Yes, once it is installed for a team and granted the matching permissions. Start with one channel and keep posting scoped to it.
What happens when the client secret expires?
The assistant stops answering. Create a new secret in Entra ID, update the stored credential, and redeploy the connection.
Key takeaways
- To add Hermes Agent to Microsoft Teams, register a bot in Microsoft Entra ID, enable the Teams channel, grant the assistant Microsoft Graph permissions with admin consent, and paste the bot credentials into the Hermes Agent deployment screen. Then prove one reply in a one-to-one chat before installing the app for a team.
- Start with one model, one channel, and one controlled test conversation.
- Use managed hosting when deployment speed matters more than operating the server yourself.
Continue the setup
Related Hermes Agent guides
Blog guide
Hermes Agent Slack Setup: Socket Mode in Minutes
Connect Hermes Agent to Slack with Socket Mode, scoped bot tokens, and a private-channel test. Verify the runtime, fix missing replies, and scale to channels.
Read nextBlog guide
Hermes Agent Google Chat Setup with a Service Account
Connect Hermes Agent to Google Chat with a service account, Chat API app config, and a Workspace test space. Includes verification and silent-bot fixes.
Read nextBlog guide
How to Choose a Hermes Agent Channel
Compare Telegram, Discord, and WhatsApp for Hermes Agent deployment. Choose the best channel for support, daily briefings, and team operations.
Read nextBlog guide
Why Hermes Agent Is Not Sending or Receiving Messages
Troubleshoot Hermes Agent message failures across Telegram, Discord, and WhatsApp by checking channel access, runtime state, model keys, and logs.
Read next