In this article

Overview

Use this Snap to send/reply to a message in the specified 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 Input and Output

Snap Settings

Parameter Name	Data Type	Description	Default Value	Example
Label	String	Specify a 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.	Send Channel Message	Confirmation Sender
Message	String/Expression	Required. Enter 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.	N/A	<h1>Welcome to the channel</h1>
Team ID	String/Expression/Suggestion	Required. Enter the ID of the team. Alternatively, click the  icon to fetch a list of team IDs associated with the account.	N/A	b22e8da4-17c1-45c0-baa9-47aed7344e92
Channel ID	String/Expression/Suggestion	Required. Enter the ID of the target channel. Alternatively, click the  icon to fetch a list of channel IDs associated with the specified team.	N/A	Chat, teams, channels and apps : 12:34ab567d89012b34b0fba40f987f2f3d@thread.tacv2
Existing Message ID (if reply)	String/Expression	Enter the ID of the message for which to post a reply.	N/A	1234556677
Number of Retries	String/Expression	Enter 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.	0	3
Retry Interval (seconds)	String/Expression	Enter the time interval in seconds between retry 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.	1	6
Snap Execution	Drop-down list	Select one of the three following modes in which the Snap executes: Validate & Execute. Performs limited execution of the Snap and generates a data preview during Pipeline validation, then performs full execution of the Snap (unlimited records) during Pipeline runtime. Execute only. Performs full execution of the Snap during Pipeline execution without generating preview data. Disabled. Disables the Snap and all Snaps downstream from it.	Execute only	Validate & Execute

Troubleshooting

None.

Examples

Initiating activity in Microsoft Teams

The following example Pipeline demonstrates how you can use the Send Channel Message Snap and some other Snaps in the Teams Snap Pack to begin team's activity within your Microsoft Teams instance. This example assumes that you have:

• Set up your application in Azure Portal with necessary permissions.
• Configured the required Snap account with necessary scopes.
• Created a public or private channel using the Create Channel Snap.

This Pipeline uses the OAuth2 user account (authorization code grant type) to create a team on behalf of a signed-in user and to allow begin their collaboration efforts. It demonstrates the following activities:

• Creating a team
• Adding members to the new team
• Creating a public channel within the team
• Collaboration through the channel

Creating a team

Use the Create Team Snap from the Teams Snap Pack to create the new team, as needed. For this Pipeline demonstration, the inputs for creating a team are passed using a Mapper Snap.  

Mapper Snap
Output

The values for Team and Team_Desc are passed to the Create Team Snap. The Snap creates a new team in your Teams instance and returns the team's id and a confirmation message about the operation.

Create Team Snap	Output

Adding members to a team

To add members to the team, connect a Team Operations Snap. Select Add Members as the Operation and provide the user IDs of the members and owners for the team, as needed.

Team Operations Snap to add members to a team	Output

Creating a channel in the team

Now, let us create a channel within this new team (using Create Channel Snap) and add members to this channel, as necessary.

Create Channel Snap	Output

This Snap creates a new channel under the team and returns the channel details in its output.

Sending a message to a channel

Let us use these details to send our first message in the channel. To do so, we must connect a Send Channel Message Snap and pass the Team ID and Channel ID from the above output as inputs. The Send Channel Message Snap allows you to draft messages to the channel members using HTML markup. See the input for the Message field in the Snap.

Replying to a specific message

Similarly, you can use the Send Channel Message Snap to reply to a specific message in the channel (conversation) using its message ID. For demo purposes, we are using the id of the message sent above to reply to it.

Send Channel Message as a reply
Output

Download this Pipeline.

Downloads

Snap Pack History

See Also

• Teams Snap Pack
• Microsoft Teams API Documentation
• Getting Started with SnapLogic
• Snap Support for Ultra Pipelines
• SnapLogic Product Glossary