Embedding a guide into your application involves adding an HTML IFrame with the source attribute set to the URL for your guide. The guide URL will include query string arguments that allow for the hosting application to provide additional parameters about the current guide user, the object the guide will execute upon, and even the hosting application itself.
The URL for the guide runtime is:
You should replace replace
and port 8080 with those used by your servert
You can add query string parameters to this URL. For example the following adds the
parameter that names the location of a published guide whose location is
The full URL will look like:
You can add additional query string arguments to ensure that users can only have one running instance of a guide for an object and to provide context about the hosting application.
Here is a description of all query string parameters that the viewer application uses:
: The URL-encoded value of guide's published contribution URI, as was shown in the example.
: An optional correlation ID for the guide. The ID is a value the application developer provides. It can have any unique string value. If you do not specify one, the server will create and use one. For example, Cloud Extend (an implementation that runs within Salesforce) uses the following formula:
correlationId = Salesforce org ID + object id
(for example, an account)
+ guide ID
After a guide is launched, you can reuse this correlation ID (since it can be recalculated) to select the same guide instance when the user reloads or revisits the web page.
: The host entity type such as an account or contact.
: The object (for example, an account or a contact) ID or a primary key.