Gong Integration

Ingest Gong call recordings

Connect Gong to subscribe to the call.analyzed webhook. Every analyzed call streams to FastFollow with full transcript and metadata, triggering AI follow-up generation.

Open integrationsGong API docs

Technical Admin access required

Only a Gong Technical Admin can create the OAuth client and grant the required scopes. Loop them in before starting this setup.

Setup walkthrough

~15 minutes plus Gong-side approval

1

Create a Gong public app

In your Gong Technical Admin → API Integration → Generate OAuth client. This is the application FastFollow will use to authorize against your Gong workspace.

  • OAuth Client ID and Client Secret are generated by Gong
  • Redirect URI: https://app.fastfollow.ai/api/integrations/gong/callback
  • Note: Only Gong Technical Admins can create OAuth clients
2

Request required scopes

Gong scopes must be explicitly enabled on the OAuth client by your Gong admin.

  • api:calls:read:basic — list calls and read metadata
  • api:calls:read:extensive — read full call details including parties
  • api:calls:read:transcript — fetch transcripts (required for FastFollow)
  • api:users:read — identify connected user
3

Authorize from FastFollow

In FastFollow → Integrations → Gong → Connect. The first user to connect from a workspace acts as the workspace owner of the integration.

  • Refresh tokens are managed by FastFollow and rotate automatically
  • Once connected, FastFollow registers a call.analyzed webhook subscription via the Gong API
  • No further admin action required after the first connect

Webhook events

What Gong pushes to FastFollow

call.analyzed

Fires when Gong finishes analyzing a call (typically 5–15 minutes after the call ends). FastFollow fetches the full transcript via the Gong API and triggers follow-up generation. Signature verified via the workspace-scoped subscription token.

Troubleshooting

The most common Gong errors

unauthorized_client

Initial OAuth handshake fails.

Fix: The Gong OAuth client has not been approved by Gong support. New OAuth clients require activation — contact your Gong CSM if you cannot complete the auth flow.

forbidden (transcripts)

Calls list correctly but transcript fetch fails with 403.

Fix: The api:calls:read:transcript scope was not granted. Have your Gong Technical Admin add it to the OAuth client, then reconnect from FastFollow.

webhook_subscription_failed

Connection completes but no call.analyzed events arrive.

Fix: FastFollow tries to register the webhook automatically but it can fail if the workspace already has a conflicting subscription. Check FastFollow → /admin/health → Gong subscriptions, and resubscribe manually if needed.

rate_limit

Bulk historical backfill returns 429.

Fix: Gong rate-limits at 3 requests/second per OAuth client. FastFollow honors Retry-After. For large workspaces, schedule the initial sync during off-hours.

Still stuck? Contact support