Integrations
Microsoft Teams
How to get your Microsoft Teams API key and connect it to Nova Admin.
Register a Microsoft Entra app and Azure Bot, point its messaging endpoint to /api/v1/webhooks/teams, then connect the bot credentials in Nova Admin. Once connected, Nova can receive messages and send text replies, Adaptive Cards, typing indicators, and message updates.
Prerequisites
- A Microsoft Teams account. Sign up at https://learn.microsoft.com/microsoftteams/platform/bots/how-to/create-a-bot-for-teams.
- An active Nova Admin workspace. Go to /agents/integrations to connect.
Steps
- Register an app in Microsoft Entra ID and create a client secret. Record the Application (client) ID, client secret value, and Directory (tenant) ID.
- Create an Azure Bot resource that uses the Entra application. Set its messaging endpoint to https://nova-os.netlify.app/api/v1/webhooks/teams, or the same path on your Nova host.
- Enable the Microsoft Teams channel on the Azure Bot, then add the bot to a personal chat, team, or group chat.
- In Nova Admin, open /agents/integrations, select Microsoft Teams, and enter the Application (client) ID, client secret value, and optional tenant ID.
Credential fields
| Field | Required | Description |
|---|---|---|
| Microsoft App ID | Yes | string (e.g. Application (client) ID) |
| Microsoft App Password | Yes | Secret — stored encrypted, never exposed. (e.g. Client secret value) |
| Tenant ID | No | string (e.g. Directory (tenant) ID) |
Troubleshooting
- Invalid credentials: verify the key was copied in full with no trailing spaces.
- Key not working: check that your Microsoft Teams account has API access enabled and billing is active if required.
- Need help?: refer to the Microsoft Teams documentation.