Teams integration mappings

Author: superojla

content/guides/integration-mappings/teams-mappings/create-mappings.md

@@ -0,0 +1,18 @@
+---
+rank: 3
+related_endpoints:
+ - post_integration_mappings_teams
+related_guides:
+ - integration-mappings/teams-mappings/list-mappings
+ - integration-mappings/teams-mappings/update-mapping
+ - integration-mappings/teams-mappings/delete-mapping
+required_guides:
+ - integration-mappings/teams-mappings/index
+related_resources: []
+alias_paths: []
+---
+# Create Teams integration mappings
+
+Use the `POST integration_mappings_teams` call to create a mapping.
+To make it work, you need `box_item` and `partner_item` parameters,
+which refer to a Box folder and a Teams channel, respectively.

content/guides/integration-mappings/teams-mappings/delete-mappings.md

@@ -0,0 +1,19 @@
+---
+rank: 5
+related_endpoints:
+ - delete_teams_integration_mappings_id
+related_guides:
+ - integration-mappings/teams-mappings/list-mappings
+ - integration-mappings/teams-mappings/create-mapping
+ - integration-mappings/teams-mappings/update-mapping
+required_guides: []
+related_resources: []
+alias_paths: []
+---
+# Delete Teams integration mappings
+
+The `DELETE integration_mappings_teams_id` call removes the mapping between
+the channel and the folder. 
+A new mapping and a new folder in the default folder structure will be created
+when the next file is uploaded to the channel.
+Deleting the mapping does not delete the Box folder, or the Teams channel.

content/guides/integration-mappings/teams-mappings/index.md

@@ -0,0 +1,53 @@
+---
+rank: 1
+related_endpoints:
+ - delete_teams_integration_mappings_id
+ - get_integration_mappings_teams
+ - post_integration_mappings_teams
+ - put_integration_mappings_teams_id
+related_guides:
+ - integration-mappings/teams-mappings/list-mappings
+ - integration-mappings/teams-mappings/create-mapping
+ - integration-mappings/teams-mappings/update-mapping
+ - integration-mappings/teams-mappings/delete-mapping
+required_guides: []
+related_resources: []
+alias_paths: []
+---
+# Teams integration mappings
+
+Before you can start working with [Teams][2] integration mapping API,
+perform the below steps.
+
+## Prerequisites
+
+* Admin or Co-Admin role
+* [Box for Microsoft Teams][1] integration installed
+
+## Create a Box application
+
+1. Create a [platform app with OAuth authentication][3] in the [Box developer console][4].
+2. Open the application and enable the **Manage enterprise properties** application scope under **Configuration** > **Required Access Scopes**.
+
+## Authorization
+
+To authorize your integration mappings requests:
+
+1. Navigate to the [platform app][5] that you have created as one of the prerequisites.
+2. Generate a [developer token][6] and add it to the HTTP header of each request:
+
+```bash
+Authorization: Bearer {developer_token}
+```
+
+<Message info>
+  The developer token is valid for 60 minutes. After that time you need
+  to generate it again.
+</Message>
+
+[1]: https://support.box.com/hc/en-us/articles/360050737154-Assigning-a-Default-Box-Folder-to-a-Teams-Channel-or-Chat
+[2]: https://support.box.com/hc/en-us/articles/360044667034-Introducing-Box-for-Microsoft-Teams
+[3]: g://authentication/oauth2/oauth2-setup
+[4]: https://app.box.com/developers/console
+[5]: g://applications/app-types/platform-apps
+[6]: g://authentication/tokens/developer-tokens

content/guides/integration-mappings/teams-mappings/list-mappings.md

@@ -0,0 +1,15 @@
+---
+rank: 2
+related_endpoints:
+ - get_integration_mappings_teams
+related_guides: []
+required_guides:
+ - integration-mappings/teams-mappings/index
+related_resources: []
+alias_paths: []
+---
+# List Teams integration mappings
+
+Use the `GET /integration_mappings/teams` call to fetch and filter the mappings,
+both the ones created manually by the admin those created automatically by the
+integration.

content/guides/integration-mappings/teams-mappings/update-mappings.md

@@ -0,0 +1,16 @@
+---
+rank: 4
+related_endpoints:
+ - put_integration_mappings_teams_id
+related_guides:
+ - integration-mappings/teams-mappings/list-mappings
+ - integration-mappings/teams-mappings/create-mapping
+ - integration-mappings/teams-mappings/delete-mapping
+required_guides: []
+related_resources: []
+alias_paths: []
+---
+# Update Teams integration mappings
+
+Use the `PUT integration_mappings_teams_id` call to update the
+existing mapping or the target Box folder.