Gongをデータパイプラインソースとして設定する ​

Gongをデータパイプラインソースとして設定し、Gongから通話、スコアカード、ユーザー、ワークスペースのデータを抽出して宛先に同期します。このガイドでは、Gongへの接続、パイプラインの設定、サポートされるオブジェクト、同期モード、スキーマ処理、機密データの処理、制限事項について説明します。

サポートされている機能 ​

Gongをパイプラインソースとして使用する場合、次の機能がサポートされます:

• クラウド接続: 顧客固有かつリージョン範囲のベースURLを使用して、https経由でGong API v2に接続します。
• OAuth 2.0認証: Authorization Code Grantを使用して認証し、Workato Gongワークフローコネクターと同じGong OAuthインフラストラクチャを再利用します。
• フル同期と差分同期: 差分同期機能はオブジェクトごとに固定されています。詳細については、同期モードを参照してください。
• オブジェクトレベルの選択: パイプラインに含めるサポート対象のGongオブジェクトを選択します。
• 削除追跡: 参照オブジェクトでは、削除されたレコードにフラグが付けられます。詳細については、削除追跡を参照してください。
• スキーマドリフト処理: ソースで新しく追加されたフィールドを自動同期するかブロックするかを選択します。
• フィールドレベルのデータ保護: 参加者名、メールアドレス、電話番号などの機密フィールドを、宛先に同期する前にハッシュ化します。
• 設定可能な同期頻度: 時間ベースまたはcronベースのスケジュールで同期をスケジュールします。

前提条件 ​

Gongをデータパイプラインソースとして接続する前に、次の要件を満たしてください。

• APIアクセスが有効なGongアカウント
• Gong Admin Centerで作成されたOAuth 2.0インテグレーション。クライアントIDとクライアントシークレットを提供します。設定手順については、Gongへの接続を参照してください。
• Gong APIベースURL。ベースURLはGongワークスペースのリージョンに固有です。例: https://us-XXXXX.api.gong.ioまたはhttps://eu1.api.gong.io。

推奨権限 ​

対応するGongオブジェクトを同期するには、次のOAuthスコープを付与します:

api:calls:read:media-urlは、api:calls:read:extensiveに加えて、extensive_calls内の音声および動画録画URLへのアクセス権を付与します。 Gongはapi:stats:interactionスコープとapi:stats:user-actions:detailedスコープも公開しています。このパイプラインではどちらも不要です。

サポートされるコネクションタイプ ​

Gongデータパイプラインでは、1つの認証方法がサポートされます:

• OAuth 2.0（Authorization Code Grant）: Gongユーザーアカウントでサインインし、Workatoを認可します。設定手順については、Gongへの接続を参照してください。

Gongに接続する ​

Gongに接続するには、次の手順を実行します:

パイプラインの設定 ​

Gongをデータパイプラインソースとして設定するには、次の手順を実行します:

[minute] [hour] [day of month] [month] [day of week]

0 8 * * *

サポートされるオブジェクト ​

Gongデータパイプラインは、Gong API v2 RESTリソースからデータを同期します。次の表は、サポートされているオブジェクトをカテゴリ別に示しています。各オブジェクトは、宛先内の個別のテーブルとして同期されます。

通話 ​

call_partiesは各通話の参加者を、通話ごと、参加者ごとに1行へフラット化するため、JSONを解析しなくても、宛先で参加者数や発話時間のパターンを直接クエリできます。 call_transcriptsは、選択するとデフォルトで有効になります。オブジェクトを追加しないか、選択を解除してオプトアウトします。詳細については、通話トランスクリプトによるストレージ容量の増加を参照してください。 manual_callsには、GongのシステムフィールドがUploaded Callである通話が含まれます。これらのレコードはcallsにも含まれます。

通話コンテンツ分析 ​

次のオブジェクトはextensive_callsから派生し、データを返すにはGongのAI搭載通話分析機能が必要です。各オブジェクトはextensive_callsとは独立して選択および同期します:

各オブジェクトが依存する具体的な機能については、Gongサブスクリプション階層の要件を参照してください。

スコアカード ​

scorecardsには、コーチングスコアカードテンプレートが含まれます。 answered_scorecardsには、完了したスコアカードレビューが含まれ、GongのCoaching機能が必要です。

ユーザーとアクティビティ ​

ワークスペースと設定 ​

trackersにはGongキーワードトラッカーの定義が含まれ、GongのSmart Trackers機能が必要です。

ライブラリ ​

library_folder_contentでは、各同期でフォルダIDを列挙するためにlibrary_foldersが必要です。

同期モード ​

Gongデータパイプラインでは、フル同期と差分同期がサポートされます。オブジェクトが差分同期をサポートするかどうかは、オブジェクトごとに固定されています。

フル同期 ​

フル同期では、実行ごとにオブジェクトで使用可能なすべてのレコードを抽出します。 Gongがオブジェクトの最終更新タイムスタンプを公開しない場合、そのオブジェクトはデフォルトでフル同期になります。これは、前回の同期以降にどのレコードが変更されたかをパイプラインが特定できないためです。

増分同期 ​

増分同期では、最後に成功した実行以降に変更されたレコードのみを抽出します。

• calls、extensive_calls、manual_calls、call_parties、call_transcripts、call_topics、call_tracker_occurrences、call_interaction_stats、call_key_points、call_highlights、call_outline: Workatoは、各通話のstartedタイムスタンプを差分カーソルとして使用します。
• answered_scorecards: Workatoは、スコアカードのレビュー日を差分カーソルとして使用します。
• user_activity_stats: Workatoは、要求されたアクティビティ日付範囲を差分カーソルとして使用します。
• ルックバックウィンドウ: Gongは、通話が終了してから数時間後または数日後に、サードパーティの通話システムから通話録音を取り込む場合があります。各差分同期では、新しいウィンドウに加えて直近24時間分のデータを再読み取りし、これらの遅れて到着する録音を取得します。

各オブジェクトの同期モードを確認するには、サポートされるオブジェクトの表を参照してください。

削除追跡 ​

削除の追跡はオブジェクトごとに行われ、同期モードに従います。

• users、scorecards、workspaces、trackersははい（ソフト）としてマークされます。Gongのコネクターは、現在のレコードIDリストを前回の同期と比較し、表示されなくなったIDに対して、trueに設定された_workato_is_deleted列でフラグを付けます。詳細については、合成列を参照してください。
• library_foldersとlibrary_folder_contentははい（宛先で推測）としてマークされます。コネクターがこれら2つのオブジェクトに_workato_is_deleted列を追加しなくても、宛先はフル同期スナップショットの差分を取ることで削除を検出します。
• callsとその関連オブジェクトを含むすべての差分オブジェクトは、いいえとしてマークされます。理由については、削除された通話が宛先に残るを参照してください。

スキーマとデータ型の処理 ​

Gongデータパイプラインは、ソースデータを宛先スキーマにマッピングする際に次のルールを適用します。

ネストされたデータと配列データ ​

Gongは、通話ベースのオブジェクトに対して、リッチでネストされたデータを返します。 Workatoは、このネストされたデータの大部分を単一列のJSON文字列として保存します:

• JSON文字列列として保持されるextensive_callsセクションには、content.brief、content.structure、content.callOutcome、collaboration、およびcall_interaction_statsでカバーされないinteractionの部分（interaction.questionsなど）が含まれます。

通話参加者、通話トランスクリプト、6つの通話コンテンツ分析オブジェクトは例外です。 Workatoは、これらをJSONとして保持するのではなく、それぞれ独自のテーブルにフラット化します。これには、call_parties（通話ごと、参加者ごとに1行）、call_transcripts（トランスクリプト文ごとに1行。通話ID、話者、トピック、ミリ秒単位の開始時刻と終了時刻、文のテキストを含む）、call_topics、call_tracker_occurrences、call_interaction_stats（話者ごとに1行）、call_key_points、call_highlights、call_outlineが含まれます。

カスタムフィールドと可変フィールド ​

Gongは、構造が固定されていない2つのフィールドを公開します:

• calls.customDataとextensive_calls.metaData.customDataは、一部の顧客がサードパーティの通話システムを通じて入力する自由記述テキスト文字列です。これらはプレーン文字列列として同期されます。
• extensive_callsの参加者には、SalesforceアカウントやHubSpot商談などのCRMレコードへのリンクを含むcontextフィールドが含まれる場合があります。この構造はGongに接続しているCRMによって異なるため、WorkatoはこれをJSON文字列列として保存します。

タイムスタンプ ​

Gongのタイムスタンプは、ISO 8601のタイムゾーン付きタイムスタンプ値として同期されます。 Workatoは、Gongが返すオフセットを保持します。これはUTCまたは別のタイムゾーンオフセットの場合があります。

合成列 ​

Workatoは、ソフト削除追跡を持つオブジェクトの宛先テーブルに、次の合成列を追加します:

機密データの処理 ​

Gongオブジェクトには、個人を特定できる情報（PII）および会話の逐語的な内容が含まれる場合があります。次のオブジェクトには、機密データが含まれることがよくあります。

call_transcriptsには逐語的なトランスクリプトテキストが含まれており、このコネクターで同期される最も機密性の高いデータです。一部の法域では、通話の録音と保存に明示的な同意が必要です。 Workatoは、これらの要件への準拠を強制できません。パイプラインでcall_transcriptsを有効にする前に、自社の義務を確認してください。

PIIが送信先に到達する前に保護するには、パイプライン設定中にフィールドレベルのデータ保護でHashオプションを使用します。詳細については、パイプラインを構成手順を参照してください。

制限事項 ​

Gongをデータパイプラインソースとして使用する場合、次の制限事項が適用されます:

プライベート通話は除外される ​

Gongでは、OAuth統合アプリケーションがプライベートとしてマークされた通話を除外する必要があります。 Workatoは、calls、extensive_calls、call_transcripts、manual_callsからレコードを取得した後、およびextensive_callsから派生した通話コンテンツ分析オブジェクトに対して、この除外を適用します。 Gongでプライベートとしてマークされた通話は、宛先に表示されることはありません。

プライベートおよびアーカイブ済みのライブラリフォルダは除外される ​

GongのAPIは、プライベートまたはアーカイブ済みのライブラリフォルダを読み取りクライアントに公開しません。これらのフォルダとその中のコンテンツは、宛先のlibrary_foldersまたはlibrary_folder_contentに表示されることはありません。

通話トランスクリプトによるストレージ容量の増加 ​

call_transcriptsは、パイプラインに追加するとデフォルトで有効になります。オブジェクトを追加しないか、選択を解除してオプトアウトします。詳細については、パイプラインの設定を参照してください。

削除された通話が宛先に残る ​

GongのAPIは、削除された通話を読み取りクライアントに公開しません。 Gongで同期後に削除された通話は、最後に同期された値を保持したまま宛先に残ります。これは、calls、call_parties、extensive_calls、call_transcripts、manual_calls、answered_scorecards、user_activity_stats、通話コンテンツ分析オブジェクトに適用されます。

Gongサブスクリプション階層の要件 ​

一部のオブジェクトでは、Gongプランで特定のGongサブスクリプション階層または機能が有効になっている必要があります:

• trackersとcall_tracker_occurrencesには、GongのSmart Trackers機能が必要です。
• answered_scorecardsには、GongのCoaching機能が必要です。
• call_topics、call_key_points、call_highlights、call_outline、call_interaction_statsには、GongのAI搭載通話分析機能が必要です。

必須機能がGongプランで有効になっていないオブジェクトを同期すると、パイプラインは不足している機能またはスコープの名前を示す権限エラーを返します。

録画URLは短時間で期限切れになる ​

extensive_callsには、通話の音声および動画録画への直接リンクを含めることができます。これらのURLは、WorkatoがGongから要求してから8時間後に期限切れになるため、後で録画にアクセスするために宛先に保存されたURLを利用することはできません。

APIレート制限 ​

Gongは、1秒あたり3件のAPIリクエスト、1日あたり10,000件のAPIリクエストというレート制限を適用します。多くのオブジェクトを同期するパイプラインや、大規模な履歴バックフィルを実行するパイプラインでは、その結果、完了までに時間がかかる場合があります。

最小同期頻度 ​

サポートされる最小同期間隔は15分です。