Connecting WOZTELL

Connect your WOZTELL channel account to your CINNOX service. Your visitors' and customers' messages on the WOZTELL channel become social enquiries in your CINNOX service, which any of your staff can attend to as one-on-one conversations.

This user manual page covers three main parts:

If you already have the WOZTELL channel account, you are ready to start from PART II.

 

👍

Notes

Implementing the WOZTELL chatbot is crucial to the enquiry handling process between chatbot and CINNOX. To implement it, you must ensure that the pre-defined tree nodes are added to your WOZTELL chatbot and also included in the Tree Settings of the WOZTELL channel you are going to connect to CINNOX.

Please follow the instruction in Switch between the WOZTELL chatbot and the live chat function in CINNOX to configure the tree nodes.

After configurating the pre-defined nodes added to Trees, you can continue to process the PART II to connect your WOZTELL channel to CINNOX. You can not only switch between the WOZTELL chatbot and the live agent in CINNOX but also closes the enquiry handled by the WOZTELL chatbot.

 

PART II: Connect your WOZTELL channel to CINNOX

From CINNOX Dashboard, navigate to Channels >Social. On the Social page, click on Connect Social. A pop-up window displays a list of sources that you can connect to.

14811481

Connect Social page

 

Step 1: Connect WOZTELL channel to CINNOX

  • On the Add Source page, Click Connect to WOZTELL.
15121512

Create a WOZTELL channel to CINNOX

 

  • Click on +Select your WOZTELL Channel to CINNOX.
14661466

Connect your WOZTELL Channel to CINNOX

 

  • On Connect WOZTELL Channel to CINNOX page, click on the drop-down list to choose either WhatsApp Cloud, Facebook or Instagram as your platform.

  • Fill in the following information:

    • Account Access Token - log in to WOZTELL channel and navigate to Settings. Click on Access Tokens. Copy the generated access token (Long Token (v1)) and paste the value on its respective field on the WOZTELL configuration page. Refer to Important Note about Account Access Token for selecting the scopes and permissions.

    • Channel ID - log in to WOZTELL channel and navigate to Channels. Find the channel you want to connect to from the list and click on "..." button. Click on Copy Channel ID and paste it.

    • Environment ID - log in to WOZTELL channel and navigate to Channels. Click on Edit next to the required channel you are going to connect to CINNOX. Copy ENV ID value on Environment Settings and paste it.

    • Advanced Access Token (required only for WhatsApp Cloud) - log in to WOZTELL channel and navigate to Channels. Click on Platform and Advanced Access tab. Click on Generate on Generate Access Token section. Copy the token value and paste it.

  • Click on Next.

14381438

Set up a new WOZTELL channel

 

📘

Important

When you receive an error message in connecting WOZTELL channel to CINNOX, please try to check the following items:

  • The validity and correctness of Account Access Token value.
  • The scopes of Account Access Token value.
  • The validity and correctness of Channel ID and/or Environment ID.
  • The WOZTELL channel might be duplicate.
  • The platforms in WOZTELL channel supported by CINNOX.
  • The “CX_CLOSED_ENQUIRY” node existed in your WOZTELL chatbot tree.

 

Step 2: Configure the CINNOX Channel and Routing Setting

Channel Name

  • Add a name to your WOZTELL channel. The channel name can be filled in up to 40 characters. Click on Next.
15171517

Add a Channel Name

 

Routing Settings

989989

Routing Settings

 

Step 3: CINNOX Auto-Message Message Settings

You can enable and configure the following Auto-Reply Messages:

  • Welcome Messages: They are greetings sent to customers when they first message you.
  • Away Messages: They are only sent if no staff are available to answer an enquiry.
  • Close Enquiry Messages: They will be sent to the visitors' chatrooms when the staff or the system closes the enquiries.

Display Name Format
You may include staff display names in your messages. Choose from the following options:

  • No name to display
  • Staff first name
  • Staff first name + last name

Welcome Message

  • CINNOX provides a default welcome message.
  • Toggle the switch on to enable it.
  • After toggling on it, you can change the default message according to your need.

Away Message

  • CINNOX provides a default away message.
  • Toggle the switch on to enable it.
  • After toggling on it, you can change the default message according to your need.

Close Enquiry Message

  • CINNOX provides a default close enquiry message.
  • Toggle the switch on to enable it.
  • After toggling on it, you can change the default message according to your need.
11551155

Customise welcome, away and close enquiry messages

 

Step 4: Enable CINNOX Channel Custom Info

Channel Custom Info allows you to add your channel details that your staff would see in the call screen and chat room whenever they are serving an enquiry. The custom info can be about the standard procedure or operation details of handling the enquiry.

  • Toggle on the switch to enable the Channel Custom Info.
  • A blank space adds the required basic information about the channel.
  • Click the Next button to complete all configurations, and the customised info appears on the Channel Custom Info.
10201020

Channel Custom info

 

The custom info is displayed on the staff side at the chat room section for the chat enquiry.

18741874

Custom Channel Info on the Enquiry Page

📘

Important

  • You can customise the Channel Custom Info per Channel - Directory/Tag, Number, Social and Third Party Channel.
  • Channel Custom Info is available for call and chat enquiries.
  • The Channel Custom Info does not support Direct Staff Enquiry and Enquiry from the Campaign Web Link.
  • The Channel Custom Info you can add is 10,000 chars per channel. Please ensure it is not more than the limit to work correctly.
  • The Channel Custom Info will still be displayed as a chatbot message in the enquiry room if an enquiry is missed.

 

When your connection is successful, you can see this message. Click on Done.

966966

WOZTELL connection is successful

 

  • Created channels listed on the Social page.
15231523

Social Main Page

 

PART III: Managing WOZTELL channels in CINNOX

To edit, suspend, or delete your WOZTELL channels in CINNOX, refer to Managing Social Channels section of this Guide.

🚧

If you updated the WOZTELL chatbot tree and webhook, please log in to your Dashboard and navigate to the Administration page >Channel Source. Click on your required channel and click Webhook & Tree Settings to sync your updated WOZTELL chatbot tree and webhook settings with CINNOX.

15881588

Source Detail page

📘

CINNOX supports Plain Text, Quick Reply, and Carousel message types to respond to customer messages.

 

Switch between the WOZTELL chatbot and the live chat function in CINNOX

How to switch the WOZTELL chatbot to the live chat function in CINNOX

To switch the WOZTELL chatbot to the live chat function in CINNOX, we are required to add a node on the chat bot tree.

  • Navigate to Bot Builder.
  • Click on + Tree Node and + New Action in Pre-actions.
  • Add the keyword CX_GET_STARTED as the command in the Advanced script. Click on Save.
  • Click on Post-actions and + New Action to enable the Live Chat function in the Advanced script and for the visitors to trigger the function afterward. Click on Save.

When the visitors switch the chatbot to the live agent function, for example, by clicking on the “Find Live Agent” button, the chatbot function stops. And then the enquiry is routed to CINNOX and becomes an open enquiry for an agent to pick up.

11551155

Switch the WOZTELL chatbot to the live chat function

 

How to activate the WOZTELL chatbot after the live agent closed the enquiry in CINNOX

To switch the live chat function in CINNOX to the WOZTELL chatbot, we are required to add a node on the chat bot tree.

  • Navigate to Bot Builders in WOZTELL.
  • Select the existing tree where you are required to add a node.
  • Click on+ Tree Node and enter the Node Name as CX_CLOSED_ENQUIRY in the Basic Information.
  • Click on Post-actions and + New Action to disable the Live Chat function in the Advanced script. Click on Save.

When the live agent closes the enquiry in CINNOX, the visitor will be redirected to the node "CX_CLOSED_ENQUIRY", meaning that the live chat function is disabled and concurrently the WOZTELL chatbot is activated.

11691169

Switch the live chat function to the WOZTELL chatbot

 

📘

Make sure the node name of "CX_CLOSED_ENQUIRY" can only exist in one tree.

 

How to close the enquiry handled by the WOZTELL chatbot

To close the enquiry handled by the WOZTELL chatbot, we are required to add a node on the chat bot tree.

  • Navigate to Bot Builders in WOZTELL.
  • Select the existing tree where you are required to add a node.
  • Click on+ Tree Node and + New Action in Pre-actions.
  • Add the keyword CLOSE_ENQUIRY as the command in the Advanced script. Click on Save.

When the node "CLOSE_ENQUIRY" is trigged, for example, by sending an Customer Satisfaction Survey as a message to the visitor, the ongoing enquiry handled by the WOZTELL chatbot will be closed in CINNOX.

11551155

Close the enquiry handled by the WOZTELL chatbot

 

How to connect your chatbot tree to your channel

After configuring your WOZTELL chatbot with required tree nodes as mentioned above, you can connect the tree nodes to your channel.

  • Navigate to Channels and Edit for the channel where you are required to add a new tree node in WOZTELL.
  • Navigate to Tree Settings on the right hand side of the navigation menu. Select a chatbot tree with the added nodes to connect to your channel. Click on Save.
802802

Select the required Tree

 

📘

WOZTELL Channel Known Limitation

  • Rate limit:
    • Rate limit of the chatbot API: 4 API requests/ per second. Delay may occur in CINNOX when the number of API requests exceeds the rate limit.
    • Rate limit of Open API: 60 API requests/ per minute. In CINNOX, the visitor-uploaded file whose open API goes beyond the 60th request will be regarded as a broken file.
  • Message type supported by CINNOX:
    • Facebook & Instagram:
    • Text
    • WhatsApp:
      • Text
      • Image
      • Audio
      • Video
      • Sticker
      • File
      • Reply button
  • For file types & size limits supported by WOZTELL, please refer to the following documentation listed on the Facebook/ Instagram & WhatsApp official website or WOZTELL website:
  • Error handling for the configuration between the WOZTELL channel and CINNOX:
    • The connection between the WOZTELL channel and CINNOX is a prerequisite for deploying the chatbot.
    • Log in to the WOZTELL account > Navigate to Member> find the visitor name in the list > click Detail> Turn off Live Chat and Save > The visitor can converse with a chatbot.

 

Enquiry Status in Different Chatbot Configurations

14841484

Enquiry status for the configuration

 

Help and Support

If your CINNOX service account fails to receive the messages from your WOZTELL channels:

  • Log in to your WOZTELL channel account and check the details of your Account Access Token, ENV ID and Channel ID and please ensure all are the same as that in your CINNOX Channel Details.
  • Send a test message to your connected channels and check whether your CINNOX service account receives it or not.

If your CINNOX service fails to receive any messages, contact our CINNOX Support Team at [email protected].