gong

name	gong
description	Gong sales intelligence API integration with managed OAuth. Retrieve call recordings and transcripts, analyze sales conversations, manage CRM integrations, track coaching metrics, and report engagement events. Use this skill when users want to analyze sales calls, retrieve call transcripts, manage Gong Engage flows, or track team activity statistics.

Gong

Access sales conversation intelligence from chat -- retrieve call transcripts, analyze team performance, manage CRM integrations, track coaching metrics, and report engagement events. Powered by ClawLink for hosted OAuth.

Setup in 3 Steps

Step 1: Install	Step 2: Pair Account	Step 3: Connect Gong
		App-specific connection GIF coming soon
Run the install command in OpenClaw	Sign in and approve the device	Open the dashboard and connect Gong

How It Works

┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐
│   OpenClaw      │────▶│   ClawLink   │────▶│   Gong API       │
│   (User Chat)   │     │   (OAuth)    │     │                  │
└─────────────────┘     └──────────────┘     └──────────────────┘

Install

openclaw plugins install clawhub:clawlink-plugin
openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
openclaw gateway restart

Quick Start

// 1. List recent calls
clawlink_call_tool({ tool: "gong_retrieve_call_data_by_date_range_v2_calls", parameters: { fromDateTime: "2026-06-01T00:00:00Z", toDateTime: "2026-06-08T23:59:59Z" } })

// 2. Get a call transcript
clawlink_call_tool({ tool: "gong_get_call_transcript", parameters: { callId: "call_123" } })

// 3. List users
clawlink_call_tool({ tool: "gong_list_all_users_v2_users", parameters: {} })

Authentication

ClawLink handles OAuth with Gong. No API keys needed. Connect at claw-link.dev/dashboard?add=gong. Different endpoints require specific API scopes.

Connection Management

// List connections
clawlink_list_integrations()

// Verify by listing users
clawlink_call_tool({ tool: "gong_list_all_users_v2_users", parameters: {} })

Security & Permissions

• Read tools are safe and require no confirmation
• Write tools require confirmation before execution
• Data erasure and CRM deletion are high-impact and irreversible
• Many endpoints require specific Bearer token scopes

Tool Reference

Call Operations

Tool	Description	Mode
gong_retrieve_call_data_by_date_range_v2_calls	List calls in a date range	Read
gong_retrieve_filtered_call_details	Get detailed call data with media URLs	Read
gong_get_call_by_id	Get specific call metadata by ID	Read
gong_get_call_transcript	Retrieve call transcripts with speaker info	Read
gong_retrieve_manual_crm_call_associations	List manually associated CRM calls	Read
gong_add_new_call_v2_calls	Register a new call recording	Write
gong_add_call_media_v2_calls_id_media	Upload media for a call	Write

Conversation & Meetings

Tool	Description	Mode
gong_delete_meeting	Delete a Gong meeting by ID	Write
gong_create_a_new_gong_meeting_v2_meetings	Create a new Gong meeting	Write
gong_update_a_gong_meeting_v2_meetings_meeting_id	Update a Gong meeting	Write
gong_validate_meeting_integration	Check meeting integration status for users	Read

Statistics & Analytics

Tool	Description	Mode
gong_aggregate_user_activity_statistics	Get user activity stats for a period	Read
gong_aggregate_activity_by_period_via_api	Get aggregated activity per time period	Read
gong_post_day_by_day_activity_stats	Get daily activity breakdown per user	Read
gong_get_interaction_statistics	Get interaction trend stats (Whisper calls)	Read
gong_list_call_outcomes	List all configured call outcomes	Read
gong_create_activity_scorecards_report	Get scorecard answers for a date range	Read
gong_list_scorecards	List all scorecards and assessment questions	Read

Users & Settings

Tool	Description	Mode
gong_list_all_users_v2_users	List all company users	Read
gong_list_users_by_filter_v2_users_extensive	List users with filtering	Read
gong_get_user_by_id	Get user details by ID	Read
gong_get_user_settings_history	Get historical setting changes for a user	Read
gong_list_all_company_workspaces_v2_workspaces	List all workspaces	Read
gong_retrieve_tracker_details_v2_settings_trackers	List keyword tracker configurations	Read

Gong Engage Flows

Tool	Description	Mode
gong_list_gong_engage_flows_v2_flows	List Engage flows (company, personal, shared)	Read
gong_list_flow_folders	List flow folders with visibility types	Read
gong_assign_prospects_to_flow	Assign up to 200 prospects to a flow	Write
gong_unassign_flows_by_crm_id	Remove prospects from flows	Write
gong_get_flow_prospects	Get flow assignments for specific prospects	Read

Task Management

Tool	Description	Mode
gong_list_tasks	List Engage tasks with status/action filtering	Read

CRM Integration

Tool	Description	Mode
gong_get_crm_integration_details	Get generic CRM integration details	Read
gong_register_crm_integration	Update CRM integration metadata	Write
gong_delete_a_generic_crm_integration_v2_crm_integrations	Delete a generic CRM integration	Write
gong_list_schema_fields_v2_crm_entity_schema	Get CRM object type schema fields	Read
gong_get_crm_objects_v2_crm_entities	Fetch CRM objects by ID	Read
gong_upload_crm_objects_v2_crm_entities	Upload CRM entities via LDJSON (max 200MB)	Write
gong_get_request_status_v2_crm_request_status	Check CRM request processing status	Read

Engagement Events

Tool	Description	Mode
gong_report_custom_engagement_event	Log custom engagement events to timeline	Write
gong_report_content_share_event	Log content share events	Write
gong_report_content_view_event	Log content view events	Write
gong_post_a_digital_interaction_v2_digital_interaction	Record a digital interaction	Write

Permissions

Tool	Description	Mode
gong_fetch_all_permission_profiles	List all permission profiles	Read
gong_get_permission_profile	Get a specific permission profile	Read
gong_create_permission_profile_v2_permission_profile	Create a permission profile	Write
gong_update_permission_profile_v2_permission_profile	Update a permission profile	Write
gong_retrieve_users_from_permission_profile	List users in a permission profile	Read
gong_manage_user_call_access	List users with API-granted call access	Read
gong_set_user_call_access	Grant users access to specific calls	Write
gong_delete_users_from_call_access_list	Remove user call access	Write

Data Privacy

Tool	Description	Mode
gong_retrieve_data_privacy_info_for_email_address	Show data referencing an email address	Read
gong_data_privacy_for_phone_number	Show data referencing a phone number	Read
gong_erase_data_for_email_address	GDPR erase all data for an email	Write
gong_erase_data_for_phone_number	GDPR erase all data for a phone number	Write

Library & Auditing

Tool	Description	Mode
gong_retrieve_library_folders_v2_library_folders	List public library folders	Read
gong_list_folder_calls	List calls in a library folder	Read
gong_retrieve_logs_data_by_type_and_time_range_v2_logs	List audit log entries	Read

Coaching

Tool	Description	Mode
gong_list_all_coaching_metrics_v2_coaching	List coaching metrics for a manager	Read

Code Examples

Example 1: Retrieve and analyze calls

// List calls for this week
const calls = await clawlink_call_tool({
  tool: "gong_retrieve_call_data_by_date_range_v2_calls",
  parameters: {
    fromDateTime: "2026-06-01T00:00:00Z",
    toDateTime: "2026-06-08T23:59:59Z"
  }
});

// Get transcript for a specific call
const transcript = await clawlink_call_tool({
  tool: "gong_get_call_transcript",
  parameters: { callId: "call_abc123" }
});

Example 2: Team activity and stats

// Get user activity statistics
const stats = await clawlink_call_tool({
  tool: "gong_aggregate_user_activity_statistics",
  parameters: {
    fromDateTime: "2026-06-01T00:00:00Z",
    toDateTime: "2026-06-08T23:59:59Z"
  }
});

// Get daily breakdown
const daily = await clawlink_call_tool({
  tool: "gong_post_day_by_day_activity_stats",
  parameters: {
    fromDateTime: "2026-06-01T00:00:00Z",
    toDateTime: "2026-06-08T23:59:59Z"
  }
});

Example 3: Report engagement events

await clawlink_call_tool({
  tool: "gong_report_custom_engagement_event",
  parameters: {
    reportingSystem: "CRM",
    eventTimestamp: "2026-06-08T14:30:00Z",
    actor: { email: "[e-mail]", name: "Jane Doe" },
    action: "document_viewed",
    title: "Proposal Viewed"
  }
});

Discovery Workflow

1. Call clawlink_list_integrations to confirm gong is connected.
2. Call clawlink_list_tools --integration gong to see the live catalog.
3. Use clawlink_search_tools({ query: "transcript", integration: "gong" }) to find specific tools.

Execution Workflow

READ (safe):     retrieve_calls → get_call_transcript → list_users → aggregate_stats
WRITE (confirm): assign_prospects → report_engagement → create_permission_profile
DELETE (high):   delete_meeting → erase_data_for_email → delete_crm_integration

Notes

• Many endpoints require specific Bearer token scopes (e.g., api:calls:read:basic, api:stats:user-actions)
• CRM integration tools only work with generic CRM integrations, not native Salesforce/HubSpot
• Data erasure is not immediate -- may take several hours to complete
• Gong allows only one active CRM integration at a time

Error Handling

Status / Error	Meaning
401 Unauthorized	OAuth token expired -- reconnect at dashboard
403 Forbidden	Missing required API scope
404 Not Found	Call, user, or resource ID does not exist
429 Rate Limited	API quota exceeded -- apply exponential backoff
500 Internal Error	ACL PATCH may fail -- tool auto-falls back to UPDATE

Troubleshooting

Tools Not Visible

• Start a fresh OpenClaw chat to reload plugin catalog
• Call clawlink_list_integrations to confirm pairing

Scope Errors

• Check required scopes for the specific endpoint
• Reconnect with additional scopes if needed
• Use validate_meeting_integration to diagnose meeting capture issues

Resources

• Gong API Docs: https://app.gong.io/settings/api/documentation
• ClawLink: https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=gong
• ClawLink Docs: https://docs.claw-link.dev/openclaw

---

Powered by ClawLink -- an integration hub for OpenClaw