- DarkLight
Use your existing calls in third-party applications such as a learning management system (LMS) for a seamless, more secure, experience. For example, share best demos, great sales pitches, and more so that other people can learn from them.
For security reasons, people must be Gong users with permission to access the embedded call, and they need to be signed in to Gong to play it.
There are three ways you can embed a call or snippet: manually, by copying the URL, or using API. These three methods are described below.
Manually embed a call or snippet
This is the easiest way to embed a call or snippet.
Start by picking what you want to share:
To embed an entire call, go to the call page and click Share Call > Embed call.
To embed a call snippet, go to the call page, select a snippet in the transcript view, and click Share > Embed call.
Copy the code or URL:
If the third-party where you’re pasting the call/snippet supports adding HTML code, click COPY CODE to copy the embed code, which is the iframe tag containing the relevant embedded call URL (recommended).
If your system supports adding URLs and embeds them in an iframe, click COPY URL to copy the call’s embeddable URL, which you can then put inside the third-party application.
Follow the instructions of your third-party application to insert the code/URL where you want.
For the copied URL, use an iframe element as follows:
Where the embeddable-url is the URL you got in step 2.
Note that the iFrame width must have a width of at least 280px.
The call displays inline where you placed the code.
Copy the URL (oEmbed)
Use this method if the target third-party application supports the oEmbed protocol.
Start by picking what you want to share:
To embed the entire call, copy the call URL from the browser address of the call page in Gong.
To embed a call snippet, select a snippet of the call in the transcript view, and click Share > Share internally, and click Get shareable link.
Paste the URL that you got in step 1 to the third-party application embed area.
In the target, invoke the following request:
https://[your subdomain].app.gong.io/oembed?url=[call page url]
Where the call page url is the URL you got in step 1.
The call displays inline where you placed the code.
Tip:
Ask your Gong admin if you're not sure what your company subdomain is.
Use API to embed a call or snippet
Use this method when you have obtained the call ID or URL via the API.
Use the Gong API to get the call ID via the API.
Refer to the Gong API documentation if you don't know how to do this.
Prepare the following URL formats for embedding:
Full call:
https://[your subdomain].app.gong.io/embedded-call?call-id=[call-id]
Where the call-id is the one obtained via the API.
Call snippet (based on data obtained from the API like topics, trackers or keywords):
https://[your subdomain].app.gong.io/embedded-call?call-id= [call-id]&from=[from]&to=[to]
Where the call-id is the one obtained via the API, and the from and to are the number of seconds since the beginning of the call for the start and end of the snippet.
Tip:
Ask your Gong admin if you're not sure what your company subdomain is.
Add the prepared URL to an iFrame in the target:
<iframe width="[width]" height="[height]" src="[embeddable-url]" frameborder="0"/>
Where embeddable-url is the URL you prepared in step 2.
Notes
When embedding a snippet, only the snippet is embedded with the option to 'go to call'.
The transcript is not embedded with the call.
The recommended dimensions of the iFrame are width: 540px and height: 380px. The minimum width is 280px.
Safari is not supported.