From 5580e14bf3f4d5d2a851d694d8b03c660c737cab Mon Sep 17 00:00:00 2001
From: Nick Funk <nick.funk@outlook.com>
Date: Tue, 3 Dec 2019 14:06:52 -0700
Subject: [PATCH] Create Slack integration documentation (#2714)

Explains how to create a Slack App and hook it into
Coral as well as how to re-find your webhook URLs
if you have lost them.

CORL-645
---
 docs/_config.yml               |  2 ++
 docs/source/version-5-slack.md | 28 ++++++++++++++++++++++++++++
 2 files changed, 30 insertions(+)
 create mode 100644 docs/source/version-5-slack.md

diff --git a/docs/_config.yml b/docs/_config.yml
index 11d703b54..527782bb3 100644
--- a/docs/_config.yml
+++ b/docs/_config.yml
@@ -98,6 +98,8 @@ sidebar:
               url: /v5/integrating/gdpr/
             - title: Comment Count
               url: /v5/integrating/counts/
+            - title: Slack
+              url: /v5/integrating/slack/
         - title: API
           children:
             - title: GraphQL Overview
diff --git a/docs/source/version-5-slack.md b/docs/source/version-5-slack.md
new file mode 100644
index 000000000..53819a556
--- /dev/null
+++ b/docs/source/version-5-slack.md
@@ -0,0 +1,28 @@
+---
+title: Slack
+permalink: /v5/integrating/slack/
+---
+
+Coral version 5 supports built-in Slack integration to help you forward comments from your moderation queues into appropriate Slack channels.
+
+## Creating a Slack App
+
+To enable web hooks that we will use to forward comments, you'll need to create an App and give it permissions over a channel.
+
+For details on how to create a Slack app with webhooks, please go to:
+
+https://slack.com/intl/en-ca/help/articles/115005265063-incoming-webhooks-for-slack
+
+After you have created a Slack app with a webhook, you can use it in your Coral configuration.
+
+1. Sign into the administration side of your Coral deployment.
+2. Select _Configure_ from the top navigation.
+3. Select _Slack_ from the side navigation for the configuration area.
+4. Here you can configure a Slack channel.
+5. Paste in the webhook URL you created for your Slack app and select which comment categories you want to receive notifications for.
+
+## I need to find the webhook URL again, where is it?
+
+Webhooks options are tied to a Slack app and can be found under your app settings at:
+
+https://api.slack.com/apps