My Agent Can't Find Gong Calls Unless I Give It a Direct Link

The Gong API requires a date range or a specific call ID to return calls — there is no keyword search, and no way to look up a call by name or topic. This is a constraint of Gong's own API, not Gumloop. Your agent needs a time window, a call ID, or help from another tool (Salesforce, calendar) to find the right recording.


Symptoms

  • Your agent returns no results when you ask it to find a Gong call by name, topic, or keyword (e.g., "find my call with Acme").

  • The agent can retrieve a call when you paste a direct Gong URL or give it a specific call ID.

  • Prompts like "get my latest Gong recording" or "find the call about pricing" return nothing.

Why This Happens — It's a Gong API Limitation

This is not a Gumloop bug. Gong's own API does not provide a way to search calls by keyword, topic, or name. Here's exactly what's happening under the hood:

What the Gong API actually offers

Gong exposes two endpoints for finding calls:

Endpoint

What it does

Required input

GET /v2/calls (list_calls)

Returns calls within a time window

fromDateTime and toDateTimeboth required

POST /v2/calls/extensive (get_detailed_calls)

Returns detailed call data with filters

A filter object — requires at least a date range or specific callIds

Neither endpoint supports searching by call name, topic, transcript text, or any keyword. The list_calls tool in Gumloop maps directly to GET /v2/calls and passes fromDateTime and toDateTime as required query parameters. Without those dates, the Gong API returns nothing.

What Gumloop's integration does

Gumloop's Gong integration is a thin wrapper over Gong's official API. It sends your agent's request to Gong's endpoints with no modifications or restrictions. When your agent says "find my call about Acme," it has no mechanism to translate that into the date-range query that Gong requires — because no such search mechanism exists in the Gong API.

You can verify this yourself in Gong's official API documentation — the /v2/calls endpoint explicitly requires fromDateTime and toDateTime.


How to Fix It

Option 1: Include a date range in your prompt

The simplest fix — give the agent a time window so it can call the Gong API successfully.

Example prompts you can try right now:

  • "Find my Gong calls from the last 7 days"

  • "Get my calls from March 25–31"

  • "Show me all Gong calls from this week involving anyone at Acme"

  • "Pull my Gong recordings from yesterday and summarize each one"

Once the agent retrieves the list, you can follow up with "Which one was with Acme?" or "Summarize the third one" — it will narrow down from the results it already has.

To make this automatic, tell your agent in the same chat:

Update your system prompt to include this instruction:

When I ask you to find a Gong call and I don't specify a date range,
default to searching the last 14 days. Use the list_calls tool with
fromDateTime set to 14 days ago and toDateTime set to now. Then filter
the results based on what I asked for (company name, participant,
topic, etc.).

Or have your agent create a skill file for it:

Create a new skill called "gong-lookup" with this behavior:

When I ask you to find a Gong call and I don't specify a date range,
default to searching the last 14 days. Use the list_calls tool with
fromDateTime set to 14 days ago and toDateTime set to now. Then filter
the results based on what I asked for.

If your agent has the self-updating toggle turned off, you can add the instruction manually in the agent's system prompt field instead.


Option 2: Anchor through Salesforce

If your team uses Salesforce, your agent can find the Gong call ID indirectly. Salesforce opportunity and account records often contain linked Gong call IDs, so the agent searches Salesforce first, grabs the ID, then pulls the call from Gong.

Example prompts:

  • "Find the most recent Gong call linked to the Acme opportunity in Salesforce"

  • "Get the Gong transcript for the last call on the Widgets Corp deal"

  • "Look up the Salesforce record for Initech and pull the Gong recordings attached to it"

To make this automatic, tell your agent in the same chat:

Update your system prompt to include this instruction:

Whenever I ask you to find a Gong call by company name, deal name, or
contact name:
1. Search Salesforce for the relevant opportunity, account, or contact.
2. Look for any linked Gong call IDs on that record.
3. Use get_call or get_call_transcript with those IDs to pull the call.
4. If no Gong IDs are linked, fall back to using the meeting date from
   the Salesforce activity to search Gong with a date range.

Or have it create a skill: "Create a skill called 'gong-salesforce-lookup' with the above behavior."

This is the approach used by teams who have Gong working reliably in production.


Option 3: Anchor through Google Calendar

If you have Google Calendar connected, the agent can look up the meeting on your calendar first. The calendar event gives it the exact date, time, and participants — more than enough to build a precise Gong query.

Example prompts:

  • "Find the Gong recording for my meeting with Sarah from Acme last Tuesday"

  • "Check my calendar for meetings with Initech this month and pull the Gong transcripts"

  • "Get the Gong call from my 2pm meeting yesterday"

To make this automatic, tell your agent in the same chat:

Update your system prompt to include this instruction:

When I ask you to find a Gong call and I mention a person or company
but not a specific date:
1. Search my Google Calendar for recent meetings matching that person
   or company name.
2. Use the meeting date/time to construct a narrow date range for the
   Gong list_calls tool (1 hour before to 2 hours after the start).
3. Match the Gong call to the calendar event using participant names
   or timing overlap.
4. If multiple matches, list them and ask which one I meant.

Or: "Create a skill called 'gong-calendar-lookup' with the above behavior."


Option 4: Filter by user ID

If you're looking for calls from a specific sales rep or team member, the get_detailed_calls tool supports a primaryUserIds filter. Combining a date range with a user ID filter narrows results from hundreds of org-wide calls to just the ones hosted by that person.

Example prompts:

  • "Find all Gong calls hosted by Sarah Chen in the last 2 weeks"

  • "Get me Jake's Gong calls from last week and summarize each one"

  • "Show all my own Gong calls from this month"

To make this automatic, tell your agent in the same chat:

Update your system prompt to include this instruction:

When I ask for Gong calls by a specific person's name:
1. Use list_users to find their Gong user ID.
2. Use get_detailed_calls with the filter object, setting
   primaryUserIds to that ID and a date range of the last 14 days
   (or whatever timeframe I specified).
3. Return results sorted by date, most recent first.

Option 5: Browse Gong Library folders

Gong has a Library feature where your team can organize important calls into curated folders (e.g., "Best Demo Calls," "Won Deal Recordings," "Onboarding Calls"). These folders can be browsed without any date range — the only way to discover calls without dates or IDs.

Example prompts:

  • "Show me what's in the Gong Library"

  • "List the calls in the 'Top Demo Calls' folder in Gong"

  • "Find the best example of a pricing objection handling call from the Gong Library"

To make this automatic, tell your agent in the same chat:

Update your system prompt to include this instruction:

When I ask for a Gong call by topic or category (e.g., "a good demo
call" or "an example of objection handling") and there's no specific
date or person:
1. Use list_library_folders to see what curated folders exist.
2. Use get_folder_content on the most relevant folder.
3. Present the calls with their titles and dates so I can pick one.

This works best when your team actively curates Library folders in Gong. If your Library is empty, the other options above will be more useful.


Available Gong Tools in Gumloop

For reference, here are all the Gong tools your agent has access to once connected:

Tool

What it does

list_calls

List calls in a date range (requires fromDateTime + toDateTime)

get_call

Get a specific call by ID

get_call_transcript

Get the transcript for a specific call by ID

get_detailed_calls

Get detailed call data with filters (date range, call IDs, user IDs)

list_users

List all users in your Gong org

get_user

Get a specific user by ID

list_library_folders

List Gong Library folders

get_folder_content

Get contents of a Library folder

get_interaction_stats

Get interaction stats for users (requires date range)

get_scorecards

List all scorecard definitions

get_answered_scorecards

Get scorecard answers from a date range

get_trackers

Get keyword tracker definitions

list_workspaces

List all Gong workspaces

Full tool documentation: Gong Integration — Available Tools

Still Need Help?

If this didn't resolve your issue, reach out to support at support@gumloop.com.

Related Docs