In this article
...
| Parameter Name | Data Type | Description | Default Value | Example | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Label | String |
| Create Team | Create Marketing Team | ||||||||
| From Existing Group | Check box | Select to create a team from an existing group. Deactivates the Team Name, Team Description, Private Team, and Add Team Owners fields. Activates the Group ID field. | Not selected | Selected | ||||||||
| Group ID | String/Expression/Suggestion | Activates when you select the From Existing Group check box. Enter the ID of the group from which to copy the team. Alternatively, click the | N/A | All Company : 12a345c6-78c9-0b1c-b2f3-ab45e678d980 | ||||||||
| Team Name | String/Expression | Activates when you deselect the From Existing Group check box. Enter the name for the new team. | N/A | Marketing Team | ||||||||
| Team Description | String/Expression | Activates when you deselect the From Existing Group check box. Enter a brief description about the new team. | N/A | Marketing team for the ABC Project | ||||||||
| Private Team | Check box | Activates when you deselect the From Existing Group check box. Select this check box to create a private team.
| Not selected | Selected | ||||||||
| Add Team Owners | Activates when you deselect the From Existing Group check box. Use this field set to add owners for the team. This field set consists of the Owner ID field. | |||||||||||
| Owner ID | String/Expression/Suggestion | Enter the ID of the member. Alternatively, click the | N/A | e12b3456-7c89-012b-345f-67c89dca0bcd | ||||||||
| 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. | 0 | 3 | ||||||||
| Retry Interval (seconds) | String/Expression | Enter the time interval in seconds between retry attempts. | 1 | 6 | ||||||||
| Snap Execution | Drop-down list | Specifies the execution type:
| Execute only | Validate & Execute | ||||||||
...
| Error | Reason | Resolution |
|---|---|---|
| Team Name field is blank | You have not specified a team name. | Verify whether you have specified a team name in the Team Name field. The Team Name field is required when creating a new team. |
Examples
Initiating activity in Microsoft Teams
The following example Pipeline demonstrates how you can use the Create Team 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. In this Pipeline, the inputs for creating a team are passed using a Mapper Snap, for demonstration purposes.
| 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 |
|---|---|
|  |
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 |
|---|---|
|  |
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. 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 Message field in the Snap and content key in the output.
| Send Channel Message Snap | |
|---|---|
| |
| Output | |
|
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, the Snap below uses the id of the message sent above to reply to it.
| Send Channel Message as a reply |
|---|
|
| Output |
 |
Downloads
| Note | ||
|---|---|---|
| ||
|
...