Chats

Chats works with your Microsoft Teams chats: it lists your chats, either all of them or only the ones with a specific person, looks up who takes part in a chat and adds someone to an existing chat.

It is useful as a first step for Chat Messages, to find out which chats you have with a client or a colleague, or for an AI agent to tell you which conversations have pending messages.

When to use it

• An AI agent needs to find your conversations with a person before reading them.
• You want to know who is in a group chat before sending a notice.
• When someone joins a project, you want to add them to the team’s chat.
• You want a summary of your chats with their latest message and whether you have unread messages.

Configuration

You need a Microsoft Teams credential, which connects by signing in with your Microsoft account. See Credentials.

Field	What it does
Credential (required)	The Microsoft Teams credential used to access your chats. Choosing it loads your chats.
Operation (required)	What the component does. See Operations. By default, Get User Chats.
Chats with User Email	A person’s email address to keep only your chats with them. Empty, all your chats are returned. Only in Get User Chats.
Number of Chats	How many chats are looked up. By default, 20. Only in Get User Chats.
Chat ID	The chat you work with, picked by its topic. Chats without a topic appear as Chat followed by the start of their identifier. In Get Chat Members and Add Chat Member.
User ID	The identifier of the person you add to the chat. You can get it with Get Chat Members in another chat or with Channel. Only in Add Chat Member.
Member Role	The person’s role in the chat: guest or owner. By default, guest. Only in Add Chat Member.

Operations

Operation	What it does
Get User Chats	Lists your chats, with their topic, type, members, date of last activity, their latest message and whether you have unread messages.
Get Chat Members	Lists the members of a chat, with their name, email and role.
Add Chat Member	Adds a person to an existing chat.

Output

The Data output returns one item for each chat or member found, or a single item confirming that the person was added.

You can pass the chat to Chat Messages to read or send messages, or connect the result to an agent. The component can also be connected to an Agent as a tool, so the agent decides when to look at your chats. See Tool Mode.

Example

An agency’s account manager wants a summary every morning of the pending chats with a client.

1. Add Chats with the Get User Chats operation and the account manager’s Microsoft Teams credential.
2. In Chats with User Email, enter the client’s email.
3. Connect the Data output to an agent that reviews each chat’s latest message and the unread messages, and prepares the summary.
4. Schedule the flow to run every morning from the Scheduler.

Related components

• Chat Messages: send and read messages in chats.
• Channel: look up teams and channels.