dfcf728e6f
by @akellbl4 * create infrastructure for site * wip * fix docker build and add readme * add docker-compose as a build and a run method * rename compose file yaml -> yml * add `src` as volume for watching changes * update configs * update README * add padding at the end of the pages * move demo settings in config * fetch latest release from github * update docs navigation - add sections - redirect from root of the section to first doc - nice styles for navigation - add brand colors * cache github data from first load * add redirects and fix link to docs * fix docs nav styles * add installation page placeholder * fix demo * add 404 * add dark theme, add theme switcher, remove unused files * fix dark theme on main page * fix dark theme background * fix node version * change installation docs * add note block * minor fixes * add code highlighting styles * fixes * fixes * mobile navigation, fix code highlighting colors * fix dev server * fix fetching error * fix path to edit Co-authored-by: Pavel Mineev <pavel@mineev.me> Co-authored-by: Dmitry Verkhoturov <paskal.07@gmail.com>
41 lines
1.7 KiB
Markdown
41 lines
1.7 KiB
Markdown
---
|
|
title: Slack
|
|
---
|
|
|
|
## Slack notifications
|
|
|
|
In order to integrate notifications from remark42 with the [slack](https://slack.com), you should create [a bot](https://slack.com/intl/en-cn/help/articles/115005265703-Create-a-bot-for-your-workspace) and obtain a token.
|
|
|
|
### Create a Slack Bot
|
|
|
|
1. Create a [Slack app](https://api.slack.com/apps/new) if you don't already have one, or select an existing app you've created.
|
|
2. Click the OAuth & Permissions tab in the left sidebar.
|
|
3. Below Bot Token Scopes, select the `chat:write`, `chat:write.public` and `channels:read` scopes. Then click Add an OAuth Scope.
|
|
4. Scroll to the top of the page, and click on Install to workspace.
|
|
5. You should see the "_View basic information about public channels in your workspace_", "_Send Message as ..._" and "_Send messages to channels ... isn't a member of_" as the permission, then click allow.
|
|
6. You can then see you token, in the form of `xoxb-...-...-...`
|
|
|
|
|
|
### Remark42 configuration
|
|
|
|
The slack token which you obtained before should be used as `NOTIFY_SLACK_TOKEN`.
|
|
|
|
You also need to set `NOTIFY_ADMINS=slack` for the slack notification to be active.
|
|
|
|
By default, the notification are sent to the `general` channel on slack. If you need another channel, you can specify it, for instance with `NOTIFY_SLACK_CHAN=random`.
|
|
|
|
```
|
|
- NOTIFY_ADMINS=slack
|
|
- NOTIFY_SLACK_CHAN=general
|
|
- NOTIFY_SLACK_TOKEN=xoxb-....
|
|
```
|
|
|
|
|
|
### Verify the notifications on Slack
|
|
|
|
If all goes fine, you should be able to see the following message on your slack notification channel:
|
|
|
|
> New comment from _author_ -> _original author_
|
|
>> [Demo | Remark42](http://127.0.0.1:8080/web/#remark42__comment-11288987987)
|
|
>> This is the comment written by _author_
|