From 5f3d1a3d1fe867663dc753e5131362f0455eed4a Mon Sep 17 00:00:00 2001
From: Preslav Mihaylov <preslav@pmihaylov.com>
Date: Wed, 21 Feb 2024 13:47:33 +0200
Subject: [PATCH] add slack manual ingestion docs (#29)

* add slack manual ingestion docs

* lintg

* editing
---
 mint.json                       |  6 +++++-
 slack/manual-ingestion-mode.mdx | 18 ++++++++++++++++++
 2 files changed, 23 insertions(+), 1 deletion(-)
 create mode 100644 slack/manual-ingestion-mode.mdx

diff --git a/mint.json b/mint.json
index 89152f7..dfe4f05 100644
--- a/mint.json
+++ b/mint.json
@@ -79,7 +79,11 @@
         "contact-forms",
         {
           "group": "Slack",
-          "pages": ["slack", "slack/how-slack-messages-create-threads"]
+          "pages": [
+            "slack",
+            "slack/how-slack-messages-create-threads",
+            "slack/manual-ingestion-mode"
+          ]
         }
       ]
     },
diff --git a/slack/manual-ingestion-mode.mdx b/slack/manual-ingestion-mode.mdx
new file mode 100644
index 0000000..147b69d
--- /dev/null
+++ b/slack/manual-ingestion-mode.mdx
@@ -0,0 +1,18 @@
+---
+title: 'Manual Ingestion Mode'
+---
+
+By default, Plain ingests and groups slack messages automatically for you.
+
+However, there are use-cases where certain channels are too noisy and you don't want all the messages to go into Plain.
+Or perhaps you want more granular control over which slack threads end up in Plain.
+
+For that purpose, you have the option to enable **Manual Ingestion Mode**. When enabled, Plain will only pick up the slack threads you specify by adding an emoji reaction.
+
+You can configure this by going into **`Settings`** > **`Slack`** and selecting `Manual` ingestion mode. You also have the option to specify which emoji reaction you want to use.
+
+Some considerations to have in mind:
+
+- A message will be added to Plain only if the reaction is by a Plain workspace user
+- You need to add the reaction on the channel message, rather than any of the messages in the slack thread
+- Removing the reaction will not delete the thread in Plain. Furthermore, adding it multiple times will not create multiple threads.