Here are some common issues and suggested fixes: 

  • Bot goes online then offline again
  • Bot shows offline in Zendesk Chat
  • Bot doesn’t join the conversation
  • Widget missing from my website
  • Bot keeps throwing EOS errors when turned on

Error - The bot goes online then offline again

This is because somebody is logged in to Zendesk as the bot. When someone logs in to the virtual agent's account, this overwrites the integration of the Ultimate Dashboard and changes the status.

To fix the issue:

  1. Switch the Automation Engine toggle off in Settings > CRM integration.
  2. Ask the person to log out as the bot.
  3. Switch the Automation Engine back on.

Error - The bot shows offline in Zendesk Chat

Make sure nobody is logged in as the virtual agent in Zendesk. When someone logs in to the virtual agent's account, this overwrites the integration of the Ultimate Dashboard and changes the status.

To fix the issue:

  1. Restart the bot by switching the Automation Engine toggle off in CRM integration.
  2. Check that nobody is logged in as the virtual agent. If yes, they need to log out. 
  3. Switch the Automation Engine back on.

Error - The bot doesn't join the conversation

Make sure nobody is logged in as the virtual agent in Zendesk. When your bot doesn’t join the chat, there are a few things to do and check. Follow the steps below and always restart the bot after each change to see if it’s working.

Reauthorize the connection between Ultimate and Zendesk

Only Client Admins are able to reauthorize the connection.

To do this:

  1. Sign in to Zendesk as the virtual agent
  2. Sign in to the Ultimate Dashboard in a separate tab
  3. Toggle the Automation Engine off
    mceclip1.png
  4. Navigate to Settings > CRM Integration and click Unauthorize Zendesk Chat
    mceclip0.png
  5. On the same page, go to Integration Parameters and make sure the correct departments are selected
  6.  Click Authorize Zendesk Chat
    mceclip2.png
  7. Once authorization is completed, log OUT as the virtual agent in Zendesk.
  8. Toggle the Automation Engine back on.

 

Department selection

Chats are routed using departments/groups. If you have prechat form enabled in Zendesk Chat, make sure the hide department snippet is implemented correctly with the exact names of the departments/groups. 

Sign out from Zendesk

The bot in our Dashboard can’t join the chat if there’s someone logged in using the bot account in zendesk. To solve this:

  1. Sign out from Zendesk

  2. Restart the bot by switching the toggle next to automation engine in CRM Integration on and off

Restart the bot

  1. Restart the bot by switching the Automation Engine toggle off in CRM integration.
  2. Give it a second before switching it back on again.

Reconnect the bot

It is important to login as the bot in Zendesk before authorizing. Try to reconnect by following the steps below:

  1. Unauthorize in Dashboard

  2. Log out of all Zendesk products

  3. Sign in as the bot account in Zendesk Chat

  4. Repeat the connecting steps 

Check settings in Zendesk Chat

Settings > Agents

  1. Is the Bot there? 

  2. Is it enabled?

  3. Is it online?

mceclip5.png

Settings > Departments

  • Is there a department for the bot? 

  • Is  the bot the only agent in there?

  • Is it enabled?

Settings > Widget > Forms

  • Pre-chat form should be on

  • Required department should be enabled 

mceclip6.png

Settings > Account > Operating hours

  • Is it switched On or Off?

    • If you want the bot to be online only during certain hours, make sure to set it up here.

  • If it’s switched on, are the hours correct?

mceclip7.png

Settings > Routing 

  • Escalation might fail when there are no agents available. Agent availability can be affected by Chat routing and Chat limit. 

  • There are two options here:
    mceclip8.png

  1. Broadcast is preferred if the client doesn’t have “Skills-based routing” on. 

  2. Assigned  is used when the client has “Skills-based routing” on. This can be checked by going to the Skills tab in the top left corner.
    mceclip9.png

  • Chat limit can also be found on Settings > Routing

mceclip10.png

In Zendesk Support

Check if the bot account has access to Zendesk Chat

  1. Go to Zendesk Support > Settings > People

  2. Locate the bot by searching for its namemceclip0.png

  3. Then enable Zendesk Chat by toggling the switch on mceclip1.png
    • You might see "Manage in Admin Center" instead of the toggle depending on your Zendesk version
      mceclip2.png
    • If that's the case follow this screenshot instead:mceclip3.png

In Dashboard

Make sure there’s nothing under Zendesk Tags in Integration parameters

This is only used IF the client uses Zendesk Skill routing. The “tag” here refers to “skill tag” and is NOT the same as chat tags that we use in dialogues. Read more about skill routing in this Zendesk guide.

The screenshot below is an opposite example. If this is what you see, click the trash can icon to remove it.

mceclip4.png

If you use Google Tag Manager

  • Does the widget look like the new one or legacy one? mceclip11.png

  • If it looks like the old one, then check the following:

    • Is the correct container / version being published?

    • In Tags, see if the old one is still enabled. If the client sees one that could be the old one, try to “pause” it and see if it changes anything - they should know how to do this.

    • Another way to see if it’s the legacy one spooking us, go to the website where the current chat widget is, right click to inspect the code.  

Error - The bot sends an EOS error when turned on

Check if the client has IP Restrictions set up on their account:

  • Login to your zendesk

    • go to "zendesk chat"

    • click on "settings " --> "account"

    • click on the tab "security"

    • If the IP restriction is enabled, please add the following:

      • 134.76.204.185
235.189.236.225
335.189.247.185
435.241.186.184
5104.199.104.45
6104.155.74.121
735.205.242.151
835.195.247.223
935.195.110.66

Error - The widget is missing from the website

If you don't see the widget on your website, please follow the Zendesk article below:

https://support.zendesk.com/hc/en-us/articles/225523927-Troubleshooting-Guide-The-widget-is-missing-from-my-website

 

Powered by Zendesk