Configuring LiveChat
This document provides detailed instructions for configuring LiveChat in channels-connector
Prerequisites
- Active LiveChat account
- Firewall configuration that allows Internet traffic as below:
- channels-connector pod configured to allow inbound traffic in Kubernetes ingress eg. https://channels-connector.app.chatbots.sentione.com/webhooks/livechat
- Inbound traffic - HTTPs webhooks sent from LiveChat servers: *.livechat.com, *.livechatinc.com (security is provided by checking webhook secret, there is no defined pool of IP addresses)
- Outbound traffic - HTTPs requests made by Automate to host https://api.livechatinc.com
Step 1: Create application
- Log in to LiveChat Developer Console.
- Go to
Apps
and clickCreate a new app
. - Create application with chosen App Name and product type LiveChat.
Step 2: Configure application
- From
Apps
section, choose newly created application. - Skip widget configuration.
- Choose
Configure Authorization
and select Server Side App.
- Save Client Id and Client secret for later use.
- Setup Redirect URI whitelist to point on admin application domain.
- Add following scopes in Scopes section:
- agents--my:rw
- agents-bot--my:rw
- chats--access:rw
- customers:ro
- agents--all:ro
- agent-bot-all:ro
- Go to
Building blocks
and add Chat Webhooks with fields:- Webhook URL - point on channels-connector application domain with endpoint webhooks/livechat,
- Secret key - save for later use as Webhook secret,
- Webhook triggers - filled as shown below.
Step 3: Install application
After configuring application, go to Private installation
and click Install app.
Step 4: Fill configuration file
chatbots.channels-connector.livechat: {
enabled: true
client-secret: "FROM STEP 2-4"
client-id: "FROM STEP 2-4"
webhooks-secret: "FROM STEP 2-7"
}
Step 5: Redeploy channels-connector with new configuration
Step 6: Authenticate LiveChat account
Following steps are also available in more details here
- Log in to Automate platform.
- Go to
Channels
and clickCreate -> LiveChat
. - You will be redirected to LiveChat's login page.
- Log in using yours credentials.
- Choose Agent name.
- New LiveChat channel will appear on channels list.
Updated about 1 month ago