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 and https://accounts.livechat.com

Proxy Configuration (Optional)

If needed you may want to configure connection with LiveChat servers to go through HTTP proxy. To set that please add it to your automate config file:

chatbots.channels-connector {
  livechat {
    proxy {
      host: "1.2.3.4"
      port: 8080
      username: "user"
      password: "password"
    }
  }
}

Step 1: Create application

1. Log in to LiveChat Developer Console.
2. Go to Apps and click Create a new app.
3. Create application with chosen App Name and product type LiveChat.

Step 2: Configure application

1. From Apps section, choose newly created application.
2. Skip widget configuration.
3. Choose Configure Authorization and select Server Side App.
   
   
4. Save Client Id and Client secret for later use.

5. Setup Redirect URI whitelist to point on admin application URL (copy URL from browser).

📘

Make sure that Admin apps' config has property chatbots.admin.is-https: true

5. Add following scopes in Scopes section:

   1. agents--my:rw
   2. agents-bot--my:rw
   3. chats--access:rw
   4. agents--all:ro
   5. agent-bot-all:ro
   6. customers:rw
   
   

6. Go to Building blocks and click Add building block

7. Add Chat Webhooks with fields:

   1. Webhook URL - point on channels-connector application domain with endpoint webhooks/livechat,
   2. Secret key - save for later use as Webhook secret,
   3. Type - Bot
   4. Webhook triggers - filled as shown below.

8. (Optional) Add chat_deactivated webhook

When this webhook is added, LiveChat will notify Automate when the user closes the chat window or when the chat is archived due to user inactivity. If the conversation with the Bot isn't finished, Automate sends the special message HANGUP_HUMAN in the user's name. This fake message can then be handled in Flow, e.g. to call some integration.

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

1. Log in to Automate platform.
2. Go to Channels and click Create -> LiveChat.
3. You will be redirected to LiveChat's login page.
4. Log in using yours credentials.
5. Choose Agent name.
6. New LiveChat channel will appear on channels list.