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
  • Installation
  • 1. Define the Interaction Tab
  • 2. Start Workspace Web Edition
  • Configuring SSO

Was this helpful?

  1. Agent-side integrations
  2. Platform integrations
  3. Genesys

Engage Workspace Web Edition (WWE)

Engage Cloud and Engage On-Premise WWE

PreviousGenesys CloudNextEngage Workspace Desktop Edition (WDE)

Last updated 8 months ago

Was this helpful?

Installation

1. Define the Interaction Tab

Define a new Interaction Tab in your WWE Cluster configuration using Genesys GAX or Genesys Administrator.

If you are using Engage Cloud (AWS or Azure), you may configure the Interaction Tab following the instructions at .

You may name the tab as you wish, for example CobrowseIOTab. The tab should have the following values:

  • label – The label that should be displayed in the tab within the WWE UI, eg. COBROWSE

  • url – The URL to the web content that will be displayed within the tab. The URL can also contain variable names pertaining to agent and interaction data. This value will be provided by Cobrowse.io. The default value when using the Cobrowse.io hosted version is https://cobrowse.io/apps/genesys/index.html?env=wwe&interactionId=$Interaction.Id$&license=your license key

More information about how to add a new Interaction Tab to Workspace Web Edition (WWE) available at .

Next, navigate to the interaction-workspace/interaction.web-content and add the value CobrowseIOTab to this list to enable it.

2. Start Workspace Web Edition

You should now see the COBROWSE tab within your Workspace Web Edition when interacting with an end-user, such as on a phone call, or via a live chat.

Configuring SSO

If you wish to sign into Cobrowse from within WWE using SSO you must first follow our documentation to .

With SAML configured, visit the page of your Cobrowse dashboard and look to the login page URL seen within the SAML Config section. It should look something like https://<DOMAIN>/login/saml/<PROVIDER_ID>.

Take note of your <PROVIDER_ID>. It should a string of 6 characters after the /login/saml/ path seen in the login page URL.

Update url to the URL below, replacing <DOMAIN> with the domain of the Cobrowse instance, often cobrowse.io, <PROVIDER_ID> with the 6 characters that you took note of in the previous step and <YOUR_LICENSE_KEY> with the license key for your account.

https://<DOMAIN>/api/1/saml/auth?provider=<PROVIDER_ID>&redirectTo=%2Fapps%2Fgenesys%2Findex.html%3Fenv%3Dwwe%26interactionId%3D%24Interaction.Id%24%26license%3D<YOUR_LICENSE_KEY>

Now when opening the COBROWSE tab from within WWE you should be taken to your SSO provider allowing you to sign in and be authenticated within WWE.

https://all.docs.genesys.com/PEC-AS/Current/ManageCC/External_URLs
https://docs.genesys.com/Documentation/HTCC/8.5.2/IWWDep/SettingUpAgents#Enabling_integration_of_web_applications_in_the_agent_interface
setup SAML
integration settings