メインコンテンツにスキップ

会話データをクラウドストレージにエクスポートする

すべての顧客会話データをAmazon S3またはGoogle Cloud Storageにエクスポートします。

対応者:Beth-Ann Sher

Intercomのデータエクスポート機能を使って、すべての顧客のConversationsAmazon S3またはGoogle Cloud Storageにエクスポートできます。用途は以下の通りです:

  • レポートと分析

  • シングルカスタマービュー

  • データ品質とガバナンス

エクスポートオプション:

  • API version:エクスポートする会話データのスキーマを選択します。

  • 出力形式JSONまたはJSONL

  • 添付ファイル:会話パートの添付ファイルのエクスポート。

  • 履歴:過去2年間のすべての会話データのエクスポート。

  • 定期:新規および更新された会話データの継続的な時間単位または日単位のエクスポート。


クラウドストレージへのデータエクスポート方法

1. 設定 > データ > インポート&エクスポート > データをエクスポートに移動し、新しいデータエクスポートを選択します。

2. エクスポートするConversationsデータのData API version出力形式を選択し、添付ファイルを含めるかどうかを切り替えます。

3. エクスポートファイルの整理方法を設定します:

  • フォルダ名を入力します(任意)。

  • 日付フォルダでデータをエクスポートを選択すると、2025-07-13、2025-07-14、2025-07-15などの日付名のフォルダに会話データがエクスポートされます。

  • データに変更がない場合は空のエクスポートをスキップを選択すると、データに変更がないスケジュールされたエクスポートをスキップします。

4. 「宛先」セクションで、エクスポートデータを受け取るAWS S3またはGoogle Cloud Storageのバケット情報を選択します。

5. バケットの設定が完了したら、テストボタンをクリックしてIntercomがバケットにデータを書き込めるか確認します。成功すると「バケットのテストに成功しました」という通知が表示されます。

テスト中、intercom-data-export-test-file.jsonというファイルがバケットのルートに書き込まれます。

注意

  • Intercomはバケットにのみ書き込み可能で、ファイルの読み取りや削除はできません。

  • 複数のワークスペースを同じバケットにエクスポートすることはできません。

6. 「スケジュール」セクションで、過去2年間の完全な履歴データエクスポートを希望する場合は、過去2年間の履歴データをエクスポートを有効にします。次に、エクスポートの頻度を時間単位または日単位から選択します。

7. データエクスポートページの下部までスクロールし、データエクスポートを開始をクリックします。

8. 確認メールが送信される通知が表示されます。これは、あなたがIntercomの管理者であり、データエクスポート機能にアクセスする権限があることを確認するためのセキュリティ措置です。OKをクリックすると、確認メール送信ページが表示されます。

9. メールクライアントを開き、team@intercom.ioからのメールを見つけて確認をクリックします。

10. データエクスポートが開始され、履歴データエクスポートがテーブルに進行中ステータスで表示されます。

11. データエクスポートの設定を確認したい場合は、設定タブを選択して確認できます。

初期設定後に以下の設定を更新できます:

  • Data API version

  • 出力形式

  • 添付ファイル

その他の設定は読み取り専用です。読み取り専用設定を変更するには、削除ボタンをクリックしてデータエクスポートを削除し、再作成する必要があります。

12. バケットフォルダに戻ると、JSONまたはJSONLファイルが表示されます。ステップ3で日付フォルダを選択した場合は日付ごとのフォルダに表示されます。各JSONファイルにはJSON形式のConversationデータが含まれます。ファイル名はUTCの日時形式で、各バッチの開始・終了日時で始まります。各バッチは最大200件の会話を含む別ファイルをバケットに作成します。

13. 設定 > データ > インポート&エクスポート > データをエクスポートに戻ります。履歴データエクスポートが完了すると、選択した時間単位または日単位の頻度で定期的なデータエクスポートが開始されます。以降のすべてのデータエクスポートはテーブルに進行中のステータスで表示され、完了時も残ります。

14. 定期的なデータエクスポートでは、各ファイルにその期間の新規および更新されたすべての会話が含まれます。各JSONオブジェクトは前回のエクスポートとの差分ではなく、会話の全パートを含みます。

15. 添付ファイルがエクスポートされる場合、以下の名前のフォルダに保存され、JSONまたはJSON Linesのエクスポートされた会話データから参照されます。

<folder_name>/attachments/<conversation_id>/<conversation_part_id>/<attachment_name>

16. 削除ボタンをクリックするとデータエクスポートを削除できます。これによりエクスポート設定は削除されますが、既に宛先バケットにエクスポートされたファイルは削除されません。

こちらの回答で解決しましたか?