40 lines
2.0 KiB
Markdown
40 lines
2.0 KiB
Markdown
---
|
|
path: "/docs/slack-integration-setup"
|
|
title: "Setting Up Slack Intergration"
|
|
---
|
|
|
|
### Register A Facebook App
|
|
|
|
To use Slack Integration, you have to create an Slack app in developer portal. You can find more details about creating Slack apps [here](https://api.slack.com/)
|
|
|
|
Once you register your Slack App, you will have to obtain the `Client Id` and `Client Secret` . These values will be available in the app settings and will be required while setting up Chatwoot environment variables.
|
|
|
|
### Configure the Slack App
|
|
|
|
1) Create a slack app and add it to your development workspace.
|
|
2) Obtain the `Client Id` and `Client Secret` for the app and configure it in your Chatwoot environment variables.
|
|
3) Head over to the `oauth & permissions` section under `features` tab.
|
|
4) In the redirect urls, Add your Chatwoot installation base url.
|
|
5) In the scopes section configure the given scopes for bot token scopes.
|
|
`commands,chat:write,channels:manage,channels:join,groups:write,im:write,mpim:write,users:read,users:read.email,chat:write.customize`
|
|
6) Head over to the `events subscriptions` section under `features` tab.
|
|
7) Enable events and configure the the given request url `{chatwoot installation url}/api/v1/integrations/webhooks`
|
|
8) Subscribe to the following bot events `message.channels` , `message.groups`, `message.im`, `message.mpim`
|
|
9) Connect slack integration on Chatwoot app and get productive.
|
|
|
|
### Configuring the Environment Variables in Chatwoot
|
|
|
|
Configure the following Chatwoot environment variables with the values you have obtained during the slack app setup.
|
|
|
|
```bash
|
|
SLACK_CLIENT_ID=
|
|
SLACK_CLIENT_SECRET=
|
|
```
|
|
|
|
### Test your Setup
|
|
|
|
1. Ensure that you are recieving the Chatwoot messages in `customer-conversations` channel
|
|
2. Add a message to that thread and ensure its coming back on to Chatwoot
|
|
3. Add `note:` or `private:` in front on the slack message see if its coming out as private notes
|
|
4. If your slack member email matches their email on Chatwoot, the messages will be associated with their Chatwoot user account.
|