Embed a call in third-party software

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.

Manually embed a call or snippet

1. Go to the call page of the call you want to share:

   • In the top right corner of the call, click Share call > Embed call. This opens a dialog with a code and a URL. You can also share part of the call from here. Click Share snippet and select the part you want to share.  

   • To embed a call snippet, select a snippet in the transcript, or from the action bar under the call video, and click Embed call.

2. 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.

3. 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:

     <iframe width="[width]" height="[height]" 
     src="[embeddable-url]" frameborder="0"/>

     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.

1. 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.

2. Paste the URL that you got in step 1 to the third-party application embed area.

3. 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: If you're not sure what your company subdomain is, ask your Gong admin.

Use API to embed a call or snippet

Use this method when you have obtained the call ID or URL via the API.

1. 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.

2. 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.

3. 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.