Gong Automation
セールスコールのインサイトを引き出します――文字起こしの取得、日付範囲によるコールデータ分析、トピックやトラッカーを含む詳細な会話分析、ワークスペース管理を、すべて自然言語コマンドで実行できます。
ツールキットドキュメント: composio.dev/toolkits/gong
セットアップ
- Composio MCPサーバーをクライアント設定に追加します:
https://rube.app/mcp - プロンプトに従い、Gongアカウントを接続します（OAuth / Bearerトークン認証）。
- 自然言語コマンドを発行して、コールデータを分析します。
コアワークフロー
1. 日付範囲でコールの文字起こしを取得
指定した期間内の全コールの文字起こしを取得します。特定のコールIDやワークスペースでフィルタリングすることも可能です。
ツール: GONG_RETRIEVE_TRANSCRIPTS_OF_CALLS_V2_CALLS_TRANSCRIPT
プロンプト例:
「2025年2月1日から10日までのGongの文字起こしを取得して」
主要パラメータ:
filter__fromDateTime-- ISO-8601形式の開始日時（例:2025-02-01T00:00:00Z）filter__toDateTime-- ISO-8601形式の終了日時（例:2025-02-10T23:59:59Z）filter__callIds-- フィルタリングする特定のコールIDの配列（オプション）filter__workspaceId-- ワークスペースIDフィルター（オプション）cursor-- 前回のレスポンスからのページネーションカーソル
必要なスコープ: api:calls:read:transcript
2. 特定コールの文字起こしを取得
フィルターオブジェクトを使用して、スピーカー情報、タイムスタンプ、トピック分類を含む文字起こしを取得します。
ツール: GONG_GET_CALL_TRANSCRIPT
プロンプト例:
「コールID 555785916001072125のGong文字起こしを取得して」
主要パラメータ（filter必須）:
filter.callIds-- 特定のコールIDの配列（例:["555785916001072125"]）filter.fromDateTime-- ISO-8601形式の開始日時filter.toDateTime-- ISO-8601形式の終了日時filter.workspaceId-- ワークスペースフィルター（オプション）cursor-- ページネーションカーソル
3. 日付範囲でコールを一覧表示
日付範囲内のコールの基本メタデータ（参加者、時間、時刻）を取得します。
ツール: GONG_RETRIEVE_CALL_DATA_BY_DATE_RANGE_V2_CALLS
プロンプト例:
「先週のGongコールをすべてリストして」
主要パラメータ（両方必須）:
fromDateTime-- ISO-8601形式の開始日時（例:2025-02-03T00:00:00Z）toDateTime-- ISO-8601形式の終了日時（例:2025-02-10T00:00:00Z）workspaceId-- ワークスペースフィルター（オプション）cursor-- ページネーションカーソル
必要なスコープ: api:calls:read:basic
4. 詳細なコール分析を取得
ハイライト、キーポイント、トピック、トラッカー、スピーカー統計、質問、メディアURLなど、広範なコール詳細を取得します。
ツール: GONG_RETRIEVE_FILTERED_CALL_DETAILS
プロンプト例:
「今週のGongコールの詳細分析を取得して。トピック、キーポイント、スピーカー統計を含めて」
主要パラメータ:
filter__fromDateTime/filter__toDateTime-- 日付範囲フィルターfilter__callIds-- 特定のコールIDfilter__primaryUserIds-- コールホストのユーザーIDでフィルター- コンテンツセレクター（すべてブール値）:
contentSelector__exposedFields__content__keyPoints-- コールのキーポイントcontentSelector__exposedFields__content__topics-- トピックの所要時間contentSelector__exposedFields__content__highlights-- コールのハイライトcontentSelector__exposedFields__content__outline-- コールの概要contentSelector__exposedFields__content__brief-- スポットライトコールブリーフcontentSelector__exposedFields__content__callOutcome-- コールの成果contentSelector__exposedFields__content__trackers-- スマート/キーワードトラッカーcontentSelector__exposedFields__content__trackerOccurrences-- トラッカーのタイミングとスピーカー（trackers=trueが必要）contentSelector__exposedFields__interaction__speakers-- 各参加者の発言時間contentSelector__exposedFields__interaction__questions-- 質問数contentSelector__exposedFields__interaction__personInteractionStats-- ホストの統計contentSelector__exposedFields__media-- 音声/動画URL（有効期限8時間）contentSelector__exposedFields__parties-- 関係者情報contentSelector__exposedFields__collaboration__publicComments-- 公開コメント
contentSelector__context-- CRM/外部システムリンク用: "Basic", "Extended", または "None"
必要なスコープ: api:calls:read:extensive（メディアには追加で api:calls:read:media-url が必要）
5. 特定のコールをIDで取得
Gongの一意のIDを使用して、単一コールの基本データを取得します。
ツール: GONG_RETRIEVE_DATA_FOR_A_SPECIFIC_CALL_V2_CALLS_ID
プロンプト例:
「Gongコール1223781272986876929の詳細を取得して」
主要パラメータ（必須）:
id-- Gongが割り当てる一意の数値ID（最大20桁）
必要なスコープ: api:calls:read:basic
6. 会社のワークスペースを一覧表示
Gong組織内のすべてのワークスペースを取得し、フィルタリング用のワークスペースIDを入手します。
ツール: GONG_LIST_ALL_COMPANY_WORKSPACES_V2_WORKSPACES
プロンプト例:
「私の会社のGongワークスペースをすべてリストして」
主要パラメータ: なし。
必要なスコープ: api:workspaces:read
既知の問題点
- ISO-8601日付形式が必須: すべての日付パラメータはタイムゾーンを含むISO-8601形式（例:
2025-02-01T00:00:00Zまたは2025-02-01T02:30:00-07:00）を使用する必要があります。プレーンな日付は失敗します。 - 日付範囲はtoDateTimeで排他的:
toDateTimeパラメータは、指定された時刻**まで（含まず）**のコールを返します。特定の日付のコールを含めるには、toDateTimeを翌日に設定してください。 - 大規模な結果セットにはページネーションが必須: すべての一覧エンドポイントはページ分割された結果を返します。前回のレスポンスの
cursor値を使用して次のページを取得し、カーソルが返されなくなるまで繰り返します。 - エンドポイントごとに必要なスコープが異なる: エンドポイントによって必要なAPIスコープが異なります。文字起こしアクセスには
api:calls:read:transcript、基本コールデータにはapi:calls:read:basic、詳細分析にはapi:calls:read:extensiveが必要です。 - メディアURLは8時間で期限切れ: 詳細コールエンドポイントから返される音声・動画URLは一時的なもので、8時間後に期限切れになります。
- トラッカー発生データの利用可能性: トラッカー発生データ（タイミングとスピーカーID）は、2023年1月1日以降に録音されたコールでのみ利用可能です。それ以前のデータについてはGongサポートに問い合わせてください。
- Web会議コールと通常コール: Gongが録音したWeb会議コールの場合、日付は予定時刻を表します。その他のコールの場合は、実際の開始時刻を表します。
クイックリファレンス
| アクション | ツールスラッグ | 必須パラメータ |
|---|---|---|
| 日付別に文字起こしを取得 | GONG_RETRIEVE_TRANSCRIPTS_OF_CALLS_V2_CALLS_TRANSCRIPT | なし（日付範囲推奨） |
| コール文字起こしを取得 | GONG_GET_CALL_TRANSCRIPT | filter オブジェクト |
| 日付別にコールを一覧表示 | GONG_RETRIEVE_CALL_DATA_BY_DATE_RANGE_V2_CALLS | fromDateTime, toDateTime |
| 詳細なコール分析を取得 | GONG_RETRIEVE_FILTERED_CALL_DETAILS | なし（日付範囲またはコールID推奨） |
| 特定コールを取得 | GONG_RETRIEVE_DATA_FOR_A_SPECIFIC_CALL_V2_CALLS_ID | id |
| ワークスペースを一覧表示 | GONG_LIST_ALL_COMPANY_WORKSPACES_V2_WORKSPACES | なし |
Powered by Composio