Adding Chatbot

CINNOX provides integration to your chatbot as your destination that supports your customer service and sales results. Add and deploy an intelligent virtual assistant in your CINNOX service, bringing a new level of automation, quick, proactive and 24/7 available.

Currently, CINNOX supports the integration of the following Chatbot Platforms:

• Microsoft QnA Maker
• Google Dialogflow

As to which chatbot among the two to add to your CINNOX service, that would depend on how you would like to leverage chatbot use in the day-to-day business operation.

Here are some links that would provide information about each chatbot and its services.

• What is QnA Maker and when to use it?
• What is Google Dialogflow and its key features?

🚧

The chatbot will only respond to your visitor enquiries through chat.
Chatbot responses are according to the set Knowledge Base - questions and answers or the Bot Builder for the intents or tree node you have created in your Chatbot platform.

 

Adding Chatbot as a Destination

To add your chatbot:

• From the navigation menu, go to Destinations and click the Chatbot tab.
• On the Chatbot interface, click on the Add Chatbot button on the page's top-right corner.

Basic Information

• Chatbot Name - the name of your chatbot that will appear in the chatbot list and to your visitor.
• Avatar - upload the avatar of your chatbot that will appear to your visitor.
• Chatbot Description - the description of your chatbot that will appear in your chatbot list.

Support Language - the language set to handle support by your service team.
Support Location - the country/region set to handle support by your service team.

 

Chatbot Source
Select the Chatbot Platform and fill in the required fields.
Please ensure all information is correct as displayed in your chatbot account.

 

Microsoft QnA Maker

1. Log in to your Microsoft QnA Maker account.
2. Navigate to "My knowledge bases".
3. Click the View Code button of the Knowledge base name you would like to connect with your CINNOX service. A pop-up window will show for the Postman API.
4. Click Copy for the Postman API.

5. Paste the Postman API details on the Postman API field on the CINNOX side.

📘

CINNOX supports Plain Text message type to respond to customer messages.

 

Google Dialogflow

1. Log in to your Google Dialogflow Console account.
2. Create a service account key:

• In the Cloud Console, click the email address for your created service account.
• Click Keys.
• Click Add key, then click Create new key.

• Click Create. A JSON key file is downloaded to your computer.
• Click Close.

For more details, please check the Dialogflow Documentation.

🚧

Please check the permission of the newly created service account on the IAM setting page, and ensure it is granted.

 

3. Copy and paste the generated service account key in JSON format on the Service Account Key field on the CINNOX side.

📘

CINNOX supports Intents to respond to customer messages.

 

Transfer Enquiry - Chatbot to Live Agent

Allow your staff to jump in and take over the conversation when your visitor finds an agent. You can transfer the ongoing enquiry handled by the chatbot to a service group associated with a tag or staff member.

• Toggle ON to enable the transfer of chatbot conversation to your staff
• Select between Tag and Staff in the dropdown list to whom visitor and chatbot conversation should continue.
• Click Create when done setting up your chatbot.

📘

The visitor will initiate the transfer of enquiry from the chatbot to the live agent.

📘

Select a tag to transfer an enquiry that does not consist of a chatbot destination to avoid the loop of enquiry transfer from a chatbot to a chatbot.

 

Set up a chat transfer trigger in your Chatbot Portal

After enabling the Transfer Chatbot to Live Agent in your CINNOX Dashboard, you will need to set the chat transfer to your agent trigger in your chatbot portal.

Microsoft QnA Maker

Set this keyword DIRECT_TRANSFER as the answer to trigger the Chatbot Live Agent transfer flow. You can add multiple possible questions to initiate the transfer.

 

Google Dialogflow

Create a Text Response and add the keyword DIRECT_TRANSFER as the response to trigger the Chatbot Live Agent transfer flow.

 

Close an enquiry from the chatbot side

You can create a close enquiry mechanism between your visitor and the chatbot and set it up in your chatbot portal.

Microsoft QnA Maker

Set this keyword CLOSE_ENQUIRY as the answer to trigger the close enquiry flow. You can add multiple possible questions to initiate the closing of an enquiry.

 

Google Dialogflow

• Create a Text Response and add the keyword CLOSE_ENQUIRY as the response to trigger the close enquiry flow.
• Enable the Set this intent as the end of conversation.
• Enable the webhook call for this intent.
• Click Save

 

Using Chatbot to your Channel

To use your chatbot to serve chat enquiries in your channel:

• Into your Channel - Tag Directory or any Social Pages, create a new channel, edit an existing channel, and go to Routing Settings.
• Under Routing Rules (you may have selected Alternative, Time or Percentage Routing), click + Add Destination , and a pop-up window will show to choose a destination.
• Go to the Chatbot tab, and select the Chatbot you added.

📘

The routing rule should work the same with or without a chatbot in the destination. The chatbot can only serve a chat enquiry.

 

Channel Info on Dialogflow

When an enquiry has been attended by the chatbot Dialogflow, the following channel information will be passed by CINNOX to Dialogflow in JSON format.

 

Directory, Staff, Web Link and Campaign Channels

The following Directory, Staff, Weblink and Campaign channel information are available using the corresponding Dialogflow context key.

• Channel Type
• Channel ID
• Channel Name

 

Social & Other Channels

The following social and others channels information are available using the corresponding Dialogflow context key.

• Channel Type
• Channel ID
• Channel Name
• Channel Source
• Channel Source Name
• Channel Phone Number
• Visitor Name
• Visitor Phone

 

Example Case (Replying Visitor with Channel Info) to test it out

Below is an example case and steps when you want to reply to your visitors and customer with channel information via the chabot Dialogflow.

• On your Dialogflow - Agent, create a new Intent.
• On the Contexts, enter cinnox on the Add output context.

• On the Training phrases, enter the user expression expected for your customers to reply in the conversation.

• On the Responses, enter the text response variant to reply to your customers that comes with the following format:

  • "#cinnox.{parameter}"
    The {parameter} corresponds to the Dialogflow Context Key in the above table.

• Then click on Save.

📘

The same goes for the channel with tag details. Create a new intent and use the following Text Response.

• Tag Type: #cinnox.tagType
• Tag ID : #cinnox.tagId
• Tag Name: #cinnox.tagName