add slack docs (#21)

* add slack docs

* prettier

* Update slack.mdx

Co-authored-by: Youmna Sirgi  <[email protected]>

* Update slack.mdx

Co-authored-by: Youmna Sirgi  <[email protected]>

* Update slack.mdx

Co-authored-by: Youmna Sirgi  <[email protected]>

* fix add-to-slack.mp4 link

---------

Co-authored-by: Youmna Sirgi <[email protected]>

mint.json

@@ -77,7 +77,10 @@
           "pages": ["email", "email/receiving", "email/sending", "email/alternate-emails"]
         },
         "contact-forms",
-        "slack"
+        {
+          "group": "Slack",
+          "pages": ["slack", "slack/how-slack-messages-create-threads"]
+        }
       ]
     },
     {

slack.mdx

@@ -1,33 +1,37 @@
 ---
 title: 'Slack'
+sidebarTitle: 'Overview'
 ---
 
-We're currently iterating and testing bi-directional Slack support with our design partners.
+**Never miss another message from a customer in Slack**
 
-If you are interested in helping your customers in Slack via Plain, please reach out to us at [[email protected]](mailto:[email protected]) so we can discuss and get you set up.
+Our Slack integration lets you sync messages from selected Slack channels to Plain and respond directly to customers from the platform.
 
-If you'd prefer, you can also [book a demo with us directly](https://cal.com/team/plain/demo).
+You will also be able to [add context to Slack messages with customer cards](/customer-cards), [set labels](/labels) and priorities, [create Linear tickets](/linear), and much more.
 
-### Connecting Slack with Plain
+Here’s how to get started:
 
-<Note>
-  Only workspaces which have been given early access will see the settings required to connect to
-  Slack.
-</Note>
+**1 Connect your workspaces**
 
-<Steps>
-  <Step title="Connect your workspaces">
-    - In Plain, navigate to `Settings` > `Slack`
-    - Press `Connect to Slack`
-    - Follow Slack's instructions making sure the correct Slack workspace is selected.
+- In Plain, navigate to **`Settings`** > **`Slack`**.
+- Press **`Connect to Slack`**.
+- Follow Slack’s instructions to make sure the correct Slack workspace is selected.
+- Authorize replies from your Slack profile to respond directly from Plain.
 
-  </Step>
-  <Step title="Add the Plain app to the channels you want to track">
-    Go to the channels you want to track in Plain and invite the Plain app. You can do this by
-    typing `/invite`, selecting `Add apps to this channel` and then choosing Plain.
-  </Step>
-  <Step title="Enjoy 💬">
-    That's it! Slack messages from the channels you added our Slack app too will begin appearing as
-    threads in Plain.
-  </Step>
-</Steps>
+**2 Add the Plain app to the channels you want to track**
+
+Once you’ve set up the integration in Plain, go to the Slack channels you want to track and invite the Plain app. You can do this by typing **`/invite`**, selecting **`Add apps to this channel`** and then choosing Plain.
+
+<video
+  controls
+  className="w-full aspect-video"
+  src="https://static-assets.plain.com/docs/slack/add-to-slack.mp4"
+></video>
+
+**3 Start responding 💬**
+
+Slack messages from the authorized channels will begin appearing as threads in Plain. To respond, press `R` and begin typing in Plain. Your responses will appear in Slack as if you are responding directly in the app.
+
+Emojis ( **`:`** to search for the right one), syntax highlighting, and attachments are all supported in Plain.
+
+**Note -** Slack messages sent by a Slack user that does **not** have an account in Plain (i.e. a customer) will create threads in Plain.

slack/how-slack-messages-create-threads.mdx

@@ -0,0 +1,17 @@
+---
+title: 'How Slack messages create threads in Plain'
+---
+
+Everyone sends messages in Slack differently. Here’s a high-level breakdown of how Slack messages create threads in Plain:
+
+1. **Multiple messages in main channel -** multiple messages sent subsequently in the main channel will be treated as one thread in Plain.
+   ![Slack Setup 1](/public/images/slack-setup-1.png)
+   ![Slack Setup 2](/public/images/slack-setup-2.png)
+
+2. **Messages in a Slack thread-** All messages on a Slack thread will be mapped to the thread in Plain created by the message in the main channel.
+   ![Slack Setup 3](/public/images/slack-setup-3.png)
+   ![Slack Setup 4](/public/images/slack-setup-4.png)
+
+3. **Multiple messages in the main channel, separated by a thread -** Once a Slack thread is created, the next message in the main channel will create a _new_ thread in Plain.
+   ![Slack Setup 5](/public/images/slack-setup-5.png)
+   ![Slack Setup 6](/public/images/slack-setup-6.png)