Cobrowse.io Docs
  • Getting started
  • SDK Installation
    • Web
    • iOS
    • Android
    • React Native
    • Flutter
    • .NET Mobile
    • macOS
    • Windows
  • SDK Features
    • Account config
    • Identify your devices
    • Use 6-digit codes
    • Redact sensitive data
    • Viewing PDFs
    • Universal Cobrowse
    • Customize the interface
      • Active session controls
      • 6-digit code screen
      • User consent dialog
      • Remote control consent dialog
      • Full device consent dialog
      • Localization / translation
    • Initiate sessions with push
    • Listening for events
    • Full device capabilities
      • Full device screen sharing
      • Full device remote control
      • Managing full device mode
    • Advanced configuration
      • Starting and stopping the SDK
      • Declaring capabilities
      • Intercepting mobile SDK network requests
      • Web
        • IFrames support
        • IE 11 polyfills
        • Cross-domain session support
        • Ignore Views
      • iOS
        • Alternate render method
        • Custom touch handling
      • Android
        • Backporting TLS to older Android versions
  • Agent-side integrations
    • Agent-side overview
    • Platform integrations
      • Zendesk
      • Salesforce
        • Migrating from legacy to v2
        • Salesforce (Legacy)
      • Genesys
        • Genesys Cloud
        • Engage Workspace Web Edition (WWE)
        • Engage Workspace Desktop Edition (WDE)
      • Intercom
      • Freshworks
      • Talkdesk
      • NICE
    • Custom integrations
    • Agent SDK
      • API Reference
      • Sample code snippets
    • Authentication (JWTs)
      • JWT Policies
    • Authentication (SAML 2.0)
    • IFrame embeds
  • Enterprise self-hosting
    • Self-hosting overview
    • Docker Compose
    • Helm chart
      • Image Pull Secret
      • Environment Variables
      • Optional recording components
      • Pod Annotations
    • AWS terraform
      • AWS metrics configuration
    • Azure terraform
      • Azure metrics configuration
    • GCP terraform
      • GCP metrics configuration
    • Sizing guidelines
    • Running your instance
      • Adding a superuser
      • Limiting account creation
      • Limiting magic link recipients
      • Configuring SMTP
      • Managing your deployment
    • Monitoring your instance
      • Available metrics
      • Self-Hosted Prometheus
    • Advanced configuration
      • Air gap configuration
      • Pin web SDK version
      • L7 firewall configuration
      • Docker proxy configuration
    • Troubleshooting
Powered by GitBook
On this page
  • Demo
  • Setup
  • Redaction within Universal Cobrowse
  • How does it work?

Was this helpful?

  1. SDK Features

Universal Cobrowse

For the times where it's not possible to include the Cobrowse Web SDK into the site.

PreviousViewing PDFsNextCustomize the interface

Last updated 9 days ago

Was this helpful?

You should have the Web SDK installed on a client web page before following these steps.

In some cases your customers using your website might need to complete tasks or view sites that you don't own or can modify. Universal Cobrowse allows for the session to continue to others sites, via our Cobrowse Proxy, whereby the agent can still browse and navigate with your customers in real time.

Demo

Setup

Enable 'Universal Cobrowse' in the Cobrowse dashboard under Settings > General > Session Settings.

You will need to share the domains, including any subdomains, that will be used during a Universal Cobrowse session. Please reach out to your account representative.

CobrowseIO.universalLinks = [
    'example.com*',
    'example.io/account*,
    '*.net*',
]

In the example above when the user clicks on a link that navigates to any of the example URLs below it would show that link within the Universal Cobrowse tabs.

https://example.com https://example.com/about https://example.io/account?id=123 https://example.net/help https://site.net

If you wish for all links to launch the Universal Cobrowse experience you can use * to match all URLs.

CobrowseIO.universalLinks = [ '*' ] 

You may also use regex. The example below will launch Universal Cobrowse for any link that is not an example.com or an example.io domain. This can be useful when you might not have a known list of external links.

CobrowseIO.universalLinks = [ /^(?!.*(example.com|example.io)).+$/ ]

Notice the regex is an object not a String.

Redaction within Universal Cobrowse

Redaction is still supported whilst using Universal Cobrowse. Please find full details by using the link below.

How does it work?

When using Universal Cobrowse third-party websites are loaded in a modal window within your website. To achieve this experience we proxy all traffic seen in this modal window from the client to our Cobrowse Proxy.

Only the pages loaded within the Universal Cobrowse window are proxied to the Cobrowse Proxy. When within a normal Cobrowse session the users requests are not proxied / modified.

Any request during the Universal Cobrowse session will be routed and performed through the Cobrowse Proxy, this includes any cookies set on these requests.

You need to supply the SDK with a of URLs that should launch the Universal Cobrowse experience.

glob pattern
Redact sensitive data