NAiOS IconNAiOS Logo
Contacto
Volver al catálogo

Microsoft Teams

microsoft_teams

Microsoft Teams integrates chat, video meetings, and file storage within Microsoft 365, providing virtual collaboration and communication for distributed teams

Team ChatTeam CollaborationVideo ConferencingWeb del proveedor
Acciones
28
Triggers
0
Autenticación
—
OAuth gestionado
Sí
Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (28)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Add member to teamMICROSOFT_TEAMS_ADD_MEMBER_TO_TEAMAcción

Tool to add a user to a microsoft teams team. use when granting or updating membership for a user.

Parámetros de entrada

  • rolesstring[]

    Roles to assign to the member. Only 'owner' is supported. Omit or leave empty to add as a standard member.

  • team_idstringObligatorio

    The unique ID (GUID) of the Microsoft Team to which the member will be added.

  • user_idstringObligatorio

    The user's Graph ID (GUID) or userPrincipalName (email) to add to the team.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Archive Teams teamMICROSOFT_TEAMS_ARCHIVE_TEAMAcción

Tool to archive a microsoft teams team. use after confirming the team id; returns 202 if accepted.

Parámetros de entrada

  • team_idstringObligatorio

    The Microsoft Teams team GUID to archive.

  • should_set_spo_site_read_only_for_membersboolean

    If true, sets the SharePoint site to read-only for team members when archiving.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get all chatsMICROSOFT_TEAMS_CHATS_GET_ALL_CHATSAcción

Retrieves all microsoft teams chats a specified user is part of, supporting filtering, property selection, and pagination.

Parámetros de entrada

  • topinteger

    The maximum number of chats to retrieve in a single API call, used for pagination. Default is 50. Must be a positive integer.

  • filterstring

    An OData filter query string to apply to the chat list (e.g., "topic eq 'Project Updates'"). Do not include '$filter=' in the string. This enables retrieving chats that match specific criteria.

  • selectstring[]

    A list of specific Microsoft Graph chat resource properties to retrieve (e.g., 'id', 'topic'). If omitted or empty, a default set of properties is returned. Each string in the list should be a valid property name.

  • user_idstring

    The ID or user principal name (UPN) of the user whose chats are to be retrieved. Use 'me' to specify the currently authenticated user.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get all chat messagesMICROSOFT_TEAMS_CHATS_GET_ALL_MESSAGESAcción

Retrieves all messages from a specified microsoft teams chat using the microsoft graph api, automatically handling pagination; ensure `chat id` is valid and odata expressions in `filter` or `select` are correct.

Parámetros de entrada

  • topinteger

    Maximum number of messages to retrieve per page. Used for pagination.

  • filterstring

    OData v4.0 filter query string for messages. If empty, no filtering is applied.

  • selectstring[]

    Message properties to return (e.g., 'id', 'body'). Optimizes the request. If empty, a default set of properties is returned.

  • chat_idstringObligatorio

    Unique identifier of the Microsoft Teams chat.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create online meetingMICROSOFT_TEAMS_CREATE_MEETINGAcción

Use to schedule a new standalone microsoft teams online meeting, i.e., one not linked to any calendar event.

Parámetros de entrada

  • subjectstringObligatorio

    The subject or title for the online meeting.

  • participantsobject[]

    An optional list of participants to invite to the meeting. Each participant is defined by their user ID and role.

  • end_date_timestringObligatoriodate-time

    The end date and time of the meeting, specified in ISO 8601 format (e.g., '2024-08-15T11:00:00Z'). Must be after start_date_time.

  • start_date_timestringObligatoriodate-time

    The start date and time of the meeting, specified in ISO 8601 format (e.g., '2024-08-15T10:00:00Z').

  • is_passcode_requiredboolean

    An optional boolean indicating whether a passcode should be required to join this meeting. If not specified, the organization's default policy applies.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create TeamMICROSOFT_TEAMS_CREATE_TEAMAcción

Tool to create a new microsoft teams team. use when you need to provision a team with optional template, channels, and members.

Parámetros de entrada

  • membersobject[]

    List of initial members to add to the team. Each must include '@odata.type', roles, and 'user@odata.bind'.

  • visibilitystringObligatorioenum
    privatepublic
  • descriptionstring

    Description for the new team.

  • displayNamestringObligatorio

    Name of the new team.

  • firstChannelNamestring

    Name of the first channel created; defaults to 'General' if omitted.

  • template_odata_bindstring

    URL of the Teams template to apply.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete Teams teamMICROSOFT_TEAMS_DELETE_TEAMAcción

Tool to delete a microsoft teams team. use after confirming the target team id.

Parámetros de entrada

  • team_idstringObligatorio

    The unique identifier (GUID) of the Microsoft Teams team to delete.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get team channelMICROSOFT_TEAMS_GET_CHANNELAcción

Tool to get a specific channel in a team. use after obtaining valid team and channel ids to fetch channel details.

Parámetros de entrada

  • team_idstringObligatorio

    The unique identifier of the Microsoft Teams team.

  • channel_idstringObligatorio

    The unique identifier of the channel within the specified team.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get chat messageMICROSOFT_TEAMS_GET_CHAT_MESSAGEAcción

Tool to get a specific chat message. use after confirming chat id and message id.

Parámetros de entrada

  • chat_idstringObligatorio

    Unique identifier of the Microsoft Teams chat that contains the message.

  • message_idstringObligatorio

    Unique identifier of the chat message to retrieve.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get TeamMICROSOFT_TEAMS_GET_TEAMAcción

Tool to get a specific team. use when full details of one team by id are needed.

Parámetros de entrada

  • team_idstringObligatorio

    GUID of the Microsoft Teams team to retrieve.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List message repliesMICROSOFT_TEAMS_LIST_MESSAGE_REPLIESAcción

Tool to list replies to a channel message. use after obtaining team, channel, and message ids.

Parámetros de entrada

  • topinteger

    Maximum number of replies to return per page (1-50).

  • team_idstringObligatorio

    Unique identifier (GUID) of the Microsoft Teams team.

  • channel_idstringObligatorio

    Unique identifier of the channel within the team.

  • message_idstringObligatorio

    Unique identifier of the channel message whose replies are to be listed.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List team membersMICROSOFT_TEAMS_LIST_TEAM_MEMBERSAcción

Tool to list members of a microsoft teams team. use when you need to retrieve the members of a specific team, for auditing or notifications.

Parámetros de entrada

  • topinteger

    Optional maximum number of members to return (1–999).

  • team_idstringObligatorio

    GUID of the Microsoft Teams team to retrieve members from.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List Teams templatesMICROSOFT_TEAMS_LIST_TEAMS_TEMPLATESAcción

Tool to list available microsoft teams templates. use when retrieving templates for team creation or customization workflows.

Parámetros de entrada

  • topinteger

    Maximum number of templates to return (1–999).

  • skipinteger

    Number of templates to skip for pagination.

  • countboolean

    If true, include a count of total matching templates in the response.

  • filterstring

    OData filter expression to filter the templates (e.g., "startsWith(displayName,'Template')").

  • selectstring

    Comma-separated template properties to include in the response (e.g., 'id,displayName,description'). If empty, default properties are returned.

  • orderbystring

    Comma-separated properties and directions to order the results by (e.g., 'displayName desc').

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List usersMICROSOFT_TEAMS_LIST_USERSAcción

Tool to list all users in the organization. use when you need to retrieve directory users with filtering, pagination, and field selection.

Parámetros de entrada

  • $topinteger

    Maximum number of users to return per page (1-999).

  • $skipinteger

    Number of users to skip for pagination.

  • $expandstring

    OData expand related entities (e.g., `manager`).

  • $filterstring

    OData filter to refine results by property values (e.g., `startswith(displayName,'A')`).

  • $selectstring

    Comma-separated list of user properties to include (e.g., `id,displayName,mail`).

  • $orderbystring

    OData orderby clause to sort results (e.g., `displayName desc`).

  • consistencyLevelstring

    Set to 'eventual' when using advanced queries with $count.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create a channelMICROSOFT_TEAMS_TEAMS_CREATE_CHANNELAcción

Creates a new 'standard', 'private', or 'shared' channel within a specified microsoft teams team.

Parámetros de entrada

  • namestringObligatorio

    The display name for the new channel. Maximum length is 50 characters. Cannot contain characters ~ # % & * { } + / \ : < > ? | ' " or start with an underscore or period, or end with a period.

  • team_idstringObligatorio

    The GUID of the existing Microsoft Teams team where the new channel will be created.

  • descriptionstring

    An optional, user-friendly description of the channel's purpose. Maximum length is 1024 characters.

  • membership_typestring

    Membership type determining channel accessibility: 'standard' is accessible to all team members, 'private' is only accessible to a specific subset of team members, and 'shared' can be shared with people outside the team or organization (requires appropriate policies).

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create ChatMICROSOFT_TEAMS_TEAMS_CREATE_CHATAcción

Creates a new chat; if a 'oneonone' chat with the specified members already exists, its details are returned, while 'group' chats are always newly created.

Parámetros de entrada

  • topicstring

    Subject or title for a group chat; ignored for 'oneOnOne' chats.

  • membersobject[]Obligatorio

    List of members. For 'oneOnOne' chats, exactly two members are expected. For 'group' chats, at least one member must have the 'owner' role.

  • chatTypestringObligatorio

    Type of chat. If 'oneOnOne' for members with an existing chat, that chat's details are returned.

Parámetros de salida

  • dataanyObligatorio

    Complete JSON response from the API representing the created or existing chat.

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Teams messageMICROSOFT_TEAMS_TEAMS_GET_MESSAGEAcción

Retrieves a specific message from a microsoft teams channel using its team, channel, and message ids.

Parámetros de entrada

  • team_idstringObligatorio

    ID of the Team containing the channel where the message is located.

  • channel_idstringObligatorio

    ID of the Channel within the specified Team that contains the message.

  • message_idstringObligatorio

    ID of the message to retrieve from the channel.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List TeamsMICROSOFT_TEAMS_TEAMS_LISTAcción

Retrieves microsoft teams accessible by the authenticated user, allowing filtering, property selection, and pagination.

Parámetros de entrada

  • topinteger

    Maximum number of teams to return per page (1-999). Used for pagination; see `next_link` in response.

  • filterstring

    OData v4.0 filter string to refine results based on team properties (e.g., `startsWith(displayName,'A')`). Consult OData v4.0 documentation for syntax.

  • selectstring

    Comma-separated team properties to retrieve (e.g., 'id,displayName,description'). If empty or omitted, standard properties are returned. Supported properties include `id`, `displayName`, `description`, `visibility`.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List team channelsMICROSOFT_TEAMS_TEAMS_LIST_CHANNELSAcción

Retrieves channels for a specified microsoft teams team id (must be valid and for an existing team), with options to include shared channels, filter results, and select properties.

Parámetros de entrada

  • filterstring

    OData v4 query string to filter channels (e.g., `startswith(displayName,'Sales')` or `membershipType eq 'private'`).

  • selectstring

    Comma-separated channel properties to return (e.g., 'id,displayName,description'); empty for default properties. Common: `id`, `displayName`, `description`, `email`, `membershipType`, `webUrl`.

  • team_idstringObligatorio

    Unique identifier (ID) of the Microsoft Teams team.

  • include_shared_channelsboolean

    If true, include channels shared with the team.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List chat messagesMICROSOFT_TEAMS_TEAMS_LIST_CHAT_MESSAGESAcción

Retrieves messages (newest first) from an existing and accessible microsoft teams one-on-one chat, group chat, or channel thread, specified by `chat id`.

Parámetros de entrada

  • topinteger

    Maximum number of messages to retrieve.

  • chat_idstringObligatorio

    Unique identifier of the Microsoft Teams chat from which to retrieve messages.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List PeopleMICROSOFT_TEAMS_TEAMS_LIST_PEOPLEAcción

Retrieves a list of people relevant to a specified user from microsoft graph, noting the `search` parameter is only effective if `user id` is 'me'.

Parámetros de entrada

  • topinteger

    Maximum number of items per page for pagination. Actual count may be less. Service default if unspecified.

  • skipinteger

    Number of items to skip for pagination.

  • filterstring

    OData $filter query to limit results (e.g., `"startsWith(displayName,'A')"`).

  • searchstring

    Fuzzy search query (name, email, or topic like 'topic:marketing'). Effective only when `user_id` is 'me'.

  • selectstring

    Comma-separated OData property names to include for each person (e.g., 'id,displayName'). If unspecified, a default set is returned.

  • orderbystring

    OData $orderby expression to sort results (e.g., 'displayName asc, relevanceScore desc').

  • user_idstring

    Identifier of the user (e.g., 'me', 'adelev@contoso.com', or GUID) whose relevant people are to be retrieved.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Post message to Teams channelMICROSOFT_TEAMS_TEAMS_POST_CHANNEL_MESSAGEAcción

Posts a new text or html message to a specified channel in a microsoft teams team.

Parámetros de entrada

  • contentstringObligatorio

    The content of the message to be sent. Can be plain text or HTML, determined by `content_type`.

  • team_idstringObligatorio

    The unique identifier of the Microsoft Teams team containing the channel.

  • channel_idstringObligatorio

    The unique identifier of the channel within the specified team where the message will be posted.

  • content_typestring

    The format of the message content. Supported values: 'text' (plain text) or 'html' (HTML content). Defaults to 'text'.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Send message to Teams chatMICROSOFT_TEAMS_TEAMS_POST_CHAT_MESSAGEAcción

Sends a non-empty message (text or html) to a specified, existing microsoft teams chat; content must be valid html if `content type` is 'html'.

Parámetros de entrada

  • chat_idstringObligatorio

    Unique identifier for the Microsoft Teams chat to receive the message.

  • contentstringObligatorio

    Message content, either plain text or HTML (see `content_type`).

  • content_typestring

    Content format: 'text' (plain) or 'html'.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Reply to Teams channel messageMICROSOFT_TEAMS_TEAMS_POST_MESSAGE_REPLYAcción

Sends a reply to an existing message, identified by `message id`, within a specific `channel id` of a given `team id` in microsoft teams.

Parámetros de entrada

  • contentstringObligatorio

    The body of the reply message. This can be plain text or HTML, as specified by the `content_type` field.

  • team_idstringObligatorio

    The unique identifier (GUID) of the Microsoft Teams team that contains the channel where the message to be replied to exists.

  • channel_idstringObligatorio

    The unique identifier of the channel within the specified team. This channel contains the message to which the reply will be posted. Channel IDs typically follow a format like '19:{alphanumeric_string}@thread.tacv2'.

  • message_idstringObligatorio

    The unique identifier of the specific message within the channel to which this reply is directed.

  • content_typestring

    Specifies the format of the `content` field. Accepted values are 'text' for plain text content and 'html' for content with HTML formatting. Defaults to 'text' if not provided.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Unarchive Teams teamMICROSOFT_TEAMS_UNARCHIVE_TEAMAcción

Tool to unarchive a microsoft teams team. use when you need to restore an archived team to active state.

Parámetros de entrada

  • team_idstringObligatorio

    The unique identifier (GUID) of the team to unarchive.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update Teams channel messageMICROSOFT_TEAMS_UPDATE_CHANNEL_MESSAGEAcción

Tool to update a message in a channel. use when you need to modify an existing channel message after confirming channel and message ids.

Parámetros de entrada

  • contentstringObligatorio

    Updated message content, either plain text or HTML.

  • team_idstringObligatorio

    Unique identifier of the Microsoft Teams team.

  • channel_idstringObligatorio

    Unique identifier of the channel within the team.

  • message_idstringObligatorio

    Unique identifier of the channel message to update.

  • content_typestring

    Format of the message content: 'text' or 'html'.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update Teams chat messageMICROSOFT_TEAMS_UPDATE_CHAT_MESSAGEAcción

Tool to update a specific message in a chat. use when you need to correct or modify a sent chat message.

Parámetros de entrada

  • chat_idstringObligatorio

    Unique identifier of the Microsoft Teams chat.

  • contentstringObligatorio

    Updated message content, either plain text or HTML.

  • message_idstringObligatorio

    Unique identifier of the chat message to update.

  • content_typestring

    Format of the message content: 'text' or 'html'.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update TeamMICROSOFT_TEAMS_UPDATE_TEAMAcción

Tool to update the properties of a team. use when you need to modify team settings such as member, messaging, or fun settings.

Parámetros de entrada

  • team_idstringObligatorio

    The unique identifier (GUID) of the team to update.

  • funSettingsobject

    Settings that control fun features in the team.

  • memberSettingsobject

    Settings that control what members can do in the team.

  • messagingSettingsobject

    Settings that control messaging capabilities in the team.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not