Slack Deployment via Public App
This part of the documentation will walk you through all the procedures to connect a Slack Channel. Once you have completed this deployment, you can set up your Slack for live chat purpose.
Here is a checklist for your reference, so that you won't miss essential items to complete the deployment:
No. | Checklist Item |
---|---|
1 | Connecting Slack Channel via Public App |
2 | Add WOZTELL App to Slack |
3 | Set Up the Broadcast Group in Slack Channel |
4 | Add Pairing Channels in Settings |
Please refer to another session for setting up Slack Channel via Custom App.
Connecting Slack Channel via Public App
This section will help you subscribe and connect a Public App on WOZTELL for Slack. This app is necessary for setting up chatbot on Slack, including live chat settings.
Before proceeding to basic settings, please make sure you have a Slack workspace ready.
Basic Settings
- Go to WOZTELL, select "Channels" at the top menu bar
- Click "+New Channel" and name your new channel.
- Head to Platform. Select βSlackβ icon and click Connect.
- A pop-up window will ask for permission of WOZTELL to access your workspace, i.e. Shiny Jewelry. If you have multiple workspaces, you should be able to select one of them on the top right dropdown menu. Click Allow.
- After that, you will be able to see the below result and click Back to WOZTELL.
- Now, once you have the bot ID and other information displayed on your WOZTELL Channel for Slack, it means that the WOZTELL Public App is installed into your Slack workspace.
- After creating a workspace on Slack and connecting it to WOZTELL Public App, you can start Slack and set up the channel.
Connecting WOZTELL App to the Slack Workspace
- In your Slack workspace, create a new Slack channel by clicking the β+β sign near βChannelsβ. Then, click βCreate a channelβ. The channel is for you to receive live chat tickets or to structure your workspace into different channels by different departments/teams.
- Fill in the information for the new channel, toggle on βMake privateβ if you want to create a private ticketing group. Then click βCreateβ. For your reference, you can find your "Slack Channel ID" from the URL on the web browser. The URL should look like this.
https://app.slack.com/client/<Team ID>/<Slack Channel ID>
- Add your corresponding teammates who will be handling live chat enquiries to your newly created channel.
- In order to add the WOZTELL Public App to Channel, select βiβ and then βMore". Then, select βAdd appsβ.
- Find the WOZTELL Public App you have previously installed to your workspace, i.e. you should be able to find WOZTELL or your custom app name and select "Add" to add into the ticketing channel.
- Select the menu of the channel again, you can see βView 1 app in slack channel nameβ, click to review if the WOZTELL Public App is added to the Slack channel.
- You should be able to see the WOZTELL Public App you have added to Slack channel now. This channel is ready for live chat ticketing!
Pairing Channels
Please follow our guide to pair up your inlet and outlet channel.
Broadcast Group
Broadcast Group is where you can mark and label which channel to send out the live chat tickets out.
Please make sure you have completed Level one of the standard procedure of Slack Live Chat Tree setup before proceeding to this step.
Head to your WOZTELL Channel for Slack and select "Broadcast Group".
Find the Slack channel which you would like the live chat tickets to be sent out to and select it. It should be the channel you have created back in step 2.
You may toggle default or customize a label (the label can be setup in the sample codes for level one standard procedure
Click "Save" when you are done.
Live Chat Settings
Live Chat Settings is where you can set up your idle timer in live chat. For some messaging platforms like WhatsApp, there is a limitation of 24-hours conversation window. You may need this idle timer to send an automated message out to end the live chat when the time is up.
Please make sure you have completed Level two of the standard procedure of Slack Live Chat Tree setup before proceeding to this step.
Head to your WOZTELL Channel for Slack and select "Live Chat Settings".
Set your idle timer. The minimum interval you can select is 15 minutes.
Select the tree and node to execute when the time is up.
Click "Save".
You may also set up your Live Chat Settings following this guide: Automatic End Live Chat Function]
Adding Trees & Global Nodes
This section will cover the steps on how to add the ticketing commands (i.e. done or transfer live chat) to the WOZTELL channnel for Slack.
Please make sure you have completed Level two of the standard procedure of Slack Live Chat Tree setup before proceeding to this step.
Sample Tree Structure
Getting Hands-on
Select the "Tree" section in your WOZTELL Channel for Slack.
Add all the global nodes of each command under "Default".
If your commands are scattered in different trees, you may add multiple trees.
Click "Save" when you are done.