scottk/chatwoot
1
0
Fork 0
mirror of https://github.com/lingble/chatwoot.git synced 2025-11-02 03:57:52 +00:00
Code Issues Packages Projects Releases Wiki Activity

Feature: Slack - receive messages, create threads, send replies (#974)

Browse Source 
Co-authored-by: Pranav Raj S <pranav@thoughtwoot.com>
This commit is contained in:
Sojan Jose
2020-06-22 13:19:26 +05:30
committed by GitHub
parent aa8a85b8bd
commit 1ef8d03e18
53 changed files with 815 additions and 188 deletions
Download Patch File Download Diff File Expand all files Collapse all files

39
docs/development/project-setup/slack-integration-setup.md Normal file
View File

@@ -0,0 +1,39 @@
---
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.