The Cobrowse SDK for web is available either using a
<script>tag via CDN, or can be included in your build via NPM.
<head>section of your website.
CobrowseIO.license = "put your license key here";
First install the Cobrowse SDK for web via NPM:
> npm install cobrowse-sdk-js --save
Then you can initialise the SDK:
import CobrowseIO from 'cobrowse-sdk-js'
CobrowseIO.license = 'your license key here'
This will associate sessions from your website with your Cobrowse.io account.
Cobrowse.io for Web supports all major browsers including Chrome, Firefox, Safari, Opera, Edge, and IE11.
Our Web SDK has an optional "full-device" mode which enables the user to share their entire desktop without any installation. Due to browser limitations, this feature is not available on IE11, or in the mobile browsers such as Mobile Chrome and Mobile Safari. Please see our native Android and iOS SDKs for full device capabilities on mobile.
The specific browser versions supported are Chrome 16+, Firefox 11+, Safari 7+, Opera 12.1+, Edge 12+, and IE11.
Please use the following steps to troubleshoot issues on web:
- check that all steps of these docs and requirements have been followed
- inspect the developer console on the agent and client-side to see any error messages
- check the below sections to see if they match the error messages you can see
Certain resources (e.g. CSS) may not be exposed to the public internet (e.g. pre-production environments such as UAT) and so these elements of your webpage will not appear to agents.
You will see error messages in the developer console relating to
https://cobrowse.io/proxy/1/assets/<hex encoded asset>. You can check which assets are encoded by pasting the hex code into https://cryptii.com/pipes/hex-decoder.
Make sure these assets are accessible to our server by making them public, or by whitelisting requests from
Refused to connect to https://cobrowse.io/... because it violates the document's Content Security Policy.
To solve this, you will need to enable the following in your CSP:
connect src of:
connect-src cobrowse.io *.cobrowse.io wss://*.cobrowse.io;
script-src 'unsafe-inline' js.cobrowse.io;
If the same user has an incognito window (or multiple) running at the same time as their usual browser window, then the incognito windows will be separate devices in the device listing.