Skip to content

Commit 2fc5175

Browse files
Small docs updates to Slack, Incident.io and Slash Commands (#206)
* Documentation edits made through Mintlify web editor * Documentation edits made through Mintlify web editor * Documentation edits made through Mintlify web editor --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
1 parent 2722b33 commit 2fc5175

File tree

3 files changed

+28
-27
lines changed

3 files changed

+28
-27
lines changed

integrations/incident-io.mdx

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -4,12 +4,13 @@ title: "incident.io Integration"
44

55
The incident.io integration ensures seamless collaboration between your support and engineering teams during incidents. Directly from a Plain thread, you can create or link incidents, and easily follow up with customers once issues are resolved.​
66

7-
The incident.io integration is available on Grow \+ Scale tiers.
7+
The incident.io integration is available on Grow \+ Scale tiers.
88

99
### What you can do with the incident.io integration
1010

1111
- **Create new incident.io incidents** from any support request in Plain.
12-
- **Link existing incident.io incidents** to a thread to track status and coordinate updates.
12+
- **Link existing open incident.io incidents** to a thread to track status and coordinate updates.
13+
- **Link closed incidents **to make post-incident clean-up much smoother.
1314
- **Track resolution status**: when a linked incident is marked as resolved in incident.io, the thread in Plain automatically moves back to your TODO list – so you don't forget to close the loop.
1415
- **Assign key incident fields** like severity, team, and service – without ever leaving Plain.
1516

@@ -21,21 +22,22 @@ This integration is useful for:
2122
- **Connecting multiple customer conversations to a single incident**. When the incident is resolved, you'll have a clear list of all the customers to update – no digging required.
2223
- **Keeping your support team in the loop** on how incidents are progressing, without needing to switch tools.
2324

24-
### How to set it up
25+
### How to set it up
2526

2627
<Note>
27-
When you create the API key on incident.io, you need to make sure it has the following permissions:
28-
- `View data: like public incidents and organisation settings`
29-
- `Create incidents`
30-
- `Edit incidents`
28+
When you create the API key on incident.io, you need to make sure it has the following permissions:
29+
30+
- `View data: like public incidents and organisation settings`
31+
- `Create incidents`
32+
- `Edit incidents`
3133
</Note>
3234

3335
1. Go to **Settings****incident.io integration**
3436
2. Connect your incident.io account. As part of this process, you'll be asked to create an API key with the permissions described above.
35-
3. Once connected, you'll be able to start incidents from support requests, link threads to ongoing incidents, and fill in optional fields like severity, team, and service. Just hit "Thread links" and link an incident.io incident.
37+
3. Once connected, you'll be able to start incidents from support requests, link threads to ongoing incidents, and fill in optional fields like severity, team, and service. Just hit "Thread links" and link an incident.io incident.
3638

3739
Once an incident is resolved in incident.io, all associated threads in Plain will return to your "Todo" list so you can follow up.
3840

3941
### Questions?
4042

41-
Need help? Feel free to reach out to us or contact us via your support Slack channel.
43+
Need help? Feel free to reach out to us or contact us via your support Slack channel.

plain-ai/ai-slash-commands.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "AI Slash Commands"
33
description: "Description of your new file."
44
---
55

6-
With **AI Slash Commands** you now use AI directly within Plain to help you draft replies to customers faster. 
6+
With **AI Slash Commands** you now use AI directly within Plain to help you draft replies to customers faster. AI Slash Commands contain the context of the open support request.
77

88
### **How It Works**
99

slack.mdx

Lines changed: 16 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,43 +1,42 @@
11
---
2-
title: 'Slack'
3-
sidebarTitle: 'Overview'
2+
title: "Slack"
3+
sidebarTitle: "Overview"
44
---
55

6-
**The most powerful Slack integration for B2B support teams.**&#x20;
6+
**The most powerful Slack integration for B2B support teams.**
77

8-
Our Slack integration lets you sync messages from selected Slack channels to Plain and respond directly to customers from the platform. Get the full picture of your Slack support with robust [reporting](https://www.plain.com/docs/reporting), link customer requests from Slack to tickets in [Linear](https://www.plain.com/docs/integrations/linear) or [Jira](https://www.plain.com/docs/integrations/jira), and set [labels](https://www.plain.com/docs/labels), [tiers](https://www.plain.com/docs/tiers), and [SLAs](https://www.plain.com/docs/tiers#slas) – so you never miss a customer message again.&#x20;
8+
Our Slack integration lets you sync messages from selected Slack channels to Plain and respond directly to customers from the platform. Get the full picture of your Slack support with robust [reporting](https://www.plain.com/docs/reporting), link customer requests from Slack to tickets in [Linear](https://www.plain.com/docs/integrations/linear) or [Jira](https://www.plain.com/docs/integrations/jira), and set [labels](https://www.plain.com/docs/labels), [tiers](https://www.plain.com/docs/tiers), and [SLAs](https://www.plain.com/docs/tiers#slas) – so you never miss a customer message again.
99

10-
You can also use AI-powered [suggested responses](https://www.plain.com/docs/plain-ai/suggested-responses), to draft responses to customer requests based off your documentation or knowledge base.&#x20;
10+
You can also use AI-powered [suggested responses](https://www.plain.com/docs/plain-ai/suggested-responses), to draft responses to customer requests based off your documentation or knowledge base.
1111

1212
Here’s how to get started:
1313

1414
<Steps>
1515
<Step title="Connect your workspaces">
16-
* In Plain, navigate to **`Settings`** > **`Slack`**.
17-
18-
* Press **`Connect to Slack`**.
19-
20-
* Follow Slack’s instructions to make sure the correct Slack workspace is selected.
21-
22-
* Authorize replies from your Slack profile to respond directly from Plain.
16+
- In Plain, navigate to **`Settings`** \> **`Slack`**.
17+
- Press **`Connect to Slack`**.
18+
- Follow Slack’s instructions to make sure the correct Slack workspace is selected.
19+
- Authorize replies from your Slack profile to respond directly from Plain.
2320
</Step>
24-
2521
<Step title="Add the Plain app to the channels you want to track">
26-
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.
22+
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. You can alternatively auto-join or bulk-join channels with specific prefixes in your Slack settings (inside your workspace settings).
2723

28-
<Note>If you'd like to add Plain to many Slack channels in bulk, reach out via chat or on <a href="mailto:[email protected]">[email protected]</a> and we can help.</Note>
24+
<Note>
25+
If you'd like to add Plain to many Slack channels in bulk, reach out via chat or on <a href="mailto:[email protected]">
26+
2927

28+
and we can help.
29+
</Note>
3030
<video controls className="w-full aspect-video" src="https://static-assets.plain.com/docs/slack/add-to-slack.mp4" />
3131

3232
<Warning>
33-
When Plain is added to a channel, we automatically classify it as a Customer channel if it's a *Slack Connect* channel or one for [internal discussions](/thread-discussions) otherwise.
33+
When Plain is added to a channel, we automatically classify it as a Customer channel if it's a _Slack Connect_ channel or one for [internal discussions](/thread-discussions) otherwise.
3434

3535
For customer channels, we treat messages from non-Plain users as support requests, which are ingested as threads into Plain.
3636

3737
In discussion channels, on the other hand, we only ingest messages related to an on-going discussion.
3838
</Warning>
3939
</Step>
40-
4140
<Step title="Try it out">
4241
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.
4342

0 commit comments

Comments
 (0)