- Release Notes
- Overview
- Getting Started
- Marketplace Vendors
- Marketplace Customers
- Publishing Guidelines
- Publishing Guidelines for Ready-to-go Automations
- Publishing Guidelines for Solution Accelerators
- Publishing Guidelines for Integration Service Connectors
- Security & IP Protection
- Other UiPath Listings
- Node-RED
- Setup
- Quickstart - Get Teams, Channels, and Messages
- Quickstart - Get Chats and Send Message
- Teams
- Microsoft Teams Scope
- Create Team
- Create Team From Group
- Get Team
- Get Teams
- Channels
- Create Channel
- Delete Channel
- Get Channel
- Get Channels
- Update Channel
- Chats
- Get Chat
- Get Chats
- Get Chat Members
- Messages
- Get Message
- Get Messages
- Get Message Replies
- Reply To Message
- Send Message
- Events
- Create Event
- Delete Event
- Get Event
- Get Events
- Users
- Get User Presence
- How It Works
- Technical References
- Get Started
- About
- Setup
- Technical References
- Azure Form Recognizer Scope
- Activities
- Analyze Form
- Analyze Form Async
- Get Analyze Form Result
- Analyze Receipt
- Analyze Receipt Async
- Get Analyze Receipt Result
- Analyze Layout
- Analyze Layout Async
- Get Analyze Layout Result
- Train Model
- Get Models
- Get Model Keys
- Get Model Info
- Delete Model
- Connectors
- How to Create Activities
- Build Your Integration
Quickstart - Get Chats and Send Message
The purpose of this guide is to help you create a working sample that uses different Microsoft Teams activities, including the Get Chats, Get Chat Members, Send Message and Get Message activities.
This working sample enables you to quickly verify the connection to your registered Microsoft Teams application and get familiar with the activity's input/output datatypes.
After completing the steps in this guide, you'll have an automation sequence that does the following:
- Establishes a connection to your registered Microsoft Teams application (Microsoft Teams Scope).
- Retrieves all of your chats (Get Chats).
- Retrieves the members of each of your chats (For Each and Get Chat Members).
- Locates the chat that includes a specific chat member and sends a message (If, Assign, and Send Message.
-
Verifies the message was sent successfully by retrieving and outputting the message Id and message content Get Message and Write Line).
Before you begin:
- Complete the Microsoft Teams Setup steps.
- Create or use an existing chat, send at least one chat message.
- Add the Microsoft Teams Scope activity to your project.
-
Enter the ApplicationId for your registered application.
- For more information, see the Register your application section in Setup guide.
-
From the AuthenticationType drop-down list, select the applicable authentication flow (e.g., InteractiveToken).
- For more information, see the Unattended vs. Attended Automation in the Microsoft Teams Scope activity page.
-
Add the Get Chats activity after the Microsoft Teams Scope activity.
-
Create and enter a
Chat[]
variable for your Chats value (e.g., myChats).- When creating your variable, select Microsoft.Graph.Chat as the variable type.
- Add a For Each activity after the Get Chats activity.
- In the TypeArgument property, select Microsoft.Graph.Chat.
- In the Values property, enter the
Chat[]
variable you created for the Get Chats activity (e.g., myChats).
-
-
In the For Each activity, add an Assign.
- Create and enter a
String
variable for the To property (e.g., chatId) -
In Value property, enter item.Id.
- Creating and assigning the item.id value to this variable enables it to be used in a later For Each activity that has a different argument type.
- Add the Get Chat Members activity after the Assign activity.
- In the ChatId property, enter Item.Id to get the members for each chat.
-
Create and enter a
ConversationMember[]
variable for your ChatMembers value (e.g., myChatMembers).- When creating your variable, select Microsoft.Graph.ConversationMember as the variable type.
- Add another For Each activity after the Get Chat Members activity.
- In the TypeArgument property, select Microsoft.Graph.ConversationMember.
- In the Values property, enter the
ConversationMember[]
variable you created for the Get Chat Members activity (e.g., myChatMembers).
- Create and enter a
-
In the For Each activity, add an If activity.
- In the Condition property, enter a value to identify a specific chat by member (e.g., item.DisplayName="Sarah Connor")
-
In the Then sequence block, add the Send Message activity.
- In the ChatId property, enter the
String
variable you created for the Assign activity (e.g., chatId). - Enter your Body content that you want to send (e.g., "Just saying hi")
- In the BodyType property, enter BodyType.Text.
-
Create and enter a new
String
variable for your MessageId value (e.g., newMessageId)
- In the ChatId property, enter the
-
To test that your activities retrieved your Chats, the Chat Members, and sent a Message, add a Write Line activity after the Send Message activity.
- In the Text property, enter the
String
variable you created for the Send Message activity (e.g., newMessageId)
- In the Text property, enter the
-
Add the Get Message activity after the Write Line activity.
- In the ChatId property, enter the
String
variable you created for the Assign activity (e.g., chatId). -
In the MessageId property, enter the
String
variable you created for the Send Message activity (e.g., newMessageId).3 . Create and enter aChatMessage
variable for your Message value (e.g., newMessage).- When creating your variable, select _Microsoft.Graph.ChatMessage_as the variable type.
- Add another Write Line activity after the Get Message activity.
- In the Text property, enter the
ChatMessage
variable you created for the Get Message activity and append .Body.Content to the end of it (e.g. newMessage.Body.Content)
- In the ChatId property, enter the
-
Click Run and verify the Output window includes your sent message Id and content.
You're done!
When you're ready, try the other Quickstart guides to get more familiar with the different Microsoft Teams activities.
To learn more about the Microsoft Teams activities (including example property inputs/outputs), see the following activity pages for a complete activity list and links to the activity detail pages.