Communication
Microsoft Teams in your product and your AI agents, through one API
The Microsoft Teams toolkit covers teams, channels (list, create), channel messages and replies (read, post, reply) and chats (list chats, members and messages, send a chat message), as the connected user. Customers connect a work or school account with OAuth on your own app, and Connect renews the tokens and logs every execution.
15 days to try it. No credit card.
POST https://connect.reportei.com/api/tools/microsoft_teams_create_channel/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"team_id": "<team_id>",
"displayName": "<displayName>"
}
}How it works
From a connected customer to the first Microsoft Teams call.
- 1
Your customer connects the account
Your system opens a Connect session for the toolkit and your customer connects their Microsoft Teams account. You get the connection id.
- 2
Your product calls the tool
A POST to /api/tools/{tool}/execute with the connection id and arguments. On success, Connect preserves the app's response status and body.
- 3
Connect handles the rest
It stores the credential encrypted, renews tokens for OAuth connections that support renewal and records executions in an audit trail available through the API.
Use cases
What your product does with Microsoft Teams.
Notify a channel from your product
List the teams and channels of the user, pick one and post a message with Send channel message when something needs the team's attention.
Reply inside a thread
Read the root messages of a channel and their replies, then answer in the same thread with Reply to channel message, from a bot or an AI agent.
Chat assistant for a person
List the user's chats, read recent messages with List chat messages and send a message in an existing chat after the user approves the text.
Tools
12 Microsoft Teams tools
- List teamsGETLists the teams the user is a direct member of, with id, displayName, description and isArchived. Use the id as team_id in the other tools.
- List channelsGETLists the channels of a team that the user can see, with id, displayName, description, membershipType and webUrl. Private and shared channels appear only to their members. Use the id as channel_id in the message tools.
- Create channelPOSTCreates a standard channel, open to every member of the team, and returns it with its id. Private and shared channels need a member list and are not supported here.
- List channel messagesGETLists the root messages of a channel, without their replies, 20 per page and ordered by the latest activity of each thread. Only the first page comes back: the @odata.nextLink of the response cannot be followed here. Read a thread with List channel message replies.
- Get channel messageGETReturns one root message of a channel, with its body, the sender in from, createdDateTime and webUrl. Its replies are not included.
- List channel message repliesGETLists the replies to a root message of a channel. The root message is not included: read it with Get channel message. Only the first page comes back.
- Send channel messagePOSTPosts a new message in a channel as the user and returns it with its id. Microsoft's terms forbid using Teams as a log, so send only messages that people will read.
- Reply to channel messagePOSTPosts a reply in the thread of a root message of a channel, as the user, and returns it with its id. Send only messages that people will read.
- List chatsGETLists the one-on-one, group and meeting chats of the user, with id, topic, chatType and webUrl. One-on-one chats have no topic: use List chat members to see who is in a chat. Only the first page comes back.
- List chat membersGETLists the people in a chat, with displayName, email and userId.
OAuth with your product's app
You register your product's OAuth app once, with POST /api/merchants/credentials/microsoft_teams, and your customer authorizes the account on a consent screen. Connect renews the token when it is about to expire.
Questions about the Microsoft Teams toolkit
Do I need to build against the Microsoft Teams API?
No. Connect ships 12 Microsoft Teams tools, described and ready. Your customer connects the account and your system calls every tool through the same endpoint, with the same request format.
How does my customer connect their Microsoft Teams account?
With the mode the toolkit accepts: OAuth with your product's app. Connect stores the credential encrypted and never returns it to your system.
Does it work with AI agents?
Yes. Each tool's input is described in JSON Schema, which your agent uses directly as a tool definition. The agent picks the tool and the arguments, and your system makes the call to Connect.
Does my customer need a Reportei account?
No. Your customer connects the account on a Connect screen, or your system sends the credential through the API, and they keep using only your product.
Toolkits in the same category
See all 100 toolkitsSee Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
