This site is no longer updated.Go to new Conversational Cloud docs


JivoChat is a service that people use to communicate with customers. It provides different connection channels: social networks, instant messengers, emails, calls, chat widgets, and much more.

To use JivoChat, you need to:

  1. Create a script.
  2. Publish your bot to the JivoChat channel.
  3. Set up the JivoChat service.
  4. Test the bot.

Create a script

Learn more on how to create a bot and write a script

Dialog start

In JivoChat, only clients can begin the conversation with the bot. To make the dialog start on any first client phrase, add a global $TEXT intent.

  1. Click Add screen → Create your own intent.
  2. Add $TEXT as an example phrase.
  3. Activate Make the block available from any script point.
  4. Connect this intent with the welcome screen in your script.

Do not connect the Other intents option with any other blocks.

From now on, the bot will start the dialog as soon as the client writes the first message.

Handling unpredictable client messages

To make the bot able to respond to client messages that are not intended in the script, add another intent and enter $TEXT.

Connect the Other intents option with a block that will contain a response in case the client writes something unpredictable.

This time, do not activate Make the block available from any script point.

Otherwise the global $TEXT intent configured to start the dialog won’t catch phrases from other screens and won’t transfer the dialog to the welcome screen.

Usage details

When developing the script, note the following channel usage details:

  1. JivoChat supports hyperlinks in bot text replies.

    • Use the Markdown markup to add the hyperlink: [Text](
  2. JivoChat doesn’t display hyperlinks if they are placed on the same screen with buttons.

    • The Text block containing hyperlinks should be placed on a separate screen from buttons.
    • For example, you can divide your text into two parts. On the first screen, add the text with a hyperlink and the Transition block. On the second screen, add the second part of the text with no hyperlinks and then add buttons. Connect the first screen with the second one.
  3. JivoChat doesn’t support using buttons in the Image block.

  4. JivoChat doesn’t support adding links to buttons.

  5. You can use JivoChat as a customer engagement platform.

  6. You can prevent clients from entering text messages when using buttons in the script.

    • To do this, activate the Disable text input when using buttons toggle in the channel settings.

Transfer to agent

You can use JivoChat as a customer engagement platform as well.

First, connect JivoChat as an inbound channel, then add the Transfer to agent block to your script. JivoChat will be automatically specified as the customer engagement platform.

If your chatbot is connected to JivoChat, then, after transferring to the agent, the client will not be able to return to the same place in the dialog with the bot. JivoChat doesn’t provide this option.

You can use Webim (Custom Channel API) or LiveTex as the customer engagement platform instead.

Publish the script

When your script is ready, publish it:

  1. Click Publish in the upper right corner or open the Channels tab in the left menu.
  2. Select JivoChat from the channel list, and in the window that opens, click Connect. The channel will appear on the list of connected channels.
  3. Go to the channel settings by clicking the    icon.
  4. Copy the token from the Token field. You’ll need it for setting up the connection on the JivoChat side.

Set up the JivoChat service

After the channel is created, you need to link it to your JivoChat account.

  1. Sign in to your personal account in JivoChat.
  2. Go to the bot connection page.
  3. Set up the bot appearance by uploading its avatar and role.
  4. Paste the token you copied when published the script to the channel.
  5. Choose the channels in which the bot will be available.
  6. Save the changes.

Done! You’ll see the bot on the Integrations list.

Test your bot

Now test the bot by writing to it in the JivoChat widget on your website.