diff --git a/docs/nodes/nodes-library/nodes/MicrosoftTeams/MicrosoftTeams1_node.png b/docs/nodes/nodes-library/nodes/MicrosoftTeams/MicrosoftTeams1_node.png new file mode 100644 index 000000000..9b05a5006 Binary files /dev/null and b/docs/nodes/nodes-library/nodes/MicrosoftTeams/MicrosoftTeams1_node.png differ diff --git a/docs/nodes/nodes-library/nodes/MicrosoftTeams/MicrosoftTeams2_node.png b/docs/nodes/nodes-library/nodes/MicrosoftTeams/MicrosoftTeams2_node.png new file mode 100644 index 000000000..6e3822ea0 Binary files /dev/null and b/docs/nodes/nodes-library/nodes/MicrosoftTeams/MicrosoftTeams2_node.png differ diff --git a/docs/nodes/nodes-library/nodes/MicrosoftTeams/MicrosoftTeams_node.png b/docs/nodes/nodes-library/nodes/MicrosoftTeams/MicrosoftTeams_node.png new file mode 100644 index 000000000..e0837214d Binary files /dev/null and b/docs/nodes/nodes-library/nodes/MicrosoftTeams/MicrosoftTeams_node.png differ diff --git a/docs/nodes/nodes-library/nodes/MicrosoftTeams/README.md b/docs/nodes/nodes-library/nodes/MicrosoftTeams/README.md new file mode 100644 index 000000000..3dbf9182e --- /dev/null +++ b/docs/nodes/nodes-library/nodes/MicrosoftTeams/README.md @@ -0,0 +1,78 @@ +--- +permalink: /nodes/n8n-nodes-base.microsoftTeams +--- + +# Microsoft Teams + +[Microsoft Teams](https://teams.microsoft.com/) is a business-oriented communication and collaboration platform that combines workplace chat, video meetings, file storage , and application integration. + +::: tip 🔑 Credentials +You can find authentication information for this node [here](../../../credentials/Microsoft/README.md). +::: + +## Basic Operations + +- Channel + - Create a channel + - Delete a channel + - Get a channel + - Get all channels + - Update a channel +- Channel Message (Beta) + - Create a message + - Get all messages + +## Example Usage + +This workflow allows you to create, update and send a message to a channel in Microsoft Teams. You can also find the [workflow](https://n8n.io/workflows/680) on n8n.io. This example usage workflow would use the following nodes. +- [Start](../../core-nodes/Start/README.md) +- [Microsoft Teams]() + +The final workflow should look like the following image. + +![A workflow with the Microsoft Teams node](./workflow.png) + +### 1. Start node + +The start node exists by default when you create a new workflow. + +### 2. Microsoft Teams node (create: channel) + +1. First of all, you'll have to enter credentials for the Microsoft Teams node. You can find out how to do that [here](../../../credentials/Microsoft/README.md). +2. Select the team you want to use from the ***Team ID*** dropdown list. +3. Enter a name for the channel in the ***Name*** field. +4. Click on ***Execute Node*** to run the node. + +![Create a channel with the Microsoft Teams node](./MicrosoftTeams_node.png) + +::: v-pre +### 3. Microsoft Teams1 node (update: channel) + +1. Select the credentials that you entered in the previous node. +2. Select 'Update' from the ***Operation*** dropdown list. +3. Click on the gears icon next to the ***Team ID*** field and click on ***Add Expression***. +4. Select the following in the ***Variable Selector*** section: Nodes > Microsoft Teams > Parameters > teamId. You can also add the following expression: `{{$node["Microsoft Teams"].parameter["teamId"]}}` +5. Click on the gears icon next to the ***Channel ID*** field and click on ***Add Expression***. +6. Select the following in the ***Variable Selector*** section: Nodes > Microsoft Teams > Output > JSON > id. You can also add the following expression: `{{$node["Microsoft Teams"].json["id"]}}` +7. Click on the ***Add Field*** button and select 'Name' from the dropdown list. +8. Enter a channel name in the ***Name*** field. +9. Click on ***Execute Node*** to run the node. + +![Update a Channel with the Microsoft Teams node](./MicrosoftTeams1_node.png) +::: + +::: v-pre +### 4. Microsoft Teams2 node (create: channelMessage) + +1. Select the credentials that you entered in the previous node. +2. Select 'Channel Message (Beta)' from the ***Resource*** dropdown list. +3. Click on the gears icon next to the ***Team ID*** field and click on ***Add Expression***. +4. Select the following in the ***Variable Selector*** section: Nodes > Microsoft Teams > Parameters > teamId. You can also add the following expression: `{{$node["Microsoft Teams"].parameter["teamId"]}}` +5. Click on the gears icon next to the ***Channel ID*** field and click on ***Add Expression***. +6. Select the following in the ***Variable Selector*** section: Nodes > Microsoft Teams > Output > JSON > id. You can also add the following expression: `{{$node["Microsoft Teams"].json["id"]}}` +7. Select 'Text' from the ***Message Type*** dropdown list. +8. Enter a message in the ***Message*** field. +9. Click on ***Execute Node*** to run the node. + +![Send a message with the Microsoft Teams node](./MicrosoftTeams2_node.png) +::: diff --git a/docs/nodes/nodes-library/nodes/MicrosoftTeams/workflow.png b/docs/nodes/nodes-library/nodes/MicrosoftTeams/workflow.png new file mode 100644 index 000000000..a5a9727d3 Binary files /dev/null and b/docs/nodes/nodes-library/nodes/MicrosoftTeams/workflow.png differ