Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
[This article is prerelease documentation and is subject to change.]
Teams has a number of areas that your application has access to via its API. These are all available via the app.api object. Here is a short summary of the different areas:
| Area | Description |
|---|---|
conversations |
Gives your application the ability to perform activities on conversations (send, update, delete messages, etc.), or create conversations (like 1:1 chat with a user) |
meetings |
Gives your application access to meeting details |
teams |
Gives your application access to team or channel details |
An instance of the Api Client is passed to handlers that can be used to fetch details:
Example
In this example, we use the api client to fetch the members in a conversation. The api object is passed to the activity handler in this case.
app.on('message', async ({ activity, api }) => {
const members = await api.conversations.members(activity.conversation.id).get();
});
Proactive API
It's also possible to access the api client from outside a handler via the app instance. Here we have the same example as above, but we're access the api client via the app instance.
const res = await app.api.graph.chats.getAllMessages.get();