Teams
Microsoft Teams integration
CommunicationAvailable
BRAIAN connects to Microsoft Teams through Microsoft Graph API + bot registration. Agents can approval requests, escalation notifications and carol conversational access. Every action is scoped by the permissions granted to the integration and executed under a versioned policy. Each one is recorded in the audit log with the agent, timestamp and record touched.
What can BRAIAN do?
Approval requests and escalations reach the responsible person in Teams, and Carol can be queried directly in a chat. The conversation happens in Teams; the decision and its rationale are recorded in BRAIAN.
| Capability | Agent | Read or write |
|---|---|---|
| Approval requests | All agents | Write |
| Escalation notifications | All agents | Write |
| Carol conversational access | Carol | Read and write |
How does it connect?
- Connection method
- Microsoft Graph API + bot registration
- Credential
- An Entra ID application registered as a bot, with a certificate credential in the secrets store.
Credentials are held in an encrypted secrets store. BRAIAN never stores end-user passwords.
Which permissions are required?
- ChannelMessage.Send / Chat.ReadWrite (bot)Sending approval and escalation messages in the channels and chats the bot is added to.
- User.Read.AllResolving the person responsible for an approval from the directory.
Permissions are requested at the minimum scope the configured processes require. Unused scopes are not granted.
Which processes use it?
Processes that run on this connection, and the domains they belong to.
Policy compliance
Access certification
Users request level 1-2-3
Used across every business domain.
Escalations surface in Teams; the decision is logged in BRAIAN.
How do you revoke access?
Access is revoked in Microsoft Teams itself — by disabling the credential or removing the granted scopes — or in BRAIAN by disconnecting the integration. Processes already running stop at their next call to Microsoft Teams and are held for review rather than completed with partial data; the interruption and the state of each process are recorded in the audit log.
FAQ
Does BRAIAN store data from Microsoft Teams?
BRAIAN reads what a process needs, when it needs it. Records retrieved from Microsoft Teams are held only for the duration of the process and in the audit trail of the actions taken; Microsoft Teams remains the system of record.
What happens if the connection fails mid-process?
The process stops at the failed step and is held for review. Nothing is written twice: completed writes stay recorded in the audit log and the remaining steps resume only once the connection is restored.
Can permissions be scoped per agent?
Yes. Scopes are defined per agent, not per system, so one agent can read while another cannot, on the same connection to Microsoft Teams.
