> For the complete documentation index, see [llms.txt](https://oiadocs.cloudfabrix.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://oiadocs.cloudfabrix.io/integrations-guide/integrations/ms-teams.md).

# Microsoft Teams

This section explains how to configure Microsoft Teams as collaboration channel in the CloudFabrix's AIOps platform. The integration is done using Webhook.

### Create Webhook for integration with MS Teams:

**Step 1:** Login to cfxDimensions through web-browser UI (as Project Admin user)

**Step 2:** Click on ‘OIA (Ops Intelligence & Analytics)’ app

**Step 3:** Click on an existing Project for which MS teams needs to added as collaboration channel and click on 'Configure Project'.

**Step 4**: Click on 'Messages' (left page menu) and click on '+' to add new collaboration message source.

**Step 5**: Select Endpoint Role as 'Source' and enter Name and Description.

**Step 6**: Select 'Default Microsoft Teams collaboration messages from cfxOIA Incident Room' as Event Type.

**Step 7**: Select 'Webhook with Basic Authentication' as Endpoint Type.

**Step 8**: For 'Hostname or IP address', enter FQDN DNS Name or IP Address of cfxDimension platform. This is used within the Webhook URL.

**Step 9**: Protocol, Port, URI and Security Token are optional and not required.

**Step 10**:  Enter 'Username' and 'Password' to enable HTTP Basic authentication for Webhook. Leave empty to disable HTTP Basic authentication.

**Step 11**:  Click on 'Save' to create Webhook based alert endpoint for Microsoft Teams.

**Step 12**: On context menu of freshly created Microsoft Teams end point, select 'Enable' to activate it.

**Step 13**: On context menu of endpoint for Microsoft Teams, click on 'Webhook URL' to view and copy the URL.

### Configure Microsoft Teams for Messages over a Webhook

**Step 1**: Login to teams.microsoft.com

**Step 2** : Select the team that you want to integrate with cfxOIA. `Team -> Dot Menu -> Manage Team`

![Manage Team](https://lh5.googleusercontent.com/pywIyGdAZQ1n6KacyBPKu244TaCpfCm2yjSDmgu_M8-gcCzJn0yYltxfUf14IC6LBLikoPGSS3Qjn7RA_0BHYRlQDjLvCXOz3azhMeRsPXZRR2d8XlaVPK0SmdpS2sNMm25p8XOL)

**Step 3**: Click on 'Create outgoing webhook.  `Manage Teams -> Apps -> Create Outgoing Webhook`

![](https://lh6.googleusercontent.com/M94FaQVVfO4XBxeNaJYc6c8_DLhfQw5bGLd6ML12_SUp2NSYk71OpC6VyULYykm14jFEZ5w4IdvFvTDqKf89huJlXL1UJy8cl6YNtVs4Q_GZqjTWt4ZLQUIH_xP-yc_hgETZOApY)

![](https://lh5.googleusercontent.com/bXYfDhIBUfAXGA6R6ZSiO9p2BKR0j5v_QDjIOY1-BGkYYldc8Wl2aPGg27fd_CW-FpfvI9NjzxGHx-3rL6clzrQvTcProw5CpCx1u2etyx-6RQH7f8WTEHRUsAbFrgTZByZeDZiJ)

**Step 4**: Click 'Save' and you will get a security key. Save this for records.

**Step 5**: With the information we have, we can push messages from MSTeams to your webhook.

**Step 6**: @\<webhook-name> in any public conversation on the configured teams channel should trigger the integration.

{% hint style="info" %}
Please note the above applies only to Public conversations and not to Private conversions.
{% endhint %}