IFrame embeds
We provide a number of different embeddable URLs to suit a range of use cases:
We recommend embedding the Cobrowse Dashboard URL (
https://cobrowse.io/dashboard
) as an IFrame in your CRM if you are looking for the simplest integration options. The full range of Cobrowse features will be available through our default UIs. You can pre-filter device or session lists it as described below in the query params section to show specific devices in different contexts.If you are using our 6-digit codes to initiate sessions, and that is the only mechanism to start sessions you'd like to support for your agents, we have a simplified Cobrowse Code URL (
https://cobrowse.io/code
) that you can embed.Using the Cobrowse Connect URL (
https://cobrowse.io/connect
), Cobrowse will automatically try to connect to the matching device. If multiple devices match the filters you provide, you will be prompted which to select. Make sure to set customData in our SDKs, and use those values in your filters!If you just want to embed the UI for an active session, or even just the video feed, and will replace all other UI with your own implementations, then this is the endpoint you should use:
https://cobrowse.io/session/<session id>
. You will need to replace the <session id>
with a valid session ID. See our Agent SDK docs.Not sure which embed URL is right for you? Get in touch with us at [email protected] and we'll be happy to advise for your use case.
All of our embed URLs support configuration via the parameters described here. We support several query parameters to configure what is shown:
Query Parameter | Description |
token | |
filter_[name] | Filter the list of devices based on any metadata specified in your SDK integration. You may add multiple filters as additional query parameters. All filters are ANDed together when filtering the device list. Please prefix each with "filter_" and ensure the [name] matches the field used in your SDK integration.
For example, [email protected] |
navigation | Set to none to remove the navigation bar. For example ?navigation=none |
end_action | Set to dashboard to redirect back to the device list (/dashboard) on session end. This is the default behaviour.Set to none will show a simple session ended message.Set to code will return to the full screen code entry interface (/code).For example end_action=none |
popout | Set to none to disable the popout button when in a session. For example?popout=none |
agent_tools | Set to none to remove the agent tool selection UI. This is useful when replacing our default UI with your own. |
device_controls | Set to none to remove the device options UI (e.g. full device mode switch). This is useful when replacing our default UI with your own. |
session_details | Set to none to remove the device and custom data sidebar in the session view. |
messages | Set to none to remove messages overlaid onto the screen to indicate events such as "Device not responding". This is useful when replacing our default UI with your own. |
This logic enables you to embed the relevant IFrame data on each place in your CRM. For example, when an agent is looking at a user account view in your CRM, you might use filters to show all of that user's available devices.