Embed a call in third-party software
  • 2 minute read
  • Contributors
  • Dark
    Light

Embed a call in third-party software

  • Dark
    Light

Article summary

Embedding calls or snippets from Gong into third-party applications like learning management systems allows for secure sharing of demos and sales pitches. Users must have Gong access and be signed in to play embedded calls. Three methods are provided for embedding: manual embedding, using URLs, and API integration. Each method involves copying URLs or codes and pasting them into the third-party application. Specific instructions are given for each method, including dimensions for the iFrame and tips for successful embedding. The process ensures a seamless and secure experience for sharing valuable content.

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.


Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.
ESC

Eddy AI, a genAI helper, will scrub our help center to give you an answer that summarizes our content. Ask a question in plain language and let me do the rest.