> 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/slack.md).

# Slack

Step by Step instructions to configure Slack as Collaboration Tool with cfxOIA

The following section explains how to integrate Slack as collaboration tool with cfxOIA using Webhook.

### Create Webhook for Slack Messages in cfxOIA

**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 hamburger menu and click on 'Configure Project'.

**Step 4**: Click on Messages tab from Project Configuration Tab.

![](https://4260296531-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MAygHzNCQ33zRR43qxF%2F-MCgZvVqwAoNvOxpC4pb%2F-MCg_-O7mXFuwgf2RVr0%2Fimage.png?alt=media\&token=276be429-0f37-4479-bf76-317ad042a538)

**Step 5**: Click '+' to add Slack as Message Endpoint to the selected project.

**Step 6**: Select 'Source' as Endpoint Role. Enter Name and Description.

**Step 7**: Select 'Default Slack collaboration messages from cfxOIA Incident Room' as Event Type.

![](https://4260296531-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MAygHzNCQ33zRR43qxF%2F-MCgZvVqwAoNvOxpC4pb%2F-MCgaRjJo8SQWohYJ_vJ%2Fimage.png?alt=media\&token=4c30a52a-5827-46e5-8c0b-3603a3520677)

**Step 8**: Select 'Webhook With Basic Authentication' as Endpoint Type

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

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

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

**Step 12**:  Click on 'Save' to create Webhook based messaging for Slack tool

**Step 13**: On the context menu of newly created message end point, click on 'Enable' to activate it.

**Step 14**: On the context menu of newly created message end point, click on 'Webhook URL' to view and copy the URL. A sample webhook url is as shown below.

![](https://4260296531-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MAygHzNCQ33zRR43qxF%2F-MCgjS0raMrW73B4oG66%2F-MCgl_M1r9AvVFSybly7%2Fimage.png?alt=media\&token=093d8f34-9218-4e8d-aeed-e4884d6d9743)

### Configure Slack for Messages over a Webhook

**Step 1**: Login to <https://api.slack.com/apps>

**Step 2**: Click on 'Create New App' or use an existing App.

![](https://lh6.googleusercontent.com/cyYpnlRQBc2E3Td1zaP8ZXwiV_4C9ONEkxDe1XDOSeNA1ts6sndkOb4rynX5PEL3ijLN_A2Y9EKS3t6ZBoZ_zazonDzWvNo4F8K_JMio785Zh-_-EOkCHO6ISrqagR1BSuACayuN)

**Step 3**: Click on 'Slash Commands' to create new outgoing webhook. Always choose the right channel in Slack for which the messages needs flow as shown below.

![](https://4260296531-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MAygHzNCQ33zRR43qxF%2F-MCgaolvkX785frJWXhP%2F-MCgeyke70lxbhHWgoYi%2Fimage.png?alt=media\&token=9c47a2f6-b00d-40dd-8cd8-8bd86a113e34)

**Step 4**: Configure the Webhook. The details as given below.

![](https://4260296531-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MAygHzNCQ33zRR43qxF%2F-MCgg7tGERPUpFrOC9D7%2F-MCgjHo15QGoc34UNJnj%2Fimage.png?alt=media\&token=aedc6d69-a6f4-41ff-ad63-f19fe02b89da)

###