wehub-resource-sync
d25d482dc2
CI / Migrate Dev DB (push) Has been skipped
CI / Detect Version (push) Has been cancelled
CI / Migrate DB (push) Has been cancelled
CI / Build Dev ECR (./docker/app.Dockerfile, ECR_APP) (push) Has been cancelled
CI / Build Dev ECR (./docker/db.Dockerfile, ECR_MIGRATIONS) (push) Has been cancelled
CI / Build Dev ECR (./docker/pii.Dockerfile, ECR_PII) (push) Has been cancelled
CI / Build Dev ECR (./docker/realtime.Dockerfile, ECR_REALTIME) (push) Has been cancelled
CI / Deploy Trigger.dev (Dev) (push) Has been cancelled
CI / Build AMD64 (./docker/app.Dockerfile, ECR_APP, ghcr.io/simstudioai/simstudio) (push) Has been cancelled
CI / Build AMD64 (./docker/db.Dockerfile, ECR_MIGRATIONS, ghcr.io/simstudioai/migrations) (push) Has been cancelled
CI / Build AMD64 (./docker/pii.Dockerfile, ECR_PII, ghcr.io/simstudioai/pii) (push) Has been cancelled
CI / Build AMD64 (./docker/realtime.Dockerfile, ECR_REALTIME, ghcr.io/simstudioai/realtime) (push) Has been cancelled
CI / Build ARM64 (GHCR Only) (./docker/app.Dockerfile, ghcr.io/simstudioai/simstudio) (push) Has been cancelled
CI / Build ARM64 (GHCR Only) (./docker/db.Dockerfile, ghcr.io/simstudioai/migrations) (push) Has been cancelled
CI / Build ARM64 (GHCR Only) (./docker/pii.Dockerfile, ghcr.io/simstudioai/pii) (push) Has been cancelled
CI / Build ARM64 (GHCR Only) (./docker/realtime.Dockerfile, ghcr.io/simstudioai/realtime) (push) Has been cancelled
CI / Create GHCR Manifests (ghcr.io/simstudioai/migrations) (push) Has been cancelled
CI / Create GHCR Manifests (ghcr.io/simstudioai/pii) (push) Has been cancelled
CI / Create GHCR Manifests (ghcr.io/simstudioai/realtime) (push) Has been cancelled
CI / Create GHCR Manifests (ghcr.io/simstudioai/simstudio) (push) Has been cancelled
CI / Check Docs Changes (push) Has been cancelled
CI / Process Docs (push) Has been cancelled
CI / Create GitHub Release (push) Has been cancelled
CI / Test and Build (push) Has been cancelled
Publish CLI Package / publish-npm (push) Has been cancelled
Publish Python SDK / publish-pypi (push) Has been cancelled
Publish TypeScript SDK / publish-npm (push) Has been cancelled
447 lines
17 KiB
TypeScript
447 lines
17 KiB
TypeScript
import type { GongGetExtensiveCallsParams, GongGetExtensiveCallsResponse } from '@/tools/gong/types'
|
|
import { getGongErrorMessage, parseGongIdList } from '@/tools/gong/utils'
|
|
import type { ToolConfig } from '@/tools/types'
|
|
|
|
export const getExtensiveCallsTool: ToolConfig<
|
|
GongGetExtensiveCallsParams,
|
|
GongGetExtensiveCallsResponse
|
|
> = {
|
|
id: 'gong_get_extensive_calls',
|
|
name: 'Gong Get Extensive Calls',
|
|
description:
|
|
'Retrieve detailed call data including trackers, topics, highlights, and AI spotlight content (brief, outline, key points, call outcome) from Gong.',
|
|
version: '1.0.0',
|
|
|
|
params: {
|
|
accessKey: {
|
|
type: 'string',
|
|
required: true,
|
|
visibility: 'user-only',
|
|
description: 'Gong API Access Key',
|
|
},
|
|
accessKeySecret: {
|
|
type: 'string',
|
|
required: true,
|
|
visibility: 'user-only',
|
|
description: 'Gong API Access Key Secret',
|
|
},
|
|
callIds: {
|
|
type: 'string',
|
|
required: false,
|
|
visibility: 'user-or-llm',
|
|
description: 'Comma-separated list of call IDs to retrieve detailed data for',
|
|
},
|
|
fromDateTime: {
|
|
type: 'string',
|
|
required: false,
|
|
visibility: 'user-or-llm',
|
|
description: 'Start date/time filter in ISO-8601 format',
|
|
},
|
|
toDateTime: {
|
|
type: 'string',
|
|
required: false,
|
|
visibility: 'user-or-llm',
|
|
description: 'End date/time filter in ISO-8601 format',
|
|
},
|
|
workspaceId: {
|
|
type: 'string',
|
|
required: false,
|
|
visibility: 'user-or-llm',
|
|
description: 'Gong workspace ID to filter calls',
|
|
},
|
|
primaryUserIds: {
|
|
type: 'string',
|
|
required: false,
|
|
visibility: 'user-or-llm',
|
|
description: 'Comma-separated list of user IDs to filter calls by host',
|
|
},
|
|
cursor: {
|
|
type: 'string',
|
|
required: false,
|
|
visibility: 'user-or-llm',
|
|
description: 'Pagination cursor from a previous response',
|
|
},
|
|
},
|
|
|
|
request: {
|
|
url: 'https://api.gong.io/v2/calls/extensive',
|
|
method: 'POST',
|
|
headers: (params) => ({
|
|
'Content-Type': 'application/json',
|
|
Authorization: `Basic ${btoa(`${params.accessKey}:${params.accessKeySecret}`)}`,
|
|
}),
|
|
body: (params) => {
|
|
const filter: Record<string, unknown> = {}
|
|
const callIds = parseGongIdList(params.callIds)
|
|
const primaryUserIds = parseGongIdList(params.primaryUserIds)
|
|
if (callIds) filter.callIds = callIds
|
|
if (params.fromDateTime?.trim()) filter.fromDateTime = params.fromDateTime.trim()
|
|
if (params.toDateTime?.trim()) filter.toDateTime = params.toDateTime.trim()
|
|
if (params.workspaceId?.trim()) filter.workspaceId = params.workspaceId.trim()
|
|
if (primaryUserIds) filter.primaryUserIds = primaryUserIds
|
|
const body: Record<string, unknown> = {
|
|
filter,
|
|
contentSelector: {
|
|
context: 'Extended',
|
|
contextTiming: ['Now', 'TimeOfCall'],
|
|
exposedFields: {
|
|
parties: true,
|
|
content: {
|
|
structure: true,
|
|
topics: true,
|
|
trackers: true,
|
|
trackerOccurrences: true,
|
|
highlights: true,
|
|
brief: true,
|
|
outline: true,
|
|
keyPoints: true,
|
|
callOutcome: true,
|
|
},
|
|
collaboration: { publicComments: true },
|
|
interaction: {
|
|
personInteractionStats: true,
|
|
speakers: true,
|
|
video: true,
|
|
questions: true,
|
|
},
|
|
media: true,
|
|
},
|
|
},
|
|
}
|
|
if (params.cursor?.trim()) body.cursor = params.cursor.trim()
|
|
return body
|
|
},
|
|
},
|
|
|
|
transformResponse: async (response: Response) => {
|
|
const data = await response.json()
|
|
if (!response.ok) {
|
|
throw new Error(getGongErrorMessage(data, 'Failed to get extensive call data'))
|
|
}
|
|
return {
|
|
success: true,
|
|
output: {
|
|
calls: data.calls ?? [],
|
|
cursor: data.records?.cursor ?? null,
|
|
},
|
|
}
|
|
},
|
|
|
|
outputs: {
|
|
calls: {
|
|
type: 'array',
|
|
description:
|
|
'List of detailed call objects with metadata, content, interaction stats, and collaboration data',
|
|
items: {
|
|
type: 'object',
|
|
properties: {
|
|
metaData: {
|
|
type: 'object',
|
|
description: 'Call metadata (same fields as CallBasicData)',
|
|
properties: {
|
|
id: { type: 'string', description: 'Call ID' },
|
|
title: { type: 'string', description: 'Call title' },
|
|
scheduled: { type: 'string', description: 'Scheduled time in ISO-8601' },
|
|
started: { type: 'string', description: 'Start time in ISO-8601' },
|
|
duration: { type: 'number', description: 'Duration in seconds' },
|
|
direction: { type: 'string', description: 'Call direction' },
|
|
system: { type: 'string', description: 'Communication platform' },
|
|
scope: { type: 'string', description: 'Internal/External/Unknown' },
|
|
media: { type: 'string', description: 'Media type' },
|
|
language: { type: 'string', description: 'Language code (ISO-639-2B)' },
|
|
url: { type: 'string', description: 'Gong web app URL' },
|
|
primaryUserId: { type: 'string', description: 'Host user ID' },
|
|
workspaceId: { type: 'string', description: 'Workspace ID' },
|
|
sdrDisposition: { type: 'string', description: 'SDR disposition' },
|
|
clientUniqueId: { type: 'string', description: 'Origin system call ID' },
|
|
customData: { type: 'string', description: 'Custom metadata' },
|
|
purpose: { type: 'string', description: 'Call purpose' },
|
|
meetingUrl: { type: 'string', description: 'Meeting URL' },
|
|
isPrivate: { type: 'boolean', description: 'Whether call is private' },
|
|
calendarEventId: { type: 'string', description: 'Calendar event ID' },
|
|
},
|
|
},
|
|
context: {
|
|
type: 'array',
|
|
description: 'Links to external systems (CRM, Dialer, etc.)',
|
|
items: {
|
|
type: 'object',
|
|
properties: {
|
|
system: { type: 'string', description: 'External system name (e.g., Salesforce)' },
|
|
objects: {
|
|
type: 'array',
|
|
description: 'List of objects within the external system',
|
|
},
|
|
},
|
|
},
|
|
},
|
|
parties: {
|
|
type: 'array',
|
|
description: 'List of call participants',
|
|
items: {
|
|
type: 'object',
|
|
properties: {
|
|
id: { type: 'string', description: 'Unique participant ID in the call' },
|
|
name: { type: 'string', description: 'Participant name' },
|
|
emailAddress: { type: 'string', description: 'Email address' },
|
|
title: { type: 'string', description: 'Job title' },
|
|
phoneNumber: { type: 'string', description: 'Phone number' },
|
|
speakerId: {
|
|
type: 'string',
|
|
description: 'Speaker ID for transcript cross-reference',
|
|
},
|
|
userId: { type: 'string', description: 'Gong user ID' },
|
|
affiliation: { type: 'string', description: 'Company or non-company' },
|
|
methods: { type: 'array', description: 'Whether invited or attended' },
|
|
context: { type: 'array', description: 'Links to external systems for this party' },
|
|
},
|
|
},
|
|
},
|
|
content: {
|
|
type: 'object',
|
|
description: 'Call content data',
|
|
properties: {
|
|
brief: {
|
|
type: 'string',
|
|
description: 'AI-generated brief summary of the call (Call Spotlight)',
|
|
},
|
|
outline: {
|
|
type: 'array',
|
|
description: 'AI-generated call outline sections',
|
|
items: {
|
|
type: 'object',
|
|
properties: {
|
|
section: { type: 'string', description: 'Outline section name' },
|
|
startTime: {
|
|
type: 'number',
|
|
description: 'Section start in seconds from call start',
|
|
},
|
|
duration: { type: 'number', description: 'Section duration in seconds' },
|
|
items: { type: 'array', description: 'Bullet items within the section' },
|
|
},
|
|
},
|
|
},
|
|
keyPoints: {
|
|
type: 'array',
|
|
description: 'AI-generated key points of the call',
|
|
items: {
|
|
type: 'object',
|
|
properties: {
|
|
text: { type: 'string', description: 'Key point text' },
|
|
},
|
|
},
|
|
},
|
|
callOutcome: {
|
|
type: 'object',
|
|
description: 'AI-determined call outcome (Call Spotlight)',
|
|
properties: {
|
|
id: { type: 'string', description: 'Outcome category ID' },
|
|
category: { type: 'string', description: 'Outcome category name' },
|
|
name: { type: 'string', description: 'Outcome name' },
|
|
},
|
|
},
|
|
structure: {
|
|
type: 'array',
|
|
description: 'Call agenda parts',
|
|
items: {
|
|
type: 'object',
|
|
properties: {
|
|
name: { type: 'string', description: 'Agenda name' },
|
|
duration: { type: 'number', description: 'Duration of this part in seconds' },
|
|
},
|
|
},
|
|
},
|
|
topics: {
|
|
type: 'array',
|
|
description: 'Topics and their durations',
|
|
items: {
|
|
type: 'object',
|
|
properties: {
|
|
name: { type: 'string', description: 'Topic name (e.g., Pricing)' },
|
|
duration: { type: 'number', description: 'Time spent on topic in seconds' },
|
|
},
|
|
},
|
|
},
|
|
trackers: {
|
|
type: 'array',
|
|
description: 'Trackers found in the call',
|
|
items: {
|
|
type: 'object',
|
|
properties: {
|
|
id: { type: 'string', description: 'Tracker ID' },
|
|
name: { type: 'string', description: 'Tracker name' },
|
|
count: { type: 'number', description: 'Number of occurrences' },
|
|
type: { type: 'string', description: 'Keyword or Smart' },
|
|
occurrences: {
|
|
type: 'array',
|
|
description: 'Details for each occurrence',
|
|
items: {
|
|
type: 'object',
|
|
properties: {
|
|
speakerId: { type: 'string', description: 'Speaker who said it' },
|
|
startTime: { type: 'number', description: 'Seconds from call start' },
|
|
},
|
|
},
|
|
},
|
|
phrases: {
|
|
type: 'array',
|
|
description: 'Per-phrase occurrence counts',
|
|
items: {
|
|
type: 'object',
|
|
properties: {
|
|
phrase: { type: 'string', description: 'Specific phrase' },
|
|
count: { type: 'number', description: 'Occurrences of this phrase' },
|
|
occurrences: { type: 'array', description: 'Details per occurrence' },
|
|
},
|
|
},
|
|
},
|
|
},
|
|
},
|
|
},
|
|
highlights: {
|
|
type: 'array',
|
|
description:
|
|
'AI-generated highlights including next steps, action items, and key moments',
|
|
items: {
|
|
type: 'object',
|
|
properties: {
|
|
title: { type: 'string', description: 'Title of the highlight' },
|
|
items: {
|
|
type: 'array',
|
|
description: 'Individual highlight items',
|
|
items: {
|
|
type: 'object',
|
|
properties: {
|
|
text: { type: 'string', description: 'Text of the highlight item' },
|
|
startTimes: {
|
|
type: 'array',
|
|
description: 'Start times in seconds from call start',
|
|
},
|
|
},
|
|
},
|
|
},
|
|
},
|
|
},
|
|
},
|
|
},
|
|
},
|
|
interaction: {
|
|
type: 'object',
|
|
description: 'Interaction statistics',
|
|
properties: {
|
|
interactionStats: {
|
|
type: 'array',
|
|
description: 'Interaction stats per user',
|
|
items: {
|
|
type: 'object',
|
|
properties: {
|
|
userId: { type: 'string', description: 'Gong user ID' },
|
|
userEmailAddress: { type: 'string', description: 'User email' },
|
|
personInteractionStats: {
|
|
type: 'array',
|
|
description: 'Stats list (Longest Monologue, Interactivity, Patience, etc.)',
|
|
items: {
|
|
type: 'object',
|
|
properties: {
|
|
name: { type: 'string', description: 'Stat name' },
|
|
value: { type: 'number', description: 'Stat value' },
|
|
},
|
|
},
|
|
},
|
|
},
|
|
},
|
|
},
|
|
speakers: {
|
|
type: 'array',
|
|
description: 'Talk duration per speaker',
|
|
items: {
|
|
type: 'object',
|
|
properties: {
|
|
id: { type: 'string', description: 'Participant ID' },
|
|
userId: { type: 'string', description: 'Gong user ID' },
|
|
talkTime: { type: 'number', description: 'Talk duration in seconds' },
|
|
},
|
|
},
|
|
},
|
|
video: {
|
|
type: 'array',
|
|
description: 'Video statistics',
|
|
items: {
|
|
type: 'object',
|
|
properties: {
|
|
name: {
|
|
type: 'string',
|
|
description:
|
|
'Segment type: Browser, Presentation, WebcamPrimaryUser, WebcamNonCompany, Webcam',
|
|
},
|
|
duration: { type: 'number', description: 'Total segment duration in seconds' },
|
|
},
|
|
},
|
|
},
|
|
questions: {
|
|
type: 'object',
|
|
description: 'Question counts',
|
|
properties: {
|
|
companyCount: { type: 'number', description: 'Questions by company speakers' },
|
|
nonCompanyCount: {
|
|
type: 'number',
|
|
description: 'Questions by non-company speakers',
|
|
},
|
|
},
|
|
},
|
|
},
|
|
},
|
|
collaboration: {
|
|
type: 'object',
|
|
description: 'Collaboration data',
|
|
properties: {
|
|
publicComments: {
|
|
type: 'array',
|
|
description: 'Public comments on the call',
|
|
items: {
|
|
type: 'object',
|
|
properties: {
|
|
id: { type: 'string', description: 'Comment ID' },
|
|
commenterUserId: { type: 'string', description: 'Commenter user ID' },
|
|
comment: { type: 'string', description: 'Comment text' },
|
|
posted: { type: 'string', description: 'Posted time in ISO-8601' },
|
|
audioStartTime: {
|
|
type: 'number',
|
|
description: 'Seconds from call start the comment refers to',
|
|
},
|
|
audioEndTime: {
|
|
type: 'number',
|
|
description: 'Seconds from call start the comment end refers to',
|
|
},
|
|
duringCall: {
|
|
type: 'boolean',
|
|
description: 'Whether the comment was posted during the call',
|
|
},
|
|
inReplyTo: {
|
|
type: 'string',
|
|
description: 'ID of original comment if this is a reply',
|
|
},
|
|
},
|
|
},
|
|
},
|
|
},
|
|
},
|
|
media: {
|
|
type: 'object',
|
|
description: 'Media download URLs (available for 8 hours)',
|
|
properties: {
|
|
audioUrl: { type: 'string', description: 'Audio download URL' },
|
|
videoUrl: { type: 'string', description: 'Video download URL' },
|
|
},
|
|
},
|
|
},
|
|
},
|
|
},
|
|
cursor: {
|
|
type: 'string',
|
|
description: 'Pagination cursor for the next page',
|
|
optional: true,
|
|
},
|
|
},
|
|
}
|