ranbot-ai/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

1. Add the Composio MCP server to your client configuration:

   https://rube.app/mcp
   

2. Connect your Gong account when prompted (OAuth / Bearer token authentication).
3. 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"