> This page is for version v8.3.0 (default). > For other versions, use one of these documentation indexes: > - v8.3.0 (default): https://docs.workflows.com/v-8-3-0/llms.txt > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.workflows.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.workflows.com/_mcp/server. # gong_get_call_details READ # gong_get_call_details Retrieves comprehensive call analytics and metadata from Gong. Use this tool to understand call dynamics, topics, and speaker participation before retrieving full transcripts. > **Success** > > Get a high-level overview of call content and structure without downloading the full transcript. Perfect for filtering calls before mind creation or analyzing call patterns. ## Prerequisites > **Gong Integration Required** > > This tool requires Gong integration to be configured. See the [Gong Setup Guide](/mcp-integrations-gong-setup) for configuration instructions. ## Parameters ### callId
**Type** string
**Required** Yes
**Description** The unique call identifier from `gong_list_calls` response
**Example** `call_abc123`
## Request ```json { "callId": "call_abc123" } ``` ## Response ```json { "callId": "call_abc123", "title": "Discovery Call - Enterprise Prospect", "date": "2024-11-15T14:30:00Z", "duration": 3600, "participants": [ { "name": "Mike Chen", "email": "mike.chen@yourcompany.com", "role": "internal", "speakingTime": 1200, "wordCount": 2400, "talkRatio": 0.33 }, { "name": "Sarah Johnson", "email": "sarah.johnson@prospect.com", "role": "prospect", "speakingTime": 2400, "wordCount": 4800, "talkRatio": 0.67 } ], "topics": [ { "name": "Onboarding Challenges", "mentions": 12, "duration": 900 }, { "name": "Pricing Discussion", "mentions": 8, "duration": 600 }, { "name": "Integration Requirements", "mentions": 5, "duration": 450 } ], "structure": { "phases": [ { "name": "Introduction", "startTime": "00:00:00", "duration": 300 }, { "name": "Discovery", "startTime": "00:05:00", "duration": 1800 }, { "name": "Solution Discussion", "startTime": "00:35:00", "duration": 1200 }, { "name": "Next Steps", "startTime": "00:55:00", "duration": 300 } ] } } ``` ### Response Properties | Property | Type | Description | | ------------------------------ | ------ | ------------------------------------------- | | `callId` | string | The call identifier | | `title` | string | Call title from Gong | | `date` | string | ISO 8601 timestamp of the call | | `duration` | number | Total call duration in seconds | | `participants` | array | Array of participant objects with analytics | | `participants[].name` | string | Participant's full name | | `participants[].email` | string | Participant's email address | | `participants[].role` | string | `"internal"` or `"prospect"` | | `participants[].speakingTime` | number | Total speaking time in seconds | | `participants[].wordCount` | number | Total words spoken | | `participants[].talkRatio` | number | Percentage of total speaking time (0-1) | | `topics` | array | Topics discussed during the call | | `topics[].name` | string | Topic name identified by Gong | | `topics[].mentions` | number | Number of times topic was mentioned | | `topics[].duration` | number | Total time discussing this topic (seconds) | | `structure` | object | Call structure and phases | | `structure.phases` | array | Chronological phases of the call | | `structure.phases[].name` | string | Phase name (e.g., "Discovery", "Pricing") | | `structure.phases[].startTime` | string | Start timestamp (HH:MM:SS) | | `structure.phases[].duration` | number | Phase duration in seconds | ## Common Use Cases #### Filter Calls Before Transcript Retrieval Review call topics and participants to decide which calls warrant full transcript retrieval. **Example:** ``` "Get details on my last 10 calls and show me which ones discussed pricing objections" ``` **Natural language workflow:** * AI lists recent calls * Gets details for each call * Filters to those with pricing-related topics * Presents filtered list for transcript retrieval **What you get:** * Topic-based filtering * Avoid downloading irrelevant transcripts * Focus on high-value conversations * Efficient use of API calls #### Analyze Speaker Participation Understand speaker dynamics before creating minds. **Example:** ``` "Show me the talk ratios for all participants in my enterprise calls this month" ``` **Natural language workflow:** * Lists enterprise calls * Gets details for each * Analyzes speaker statistics * Identifies participation patterns **What you get:** * Speaker engagement metrics * Talk time distribution * Identify dominant vs. quiet participants * Select balanced conversations for training #### Topic Analysis Across Calls Identify recurring topics and themes across multiple calls. **Example:** ``` "Analyze my discovery calls from Q4 and tell me what topics came up most frequently" ``` **Natural language workflow:** * Lists Q4 discovery calls * Gets details for each call * Aggregates topic mentions * Ranks by frequency **What you get:** * Topic frequency analysis * Common pain points * Recurring objections * Product feature requests #### Call Quality Assessment Evaluate call structure and flow before using for training. **Example:** ``` "Find calls where the discovery phase lasted more than 20 minutes and the prospect spoke more than 60% of the time" ``` **Natural language workflow:** * Lists calls * Gets details for each * Filters by structure and talk ratio criteria * Returns qualifying calls **What you get:** * High-quality discovery calls * Prospect-centric conversations * Ideal training data for minds * Best practice examples ## Error Responses #### 404 Not Found ```json { "error": "Not Found", "message": "Call with ID 'call_abc123' does not exist" } ``` **Solution:** Verify the call ID is correct. Use `gong_list_calls` to get valid call IDs. #### 401 Unauthorized ```json { "error": "Unauthorized", "message": "Gong authentication failed" } ``` **Solution:** Verify your Gong credentials are configured correctly. #### 403 Forbidden ```json { "error": "Forbidden", "message": "You do not have permission to access this call" } ``` **Solution:** Check your Gong user permissions for this call. #### 400 Details Not Available ```json { "error": "Bad Request", "message": "Call details not yet available" } ``` **Solution:** The call may still be processing. Wait and retry. ## Best Practices #### Pre-Filter Before Transcripts * Use call details to filter calls before retrieving full transcripts * Check topics to ensure relevance * Review speaker participation for balance * Verify call duration and structure #### Topic-Based Selection * Identify calls discussing specific topics * Find recurring themes across calls * Select calls for topic-specific mind training * Track topic evolution over time #### Speaker Analysis * Use talk ratios to find balanced conversations * Identify calls where prospects were engaged * Find calls with specific participants * Select diverse speaking styles for training ## Integration with Mind Reasoner ### Workflow: Topic-Based Mind Creation #### List Calls Use `gong_list_calls` to get recent calls #### Get Details Use `gong_get_call_details` to analyze topics and participants #### Filter Select calls discussing relevant topics with engaged prospects #### Get Transcripts Retrieve full transcripts only for selected calls #### Create Minds Build minds from filtered, high-quality conversations **Natural language example:** ``` "Find all my calls where we discussed enterprise features, the prospect spoke more than 50% of the time, and create minds for each engaged prospect" ``` ## See Also #### [gong_list_calls](/mcp-tool-gong-list-calls) Find calls before getting details #### [gong_get_transcript](/mcp-tool-gong-get-transcript) Get full transcripts after reviewing details #### [Gong Tools Overview](/mcp-integrations-gong) See all Gong tools and workflows