Blitzz Help Center

Blitzz Cobrowse for Zendesk - Installation Guide

Blitzz  Cobrowse offers integration with both Zendesk Support and Zendesk Chat, available in the Zendesk App Marketplace.

Zendesk Requirements

You must have an active trial or subscription with Zendesk Support, even to use our app with Zendesk Chat. This is required by Zendesk to utilize their secure authentication, which is not available for Chat-only accounts.

Zendesk App Marketplace Links

For newer accounts, simply install the Cobrowse.io for Support app, which is fully compatible with Zendesk Messaging and the new Sunshine Conversations widget.

For Support: https://www.zendesk.com/marketplace/apps/support/1054718/cobrowse-for-support-by-blitzz/?queryID=c9e74a2404c191ce5a76e8d5fe15997f

If you are using the legacy Zendesk Chat, you will also need to install the Cobrowse for Chat app.

For Chat: https://www.zendesk.com/marketplace/apps/chat/1054718/cobrowse-for-chat-by-blitzz/?queryID=c9e74a2404c191ce5a76e8d5fe15997f

Controlling User Access

Refer to the Zendesk documentation to restrict access to the Cobrowse apps to specific roles or groups: Managing your installed apps.


The CoBrowse integration for Zendesk seamlessly supports both the Web Widget (Classic) version and the new messaging Web Widget. Simply follow the SDK instructions and below Zendesk integration steps to implement the integration effortlessly.

By installing the Cobrowse Chat application from the Zendesk marketplace, you can view available Cobrowse-enabled devices directly within customer chats. These devices are linked to Zendesk chats through a shared identifier common to both systems. For a detailed explanation of this process, please refer to the information below.

In the Zendesk integration, Cobrowse uses a device Id to be able to correlate sessions, to achieve this:

  1. Install the Blitzz Cobrowse App in your Zendesk environment.
  2. Paste the API key provided by Blitzz as shown in the screenshot below.


  1. Once the API key is added, go to your tickets and you should be able to see the Blitzz CoBrowse UI like the screenshot below.

  1. To get active visitors from your website, Go to your Blitzz CoBrowse portal setting and add the CoBrowse script in your web app as mentioned in this article (shown below in Sample 1 as well)
  2. Install the Zendesk Chat widget on your website in case it is done already using these steps.
  3. Tag Zendesk chat with a tag containing the device id value (shown below in Sample 2).
  4. The Cobrowse Chat application on Zendesk will then be able to correlate both and present the relevant devices.  

For example, when using the Web SDK, you can define a field in the custom data as shown below.

Sample 1:

<script>
  let blitzz;
  let st = document.createElement("script");
  st.src = "https://media.blitzz.co/sdk/blitzzcobrowse.min.js";
  st.async = 1;
  let tx = document.getElementsByTagName("script")[0];
  tx.parentNode.insertBefore(st, tx);
  st.onload = function () {
    if (!blitzz) {
     blitzz = new BlitzzCobrowse({});
      blitzz.initialize({
        license:"your license key",
      });
    }
  };
</script>

Sample 2:
On the other end, Zendesk chats are tagged using the built-in functionality. For example for the device id '123abc':

For Core messaging Web Widget:

zE("messenger:set", "conversationTags",['blitzz_deviceid_'+blitzz.getDeviceID()])


For Zendesk Widget Classic:

zE('webWidget','chat:addTags',['blitzz_deviceid_'+blitzz.getDeviceID()]);


This correlation identifier pattern can be applied to other integration scenarios, where the key lies in using a consistent correlation identifier.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.