Teams - Send Channel Message

In this article

Overview

You can use this Snap to send/reply to a message in the specified channel. 

Snap Type

Teams - Send Channel Message Snap is a Write-type Snap that sends a text message to a channel.

Prerequisites

None.

Support for Ultra Pipelines

Works in Ultra Pipelines.  

Limitations

  • Does not work with application-based accounts.

  • You can send up to a maximum of 3000 messages per app per day, to a given channel.

Known Issues

None.

Snap Views

Type

Format

Number of Views

Examples of Upstream and Downstream Snaps

Description

Type

Format

Number of Views

Examples of Upstream and Downstream Snaps

Description

Input 

Document

  • Min: 0

  • Max: 1

  • Mapper Snap

  • Copy Snap

A document containing the body of the message, team ID, or channel ID.

Output

Document

  • Min: 0

  • Max: 1

  • Mapper Snap

  • Copy Snap

  • JSON Formatter + File Writer

A document containing details of the message such as the message ID.

Error

Error handling is a generic way to handle errors without losing data or failing the Snap execution. You can handle the errors that the Snap might encounter while running the Pipeline by choosing one of the following options from the When errors occur list under the Views tab:

  • Stop Pipeline Execution: Stops the current pipeline execution if the Snap encounters an error.

  • Discard Error Data and Continue: Ignores the error, discards that record, and continues with the remaining records.

  • Route Error Data to Error View: Routes the error data to an error view without stopping the Snap execution.

Learn more about Error handling in Pipelines.

Snap Settings

  • Asterisk (*): Indicates a mandatory field.

  • Suggestion icon (): Indicates a list that is dynamically populated based on the configuration.

  • Expression icon (): Indicates whether the value is an expression (if enabled) or a static value (if disabled). Learn more about Using Expressions in SnapLogic.

  • Add icon (): Indicates that you can add fields in the field set.

  • Remove icon (): Indicates that you can remove fields from the field set.

Field Name

Field Type

Description

Field Name

Field Type

Description

Label*

 

Default ValueSend Channel Message
Example: Confirmation Sender

String

Specify a unique name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your pipeline.

Message*

 

Default Value: N/A
Example: <h1>Welcome to the channel</h1>

String/Expression

Specify the message to send to the specified channel. You can either use plain text or rich text using the markdown supported by Microsoft Teams. See the input for the Message field of Send Channel Message Snap in the Example Pipeline below, for more details.  

Team ID*

 

Default Value: N/A
Example: b22e8da4-17c1-45c0-baa9-47aed7344e92

String/Expression/Suggestion

Specify the ID of the team. Alternatively, click the  icon to fetch a list of team IDs associated with the account. 

Channel ID*

 

Default Value: N/A
Example: Chat, teams, channels and apps : 12:34ab567d89012b34b0fba40f987f2f3d@thread.tacv2

String/Expression/Suggestion

Specify the ID of the target channel. Alternatively, click the  icon to fetch a list of channel IDs associated with the specified team. 

Existing Message ID (if reply)

 

Default Value: N/A
Example: 1234556677

String/Expression

Specify the ID of the message for which to post a reply.

Number of Retries

 

Default Value0
Example3

String/Expression

Specify the number of attempts the Snap makes to perform the selected operation in case of connection failure/unsuccessful attempts. 

To avoid 502 Bad Gateway error

Use a higher value (such as 3, 4, or more) in this field to ensure the Snap/Pipeline runs successfully. 

Retry Interval (seconds)

 

Default Value1
Example6

String/Expression

Specify the time interval in seconds between