Module - Teams
Set of activities to be used to interact with MS Teams.
Activities
Send a message in a chat
| Technical Name |
Type |
Minimal Agent Version |
| chat.sendChatMessage |
asynchronous
|
WIN-3.24, MAC-3.24, CLOUD-3.34
|
Input Parameters:
Note:
To mention a user in a message use "<@user:email_adress_of_the_user>". And set renderType as renderAsHtml.
Errors:
| Error Class |
Package |
Description |
| RequestError |
irpa_core |
Error during request. |
| NotFound |
irpa_core |
User was not found on this tenant. |
| InvalidAuthenticationToken |
irpa_365online |
Invalid token was retrieved to call graphAPI. |
Get the list of available chats
| Technical Name |
Type |
Minimal Agent Version |
| chat.getChatList |
asynchronous
|
WIN-3.24, MAC-3.24, CLOUD-3.34
|
Input Parameters:
Output Parameters:
Errors:
| Error Class |
Package |
Description |
| RequestError |
irpa_core |
Error during request. |
| NotFound |
irpa_core |
User was not found on this tenant. |
| InvalidAuthenticationToken |
irpa_365online |
Invalid token was retrieved to call graphAPI. |
Get a list of messages from a chat (from newer to older)
| Technical Name |
Type |
Minimal Agent Version |
| chat.getMessageList |
asynchronous
|
WIN-3.24, MAC-3.24, CLOUD-3.34
|
Input Parameters:
| Name |
Type |
Attributes |
Default |
Description |
| chatId |
string |
mandatory
|
|
ID of the chat from which you want to get messages |
| size |
number |
optional
|
20 |
Maximum number of results to be retrieved. Maximum accepted is 500 |
Output Parameters:
Errors:
| Error Class |
Package |
Description |
| RequestError |
irpa_core |
Error during request. |
| InvalidAuthenticationToken |
irpa_365online |
Invalid token was retrieved to call graphAPI. |
| NotFound |
irpa_core |
User was not found on this tenant. |
Create a chat with selected members
| Technical Name |
Type |
Minimal Agent Version |
| chat.createChat |
asynchronous
|
WIN-3.24, MAC-3.24, CLOUD-3.34
|
Input Parameters:
| Name |
Type |
Attributes |
Default |
Description |
| chatMembers |
Array.<irpa_365online.chatMember> |
mandatory
|
|
List of Azure active directory members to add to the chat |
| title |
string |
optional
|
|
Title of chat (this is ignored if there is only one member in the chat) |
Output Parameters:
Note:
Members added are owner by default.
Errors:
| Error Class |
Package |
Description |
| RequestError |
irpa_core |
Error during request. |
| InvalidAuthenticationToken |
irpa_365online |
Invalid token was retrieved to call graphAPI. |
| NotFound |
irpa_core |
User was not found on this tenant. |
Get the availability of the current user in MS Teams
| Technical Name |
Type |
Minimal Agent Version |
| user.getAvailability |
asynchronous
|
WIN-3.24, MAC-3.24, CLOUD-3.34
|
Input Parameters:
| Name |
Type |
Attributes |
Default |
Description |
| userMail |
string |
optional
|
|
Mail address of the user |
Output Parameters:
Errors:
| Error Class |
Package |
Description |
| RequestError |
irpa_core |
Error during request. |
| NotFound |
irpa_core |
User was not found on this tenant. |
| InvalidAuthenticationToken |
irpa_365online |
Invalid token was retrieved to call graphAPI. |
Send a message to the channel of a team
| Technical Name |
Type |
Minimal Agent Version |
| teams.sendChannelMessage |
asynchronous
|
WIN-3.24, MAC-3.24, CLOUD-3.34
|
Input Parameters:
| Name |
Type |
Attributes |
Default |
Description |
| teamName |
string |
mandatory
|
|
Name of the team containing the channel |
| channelName |
string |
mandatory
|
|
Name of the channel to send the message to |
| messageToSend |
string |
mandatory
|
|
Message to send to the channel |
| renderType |
irpa_365online.enums.teams.message.renderType |
optional
|
renderAsText |
Render as HTML or render as plain text |
| importance |
irpa_365online.enums.teams.message.importance |
optional
|
normal |
Message importance |
Output Parameters:
| Name |
Type |
Description |
| messageChannelId |
string |
ID of the channel message |
Note:
To mention a user in a message use "<@user:email_adress_of_the_user>". And set renderType as renderAsHtml.
Errors:
| Error Class |
Package |
Description |
| RequestError |
irpa_core |
Error during request. |
| NotFound |
irpa_core |
Channel or team not found. |
| InvalidAuthenticationToken |
irpa_365online |
Invalid token was retrieved to call graphAPI. |