Gong Automation

Gong Automation

Unlock insights from your sales calls -- retrieve transcripts, analyze call data by date range, access detailed conversation analytics with topics and trackers, and manage workspaces -- all through natural language commands.

Toolkit docs: composio.dev/toolkits/gong

---

Setup

Add the Composio MCP server to your client configuration:

https://rube.app/mcp

Connect your Gong account when prompted (OAuth / Bearer token authentication).

Start issuing natural language commands to analyze your call data.

---

Core Workflows

1. Retrieve Call Transcripts by Date Range

Get transcripts for all calls within a specified time period, with optional filtering by specific call IDs or workspace.

Tool: GONG_RETRIEVE_TRANSCRIPTS_OF_CALLS_V2_CALLS_TRANSCRIPT

Example prompt:
> "Get Gong transcripts for all calls from February 1-10, 2025"

Key parameters:

filter__fromDateTime -- ISO-8601 start date (e.g., 2025-02-01T00:00:00Z)

filter__toDateTime -- ISO-8601 end date (e.g., 2025-02-10T23:59:59Z)

filter__callIds -- Optional array of specific call IDs to filter

filter__workspaceId -- Optional workspace ID filter

cursor -- Pagination cursor from previous response

Required scope: api:calls:read:transcript

---

2. Get Transcript for Specific Calls

Retrieve transcripts with speaker information, timestamps, and topic categorization using a filter object.

Tool: GONG_GET_CALL_TRANSCRIPT

Example prompt:
> "Get the Gong transcript for call ID 555785916001072125"

Key parameters (filter required):

filter.callIds -- Array of specific call IDs (e.g., ["555785916001072125"])

filter.fromDateTime -- ISO-8601 start date

filter.toDateTime -- ISO-8601 end date

filter.workspaceId -- Optional workspace filter

cursor -- Pagination cursor

---

3. List Calls by Date Range

Retrieve basic call metadata (participants, duration, timing) for calls within a date range.

Tool: GONG_RETRIEVE_CALL_DATA_BY_DATE_RANGE_V2_CALLS

Example prompt:
> "List all Gong calls from last week"

Key parameters (both required):

fromDateTime -- ISO-8601 start date (e.g., 2025-02-03T00:00:00Z)

toDateTime -- ISO-8601 end date (e.g., 2025-02-10T00:00:00Z)

workspaceId -- Optional workspace filter

cursor -- Pagination cursor

Required scope: api:calls:read:basic

---

4. Get Detailed Call Analytics

Retrieve extensive call details including highlights, key points, topics, trackers, speaker stats, questions, and media URLs.

Tool: GONG_RETRIEVE_FILTERED_CALL_DETAILS

Example prompt:
> "Get detailed analytics for Gong calls this week including topics, key points, and speaker stats"

Key parameters:

filter__fromDateTime / filter__toDateTime -- Date range filter

filter__callIds -- Specific call IDs

filter__primaryUserIds -- Filter by call host user IDs

Content selectors (all boolean):

- contentSelector__exposedFields__content__keyPoints -- Key points of the call
- contentSelector__exposedFields__content__topics -- Topic durations
- contentSelector__exposedFields__content__highlights -- Call highlights
- contentSelector__exposedFields__content__outline -- Call outline
- contentSelector__exposedFields__content__brief -- Spotlight call brief
- contentSelector__exposedFields__content__callOutcome -- Call outcome
- contentSelector__exposedFields__content__trackers -- Smart/keyword trackers
- contentSelector__exposedFields__content__trackerOccurrences -- Tracker timing and speaker (requires trackers=true)
- contentSelector__exposedFields__interaction__speakers -- Time each participant spoke
- contentSelector__exposedFields__interaction__questions -- Question counts
- contentSelector__exposedFields__interaction__personInteractionStats -- Host statistics
- contentSelector__exposedFields__media -- Audio/video URLs (valid 8 hours)
- contentSelector__exposedFields__parties -- Party information
- contentSelector__exposedFields__collaboration__publicComments -- Public comments

contentSelector__context -- "Basic", "Extended", or "None" for CRM/external system links

Required scope: api:calls:read:extensive (plus api:calls:read:media-url for media)

---

5. Get a Specific Call by ID

Retrieve basic data for a single call using its unique Gong ID.

Tool: GONG_RETRIEVE_DATA_FOR_A_SPECIFIC_CALL_V2_CALLS_ID

Example prompt:
> "Get details for Gong call 1223781272986876929"

Key parameters (required):

id -- Gong's unique numeric identifier for the call (up to 20 digits)

Required scope: api:calls:read:basic

---

6. List Company Workspaces

Retrieve all workspaces in your Gong organization to get workspace IDs for filtering.

Tool: GONG_LIST_ALL_COMPANY_WORKSPACES_V2_WORKSPACES

Example prompt:
> "List all Gong workspaces in my company"

Key parameters: None required.

Required scope: api:workspaces:read

---

Known Pitfalls

ISO-8601 date format is mandatory: All date parameters must use ISO-8601 format with timezone: 2025-02-01T00:00:00Z or 2025-02-01T02:30:00-07:00. Plain dates will fail.

Date range is exclusive on toDateTime: The toDateTime parameter returns calls started UP TO BUT EXCLUDING the specified time. To include calls on a specific day, set toDateTime to the next day.

Pagination is required for large result sets: All list endpoints return paginated results. Use the cursor value from the previous response to fetch the next page. Continue until no cursor is returned.

Scope requirements vary by endpoint: Different endpoints require different API scopes. Transcript access needs api:calls:read:transcript, basic call data needs api:calls:read:basic, and detailed analytics need api:calls:read:extensive.

Media URLs expire after 8 hours: Audio and video URLs returned by the detailed call endpoint are temporary and expire after 8 hours.

Tracker occurrence data availability: Tracker occurrence data (timing and speaker ID) is only available for calls recorded since January 1, 2023. Contact Gong support for backfill.

Web-conference vs. regular calls: For web-conference calls recorded by Gong, the date represents the scheduled time. For other calls, it represents the actual start time.

---

Quick Reference

---

Powered by Composio