activities
latest
false
UiPath logo, featuring letters U and I in white

Integration Service Activities

Last updated Feb 19, 2026

Send Channel Message

Description

Sends a message in a team channel.

Project compatibility

Windows | Cross-platform

Configuration

  • Connection - The connection established in Integration Service. Access the dropdown menu to choose, add, or manage connections.

  • Select Switch to object view to explore and map your data using the Data Mapping editor.

  • Team ID - The ID of the team the channel belongs to. Enter the name of the team to retrieve it from the available drop-down list or type in a custom team ID. You can retrieve the ID from the output of the Get Team by Name activity. This field supports String type input.
  • Channel ID - The ID of the channel where to send the message. Enter the name of the channel to retrieve it from the available drop-down list or type a channel ID. You can retrieve the ID from the output of the Get Channel by Name activity. This field supports String type input.
  • Message body - The content of the message you want to send. This field supports String type input.
  • Adaptive card JSON - Enter the adaptive card string by converting the generated JSON from https://adaptivecards.io/designer. Replace \" with ' and remove all the escape characters that contain '\', such as \n, \r. For example, replace \r\n\"type\" with 'type'. For details, refer to the Microsoft Teams API documentation and Adaptive cards documentation.
  • Image - The image attachment you want to upload. This field supports IResource type input.
  • File ID - Enter one or more SharePoint file IDs in a comma-separated format. You can retrieve this ID from the output of Get File or Folder or Upload Files (Microsoft 365 activities). This field supports String type input.
Manage Properties

Use the Manage Properties wizard to configure or use any of the object's standard or custom fields. You can select fields to add them to the activity canvas. The added standard or custom fields are available in the Properties panel (in Studio Desktop) or under Show additional properties (in Studio Web).

Additional properties

Options

  • Mentions ID – Numeric identifier linking <at> tags in message text to mention entries. Must match the id attribute in the HTML <at> tag. Possible values: 0, 1, 2, etc.
  • Mentions mention text – Display name shown in the mention. Should match text between <at> tags. For example John Doe.
  • Mentions mentioned user display name – User's full display name from Azure AD. For example John Doe.
  • Mentions mentioned user ID – Azure AD Object ID of the user (AAD user's unique identifier). For example 74a49af0-e4a2-43d6-9d83-52f5f0.
  • Mentions mentioned user identity Type – Specifies the identity type. Common values: member, aadUser, onPremiseAadUser, guest. Default value for regular team members is member.
Output
  • Message ID - The ID of the message to send reply to in teams. Automatically generated output variable.
  • Web URL - The Web URL of the message. Automatically generated output variable.
  • Message - Channel message. Automatically generated output variable.

Using User Mentions

To mention a user in your Teams channel message, you must configure both the message text and mentions properties.

Note: Mentioning tags is currently not supported, you can only mention users.
  1. Format the message text.
    Include the mention using HTML <at> tags with an id attribute:
    "Hello <at id=\"0\">John Doe</at>, please review this.""Hello <at id=\"0\">John Doe</at>, please review this."
  2. Configure mentions properties as in the following table.
    PropertyValueDescription
    Mentions ID0Numeric identifier (increment for multiple mentions)
    Mentions mention textJohn DoeDisplay name shown in the mention
    Mentions mentioned user display nameJohn DoeUser's full name from Azure AD
    Mentions mentioned user ID{AAD Object ID}User's Azure AD Object ID (see below)
    Mentions mentioned user identity TypememberIdentity type (member/aadUser/guest)

    To obtain the Azure AD Object ID:

    • Azure Portal - Navigate to Azure Active Directory > Users > {User}> Copy Object ID.
    • Microsoft Graph API - GET https://graph.microsoft.com/v1.0/users/{userPrincipalName}
    • PowerShell - Get-AzureADUser -ObjectId "user@domain.com" | Select ObjectId

Example configuration to mention the user "Jane Smith":

  • Message text: "Task completed <at id=\"0\">Jane Smith</at>"
  • Mentions ID: 0
  • Mentions mention text: "Jane Smith"
  • Mentions mentioned user display name: "Jane Smith"
  • Mentions mentioned user ID: "ef1c916a-3135-4417-ba27-8eb7bd084193"
  • Mentions mentioned user identity Type: "member"
Note:
  • Only one user can be mentioned per activity instance.
  • The id in the <at> tag must match the Mentions ID property.
  • Incorrect Azure AD Object ID will cause the mention to fail.
  • Ensure your bot/app has permissions to mention users in the channel.
  • Description
  • Project compatibility
  • Configuration
  • Using User Mentions

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo
Trust and Security
© 2005-2026 UiPath. All rights reserved.