Adding the Cisco Jabber Channel¶

Cisco Jabber is a platform that offers multiple communication methods, and which you can integrate with the assistants built with the Kore.ai XO Platform. Adding the Jabber channel to your Kore.ai VA allows end-users to interact with it using their Jabber accounts. This article shows you how to add it as a Channel, where your VA can communicate to end-users via Jabber. You must have or register for a developer account in the Jabber portal.

Configuration¶

To add the Cisco Jabber channel, follow the below steps:

Select the assistant that you want to add the Jabber channel to.
Go to Channels & Flows > Channels > Digital > All.
Click the Jabber icon. The Jabber Channel page is displayed.
To enable a webhook integration on your Jabber application, log into your Jabber app. Copy the Webhook URL from the Configurations tab on the Jabber channel page and enter the Webhook URL field in the Jabber app for integration.
Go to the Configurations tab on the Jabber channel page to complete the channel setup.
Capture the POST URL details from your Jabber app and enter them in the POST URL field.
You can also optionally generate and capture the Access Token details from your Jabber integration and enter in the Access Token field to enable secure communication between Jabber and the VA.
Select Yes and click Save to enable Jabber Channel.

After enabling the channel and verifying all the configurations, you can optionally publish the assistant for the new channel. Learn more about Publishing your Virtual Assistant.

To learn more about working with Channels within the Kore.ai XO Platform, please see Channel Enablement.

Following are code snippets of the payload formats for verifying the integration.

Payload for Post URL¶

Below is the response message from the bot that must be accepted by the POST URL that is registered in the Configurations tab.

  {
                "message": {
                "text" : "Hi"
                }
                "to" : "<recipient-id/group-id>",
                "from" : "<sender-id>"
             }

Webhook Payload¶

Below is the Webhook payload format to post messages to the XO Platform from Jabber.

{
  {
    "message": {
        "text" : "<Message>",
        "attachments" : [<array of attachment links (optional)>]
    },
    "from" : {
        "id": "<unique-id-of-sender(mandatory)>",
        "userInfo" : {
          "firstName" : "<first-name(optional)>",
          "lastName" : "<second-name(optional)>",
          "email" : "<email(optional)>"
        }
    },
    "to" : {
        "id": <unique-id-of-recipient(mandatory)>,
        "groupInfo" : { //If message comes from a group/team/room conversations.
            "id" : "<unique-id-of-group>",
            "name": "<group-name(optional)>"
        }
    }
}