List Chats
Description
Microsoft Teams: List Chats plugin step lists chats from Microsoft Teams.
References
https://docs.microsoft.com/en-us/graph/api/chat-list?view=graph-rest-1.0&tabs=http
Permissions Following are the required permissions:
| Permission type | Permission (from least to most privileged) |
|---|---|
| Delegated (work or school account) | offline_access, Chat.ReadBasic, Chat.Read, Chat.ReadWrite |
Configurations
| No. | Field Name | Description |
|---|---|---|
| 1 | Step Name | Name of the step. This name has to be unique in a single workflow. |
| Connection | ||
| 2 | Tenant ID | Select the Tenant ID. For more details, see connection documentation. The field data type is String. This is a mandatory field. |
| 3 | Client ID | Select the Client ID. For more details, see connection documentation. The field data type is String. This is a mandatory field. |
| 4 | Accept Value as variable/static | Leave checkbox unchecked to accept Client Secret from a field in the previous steps of the stream using a drop down list. Else enable checkbox for Client Secret field to appear as Text box. |
| 5 | Client Secret | Specify the Client Secret of Microsoft Teams application. Client Secret is entered using a widget. If the Accept Values as variable/static check box is selected, then the Client Secret field appears as text box and accepts static values or variables. Else, select Client Secret from the drop down list. The field data type is String. This is a mandatory field. |
| 6 | Accept Value as variable/static | Leave checkbox unchecked to accept Refresh Token from a field in the previous steps of the stream using a drop down list. Else enable checkbox for Refresh Token field to appear as Text box. |
| 7 | Refresh Token | Provide the Refresh Token provided by authorization grant flow. If the Accept Values as variable/static check box is selected, then the Refresh Token field appears as text box and accepts static values or variables. Else, select Refresh Token from the drop down list. The field data type is String. This is a mandatory field. |
| 8 | Test Connection | Verifies whether the connection is established or not. Note: For the purpose of verification fields coming from previous steps are not allowed since field values can only be accessed when workflow is in running state. Static values and environment variables are allowed. |
| Input Fields: | ||
| 1 | Filter | Use the filter query parameter to retrieve just a subset of a collection. For more information, click https://docs.microsoft.com/en-us/graph/query-parameters#filter-parameter The data type is String This field is mandatory. |
| Output Fields: | ||
| 1 | Chats | Provide output field name. Default value is ‘Chats’. |
Known Issues:
For Expand field the ‘lastMessagePreview’ property is not working. Error thrown is ‘Parsing OData Select and Expand failed: Could not find a property named 'lastMessagePreview' on type 'microsoft.graph.chat'’.