Articles on: Troubleshooting

The chatbox does not work or appear on my website

In some cases, you may not be seeing the Crisp chatbox as you'd expect on your website. Let's find out why.

There are many reasons that may prevent Crisp from being displayed. Find out the most common reasons below:

1. Check your HTML



First thing to check: did you correctly include the chatbox HTML on your website?

Open Google Chrome
In Chrome, access your website
Right click somewhere on your page and click "View Page Source"
In the source, do a quick search for "crisp"

Now on, if you did not find the "crisp" keyword in your page:

Did you include the code on all your website pages?
Do you have any cache running in front of your website? If so, try to purge any cache (eg. if you are using Cloudflare this may be necessary)

2. Your browser cache is outdated



Please reset your browser cache, here is how to reset your browser cache on most browsers:

Google Chrome: https://support.google.com/accounts/answer/32050?co=GENIE.Platform%3DDesktop&hl=en
Firefox: https://support.mozilla.org/en-US/kb/how-clear-firefox-cache
Safari: https://kb.wisc.edu/page.php?id=45060
Opera: http://help.opera.com/Windows/12.10/en/cache.html
Edge: https://www.bitdefender.com/support/how-to-clear-the-cache-and-cookies%C2%A0in-microsoft-edge-1914.html

3. Check for JavaScript conflicts



Some websites use a lot of JavaScript "shim" libraries, used to emulate modern browser JavaScript features in older browsers.

Some of those "shim" JS libraries may prevent the chatbox from running. Temporarily disable any "shim" JavaScript library and see if the chatbox now shows up.

Some libraries like PrototypeJS wrongly emulates the Javascript natives features and are known to cause issues.

4. Browser Extensions Interference



Certain browser extensions, especially those aimed at privacy and ad-blocking, might interfere with the visibility of the Crisp chatbox.

Check if you are using any ad-blockers or privacy extensions. Some known ones to potentially block Crisp include:
Ghostery
DuckDuckGo Privacy
Brave Browser (notably when the chatbox is embedded via GTM)
Avira Browser Safety

5. Ensure chatbox is not hidden if support is offline



You may have enabled the option to hide the chatbox if your support is offline.

Check that this option is disabled and try again accessing your website (this article explains how to enable it, which will also help you disable it).

6. Check your chatbox block rules



Blocking yourself is the most common reason Crisp users don't see their chatbox. Follow this section to ensure you did not block yourself at any point.

You may have configured block rules on your chatbox (eg. block by country, language, IP, etc.).

Ensure all your block rules are disabled:

Go to: https://app.crisp.chat
Go to your settings: click on the settings icon
Click on "Websites"
Pick your website
Click on "Chatbox & Emails settings"
Open "Chatbox restrictions"
Remove any active blocking rule
Important: Clear your blocked visitors rules (ie. when you pressed the "Block user" button in chat)
Try again accessing your website and check the chatbox now shows up

Clear your blocked visitors

7. You use a firewall



Crisp is including HSTS to ensure the best security level compliance.

In few cases, companies as using Firewall, Proxies that replace the default Crisp certificate with a custom one. If you are using Fortinet or a Fortigate you might be impacted.

How to check this?

Go to https://client.relay.crisp.chat/
If everything is working properly, you should see {"code":0,"message":"No Operation"}

If you see a SSL issue or a security alert, you might be impacted by a Firewall. In this case, ask your network administrator to Whitelist Crisp.

8. Check your $crisp JS SDK calls



You or your developer might be using $crisp JavaScript SDK calls to hide the chatbox programmatically.

Ensure you don't have a JavaScript call that contains chat:hide in your code.

9. DOS Protection



Our network automatically blocks potential DOS attacks. If too many users are connecting to the Crisp chatbox under the same IP, Crisp will raise a 420 error.

Updated on: 19/09/2023

Was this article helpful?

Share your feedback

Cancel

Thank you!