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.

Updated Sep 11, 20268 min read
Deployment route
  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  6. 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.

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  6. 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.

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.

Put Hermes Agent in the channel where the work already happens.