Microsoft Teams é uma robusta plataforma de comunicação e colaboração que permite aos usuários participar de mensagens em tempo real, reuniões e compartilhamento de conteúdo dentro de equipes e organizações. Como parte do ecossistema de produtividade da Microsoft, o Microsoft Teams oferece funcionalidade de chat fluida integrada ao Office 365, permitindo publicar mensagens, coordenar trabalho e permanecer conectado entre dispositivos e fluxos de trabalho.
Com o Microsoft Teams, você pode:
- Enviar e receber mensagens: Comunicar-se instantaneamente com indivíduos ou grupos em threads de chat
- Colaborar em tempo real: Compartilhar atualizações e informações entre equipes em channels e chats
- Organizar conversas: Manter contexto com discussões em thread e histórico persistente de chat
- Compartilhar arquivos e conteúdo: Anexar e visualizar documentos, imagens e links diretamente no chat
- Integrar com o Microsoft 365: Conectar-se de forma fluida ao Outlook, SharePoint, OneDrive e mais
- Acessar em vários dispositivos: Usar o Teams no desktop, web e mobile com conversas sincronizadas na nuvem
- Comunicação segura: Aproveitar recursos de segurança e conformidade de nível empresarial
No Zoen, a integração do Microsoft Teams permite que seus agentes interajam diretamente com mensagens de chat de forma programática. Isso habilita cenários poderosos de automação, como enviar atualizações, publicar alertas, coordenar tarefas e responder a conversas em tempo real. Seus agentes podem escrever novas mensagens em chats ou channels, atualizar conteúdo com base em dados do fluxo de trabalho e engajar usuários onde a colaboração acontece. Ao integrar o Zoen ao Microsoft Teams, você conecta fluxos inteligentes à comunicação da equipe — capacitando seus agentes a agilizar a colaboração, automatizar tarefas de comunicação e manter suas equipes alinhadas.
Integrate Microsoft Teams into the workflow. Read, write, update, and delete chat and channel messages. Reply to messages, add reactions, and list teams, chats, channels, and their members. Can be used in trigger mode to trigger a workflow when a message is sent to a chat or channel. To mention users in messages, wrap their name in <at> tags: <at>userName</at>
Read content from a Microsoft Teams chat
| Parameter | Type | Required | Description |
|---|
chatId | string | Yes | The ID of the chat to read from (e.g., "19:abc123def456@thread.v2" - from chat listings) |
includeAttachments | boolean | No | Download and include message attachments (hosted contents) into storage |
| Parameter | Type | Description |
|---|
success | boolean | Teams chat read operation success status |
messageCount | number | Number of messages retrieved from chat |
chatId | string | ID of the chat that was read from |
messages | array | Array of chat message objects |
attachmentCount | number | Total number of attachments found |
attachmentTypes | array | Types of attachments found |
content | string | Formatted content of chat messages |
attachments | file[] | Uploaded attachments for convenience (flattened) |
Write or update content in a Microsoft Teams chat
| Parameter | Type | Required | Description |
|---|
chatId | string | Yes | The ID of the chat to write to (e.g., "19:abc123def456@thread.v2" - from chat listings) |
content | string | Yes | The content to write to the message (plain text or HTML formatted, supports @mentions) |
files | file[] | No | Files to attach to the message |
| Parameter | Type | Description |
|---|
success | boolean | Teams chat message send success status |
messageId | string | Unique identifier for the sent message |
chatId | string | ID of the chat where message was sent |
createdTime | string | Timestamp when message was created |
url | string | Web URL to the message |
updatedContent | boolean | Whether content was successfully updated |
files | file[] | Files attached to the message |
Read content from a Microsoft Teams channel
| Parameter | Type | Required | Description |
|---|
teamId | string | Yes | The ID of the team to read from (e.g., "12345678-abcd-1234-efgh-123456789012" - a GUID from team listings) |
channelId | string | Yes | The ID of the channel to read from (e.g., "19:abc123def456@thread.tacv2" - from channel listings) |
includeAttachments | boolean | No | Download and include message attachments (hosted contents) into storage |
| Parameter | Type | Description |
|---|
success | boolean | Teams channel read operation success status |
messageCount | number | Number of messages retrieved from channel |
teamId | string | ID of the team that was read from |
channelId | string | ID of the channel that was read from |
messages | array | Array of channel message objects |
attachmentCount | number | Total number of attachments found |
attachmentTypes | array | Types of attachments found |
content | string | Formatted content of channel messages |
attachments | file[] | Uploaded attachments for convenience (flattened) |
Write or send a message to a Microsoft Teams channel
| Parameter | Type | Required | Description |
|---|
teamId | string | Yes | The ID of the team to write to (e.g., "12345678-abcd-1234-efgh-123456789012" - a GUID from team listings) |
channelId | string | Yes | The ID of the channel to write to (e.g., "19:abc123def456@thread.tacv2" - from channel listings) |
content | string | Yes | The content to write to the channel (plain text or HTML formatted, supports @mentions) |
files | file[] | No | Files to attach to the message |
| Parameter | Type | Description |
|---|
success | boolean | Teams channel message send success status |
messageId | string | Unique identifier for the sent message |
teamId | string | ID of the team where message was sent |
channelId | string | ID of the channel where message was sent |
createdTime | string | Timestamp when message was created |
url | string | Web URL to the message |
updatedContent | boolean | Whether content was successfully updated |
files | file[] | Files attached to the message |
Update an existing message in a Microsoft Teams chat
| Parameter | Type | Required | Description |
|---|
chatId | string | Yes | The ID of the chat containing the message (e.g., "19:abc123def456@thread.v2" - from chat listings) |
messageId | string | Yes | The ID of the message to update (e.g., "1234567890123" - a numeric string from message responses) |
content | string | Yes | The new content for the message (plain text or HTML formatted) |
| Parameter | Type | Description |
|---|
success | boolean | Whether the update was successful |
messageId | string | ID of the updated message |
updatedContent | boolean | Whether content was successfully updated |
Update an existing message in a Microsoft Teams channel
| Parameter | Type | Required | Description |
|---|
teamId | string | Yes | The ID of the team (e.g., "12345678-abcd-1234-efgh-123456789012" - a GUID from team listings or channel info) |
channelId | string | Yes | The ID of the channel containing the message (e.g., "19:abc123def456@thread.tacv2" - from channel listings) |
messageId | string | Yes | The ID of the message to update (e.g., "1234567890123" - a numeric string from message responses) |
content | string | Yes | The new content for the message (plain text or HTML formatted) |
| Parameter | Type | Description |
|---|
success | boolean | Whether the update was successful |
messageId | string | ID of the updated message |
updatedContent | boolean | Whether content was successfully updated |
Soft delete a message in a Microsoft Teams chat
| Parameter | Type | Required | Description |
|---|
chatId | string | Yes | The ID of the chat containing the message (e.g., "19:abc123def456@thread.v2" - from chat listings) |
messageId | string | Yes | The ID of the message to delete (e.g., "1234567890123" - a numeric string from message responses) |
| Parameter | Type | Description |
|---|
success | boolean | Whether the deletion was successful |
deleted | boolean | Confirmation of deletion |
messageId | string | ID of the deleted message |
Soft delete a message in a Microsoft Teams channel
| Parameter | Type | Required | Description |
|---|
teamId | string | Yes | The ID of the team (e.g., "12345678-abcd-1234-efgh-123456789012" - a GUID from team listings or channel info) |
channelId | string | Yes | The ID of the channel containing the message (e.g., "19:abc123def456@thread.tacv2" - from channel listings) |
messageId | string | Yes | The ID of the message to delete (e.g., "1234567890123" - a numeric string from message responses) |
| Parameter | Type | Description |
|---|
success | boolean | Whether the deletion was successful |
deleted | boolean | Confirmation of deletion |
messageId | string | ID of the deleted message |
Reply to an existing message in a Microsoft Teams channel
| Parameter | Type | Required | Description |
|---|
teamId | string | Yes | The ID of the team (e.g., "12345678-abcd-1234-efgh-123456789012" - a GUID from team listings or channel info) |
channelId | string | Yes | The ID of the channel (e.g., "19:abc123def456@thread.tacv2" - from channel listings) |
messageId | string | Yes | The ID of the message to reply to (e.g., "1234567890123" - a numeric string from message responses) |
content | string | Yes | The reply content (plain text or HTML formatted message) |
| Parameter | Type | Description |
|---|
success | boolean | Whether the reply was successful |
messageId | string | ID of the reply message |
updatedContent | boolean | Whether content was successfully sent |
Get a specific message from a Microsoft Teams chat or channel
| Parameter | Type | Required | Description |
|---|
teamId | string | No | The ID of the team for channel messages (e.g., "12345678-abcd-1234-efgh-123456789012" - a GUID) |
channelId | string | No | The ID of the channel for channel messages (e.g., "19:abc123def456@thread.tacv2") |
chatId | string | No | The ID of the chat for chat messages (e.g., "19:abc123def456@thread.v2") |
messageId | string | Yes | The ID of the message to retrieve (e.g., "1234567890123" - a numeric string from message responses) |
| Parameter | Type | Description |
|---|
success | boolean | Whether the retrieval was successful |
content | string | The message content |
metadata | object | Message metadata including sender, timestamp, etc. |
↳ messageId | string | Message ID |
↳ content | string | Message content |
↳ createdTime | string | Message creation timestamp |
↳ url | string | Web URL to the message |
↳ teamId | string | Team ID |
↳ channelId | string | Channel ID |
↳ chatId | string | Chat ID |
↳ messages | array | Array of message details |
↳ messageCount | number | Number of messages |
Add an emoji reaction to a message in Microsoft Teams
| Parameter | Type | Required | Description |
|---|
teamId | string | No | The ID of the team for channel messages (e.g., "12345678-abcd-1234-efgh-123456789012" - a GUID) |
channelId | string | No | The ID of the channel for channel messages (e.g., "19:abc123def456@thread.tacv2") |
chatId | string | No | The ID of the chat for chat messages (e.g., "19:abc123def456@thread.v2") |
messageId | string | Yes | The ID of the message to react to (e.g., "1234567890123" - a numeric string from message responses) |
reactionType | string | Yes | The emoji reaction (e.g., ❤️, 👍, 😊) |
| Parameter | Type | Description |
|---|
success | boolean | Whether the reaction was added successfully |
reactionType | string | The emoji that was added |
messageId | string | ID of the message |
Remove an emoji reaction from a message in Microsoft Teams
| Parameter | Type | Required | Description |
|---|
teamId | string | No | The ID of the team for channel messages (e.g., "12345678-abcd-1234-efgh-123456789012" - a GUID) |
channelId | string | No | The ID of the channel for channel messages (e.g., "19:abc123def456@thread.tacv2") |
chatId | string | No | The ID of the chat for chat messages (e.g., "19:abc123def456@thread.v2") |
messageId | string | Yes | The ID of the message (e.g., "1234567890123" - a numeric string from message responses) |
reactionType | string | Yes | The emoji reaction to remove (e.g., ❤️, 👍, 😊) |
| Parameter | Type | Description |
|---|
success | boolean | Whether the reaction was removed successfully |
reactionType | string | The emoji that was removed |
messageId | string | ID of the message |
List all members of a Microsoft Teams team
| Parameter | Type | Required | Description |
|---|
teamId | string | Yes | The ID of the team (e.g., "12345678-abcd-1234-efgh-123456789012" - a GUID from team listings) |
| Parameter | Type | Description |
|---|
success | boolean | Whether the listing was successful |
members | array | Array of team members |
memberCount | number | Total number of members |
List all members of a Microsoft Teams channel
| Parameter | Type | Required | Description |
|---|
teamId | string | Yes | The ID of the team (e.g., "12345678-abcd-1234-efgh-123456789012" - a GUID from team listings) |
channelId | string | Yes | The ID of the channel (e.g., "19:abc123def456@thread.tacv2" - from channel listings) |
| Parameter | Type | Description |
|---|
success | boolean | Whether the listing was successful |
members | array | Array of channel members |
memberCount | number | Total number of members |
List all members of a Microsoft Teams chat
| Parameter | Type | Required | Description |
|---|
chatId | string | Yes | The ID of the chat (e.g., "19:abc123def456@thread.v2" - from chat listings) |
| Parameter | Type | Description |
|---|
success | boolean | Whether the listing was successful |
members | array | Array of chat members |
memberCount | number | Total number of members |
hasMore | boolean | Whether Graph indicated additional pages beyond this response |
List the Microsoft Teams the current user is a direct member of
| Parameter | Type | Required | Description |
|---|
| Parameter | Type | Description |
|---|
success | boolean | Whether the listing was successful |
teams | array | Array of teams the user is a member of |
teamCount | number | Total number of teams |
hasMore | boolean | Whether Graph indicated additional pages beyond this response |
List the Microsoft Teams chats the current user is part of
| Parameter | Type | Required | Description |
|---|
| Parameter | Type | Description |
|---|
success | boolean | Whether the listing was successful |
chats | array | Array of chats the user is part of |
chatCount | number | Total number of chats |
hasMore | boolean | Whether Graph indicated additional pages beyond this response |
List all channels in a Microsoft Teams team
| Parameter | Type | Required | Description |
|---|
teamId | string | Yes | The ID of the team (e.g., "12345678-abcd-1234-efgh-123456789012" - a GUID from team listings) |
| Parameter | Type | Description |
|---|
success | boolean | Whether the listing was successful |
channels | array | Array of channels in the team |
channelCount | number | Total number of channels |
hasMore | boolean | Whether Graph indicated additional pages beyond this response |
A Trigger is a block that starts a workflow when an event happens in this service.
Trigger workflow from Microsoft Teams channel messages via outgoing webhooks
| Parameter | Type | Required | Description |
|---|
hmacSecret | string | Yes | The security token provided by Teams when creating an outgoing webhook. Used to verify request authenticity. |
| Parameter | Type | Description |
|---|
from | object | from output from the tool |
↳ id | string | Sender ID |
↳ name | string | Sender name |
↳ aadObjectId | string | AAD Object ID |
message | object | message output from the tool |
↳ raw | object | raw output from the tool |
↳ attachments | json | Array of attachments |
↳ channelData | object | channelData output from the tool |
↳ team | object | team output from the tool |
↳ id | string | Team ID |
↳ tenant | object | tenant output from the tool |
↳ id | string | Tenant ID |
↳ channel | object | channel output from the tool |
↳ id | string | Channel ID |
↳ teamsTeamId | string | Teams team ID |
↳ teamsChannelId | string | Teams channel ID |
↳ conversation | object | conversation output from the tool |
↳ id | string | Composite conversation ID |
↳ name | string | Conversation name (nullable) |
↳ isGroup | boolean | Is group conversation |
↳ tenantId | string | Tenant ID |
↳ aadObjectId | string | AAD Object ID (nullable) |
↳ conversationType | string | Conversation type (channel) |
↳ text | string | Message text content |
↳ messageType | string | Message type |
↳ channelId | string | Channel ID (msteams) |
↳ timestamp | string | Timestamp |
activity | object | Activity payload |
conversation | object | conversation output from the tool |
↳ id | string | Composite conversation ID |
↳ name | string | Conversation name (nullable) |
↳ isGroup | boolean | Is group conversation |
↳ tenantId | string | Tenant ID |
↳ aadObjectId | string | AAD Object ID (nullable) |
↳ conversationType | string | Conversation type (channel) |
Trigger workflow from new messages in Microsoft Teams chats via Microsoft Graph subscriptions
| Parameter | Type | Required | Description |
|---|
triggerCredentials | string | Yes | This trigger requires microsoft teams credentials to access your account. |
triggerChatId | string | Yes | The ID of the Teams chat to monitor |
includeAttachments | boolean | No | Fetch hosted contents and upload to storage |
| Parameter | Type | Description |
|---|
message_id | string | Message ID |
chat_id | string | Chat ID |
from_name | string | Sender display name |
text | string | Message body (HTML or text) |
created_at | string | Message timestamp |
attachments | file[] | Uploaded attachments as files |