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

会話データをエクスポートする

チームのパフォーマンスをさらに分析するために、会話内容とデータを簡単にエクスポートできます。

対応者:Alek Toumert

チームの会話を詳しく確認したい場合、会話内容やデータをダウンロード・エクスポートする方法はいくつかあります。

このガイドは会話関連のエクスポートに特化しており、ticketsやユーザーデータなど他のエクスポートタイプとは異なります。


個別の会話内容をダウンロードする

特定の会話やticketのみが必要な場合は、個別にダウンロードできます。

  1. Inboxの会話またはticketに移動します。

  2. 右上の三点リーダーをクリックします。

  3. 次のオプションを選択します。

    • 会話をテキストとしてエクスポート(または会話をPDFとしてエクスポート

    • ticketをテキストとしてエクスポート(またはticketをPDFとしてエクスポート

PDFとテキストの両方のエクスポートには、タイムスタンプ付きの完全なメッセージ履歴、すべての参加者情報、表示されている会話内容が含まれます。内部メモはトランスクリプトエクスポートから除外されます。AIの要約とメタデータは利用可能な場合に含まれ、カード番号などの機密支払い情報は入力時にマスクされます。

現在、ワークスペースからすべての会話内容をCSVファイルで直接ダウンロードするオプションはありません。


APIを使って会話内容を一括ダウンロードする

大規模なエクスポートには、IntercomのConversations APIを使って会話内容を一括取得できます。

  1. 会話一覧を取得:Conversations APIを使って会話IDのリストを取得します。

  2. 会話IDで内容を取得:各会話IDにGETリクエストを送り詳細内容を取得します。

注意:

  • Export APIは1リクエストあたり最大90日間の期間でエクスポート可能で、ボリューム制限はありません。

  • IntercomワークスペースUIからの一括会話内容エクスポートは、1回の操作で200~300件の会話をPDFまたはテキストでサポートします。より多くの場合はConversations APIを使用してください。



Inboxから会話内容を一括ダウンロードする

Inboxから会話内容をPDFまたはテキストファイルで一括エクスポートできます。APIは不要です。

エクスポート方法

方法

形式

利用ケース

制限

個別UIエクスポート

PDF、テキスト

単一の会話

手動で1件ずつ

一括UIエクスポート

PDF、テキスト

複数の会話

1回の操作で200~300件の会話

一括エクスポートの方法

  1. Inboxに移動し、会話フィルターを使ってエクスポートしたい会話を絞り込みます。

  2. 一括選択コントロールで会話を選択します。

  3. 一括操作メニューを開き、エクスポート形式を選択します — PDFとしてエクスポート または テキストとしてエクスポート

  4. 完了すると、ファイルをダウンロードできます。

一括エクスポートに含まれる内容

  • タイムスタンプ付きの完全なメッセージ履歴

  • すべての参加者情報

  • 表示されている会話内容(内部メモはトランスクリプトエクスポートから除外)

  • 利用可能な場合のAI要約とメタデータ

  • 入力時点でPANの編集が適用された機密支払いデータの編集済み

会話データをCSVにエクスポートする

Intercomの柔軟なCSVエクスポート機能を使えば、必要なデータを正確に選択でき、自動エクスポートのスケジュールも設定可能です。

必要な権限:チームメイトはDataset exportを使用するために2つの権限が必要です。

  • Can access Chart drill-in — Dataset exportページにアクセスし、データを閲覧するために必要です。

  • Can export CSV — CSVファイルとしてデータをエクスポートするために必要です。

エクスポート機能

  • 13のレポート用データセットすべてにアクセス可能。

  • 完全な属性カバレッジ。

  • カスタム列選択と属性ベースのフィルタリング。

  • 即時ダウンロード(最大10,000行まで)。

  • 定期的なスケジュールエクスポート。

注意事項

  • 会話/メッセージ内容はCSVエクスポートに含まれていません

  • company_idによる会話のフィルタリングはConversations Search APIでサポートされていません。会社に関連する会話を見つけるには、まず会社のすべての連絡先を取得し、次にcontact_idsフィールドを使って会話を検索してください。

この違いは、CSVエクスポートがメタデータの概要を提供するのに対し、メッセージ内容や完全な会話はConversations APIやAmazon S3エクスポートなどのツールを使う必要があることを示しています。

CSVエクスポートの手順

  1. 移動先: Reports > Dataset export

  2. データセットを選択:利用可能な包括的なリストからエクスポートしたいデータセットを選択してください。

  3. 期間を選択:必要なデータの期間を定義します。これにより、分析に関連する特定の期間のデータに絞り込めます。

  4. 属性でフィルタ(任意):新しいフィルタリングオプションを使って特定の属性に基づきデータをさらに絞り込み、最も関連性の高いデータだけを取得できます。

  5. 列を選択:エクスポートに含めたい特定の列を選択してカスタマイズします。このステップで分析に必要なデータ出力を正確に調整できます。

  6. エクスポートのプレビュー:エクスポートを確定する前に、必要な情報がすべて含まれ、正しくフォーマットされているかプレビューで確認してください。

  7. CSVにエクスポート:プレビューに満足したら、Export CSVをクリックしてください。このファイルはさまざまなアプリケーションでのさらなる分析やレポートに簡単に使用できます。

重要な制限事項:

  • レポート用メタデータのみ:CSVエクスポートにはレポート用メタデータ(例:会話ID、タイムスタンプ、属性、指標)が含まれますが、メッセージ全文や会話内容は含まれません。全文の会話内容をエクスポートするには、Conversations APIまたはAmazon S3エクスポートを使用してください。

  • データの利用可能期間:データは通常最大2年間利用可能です。

  • 返信のないアウトバウンド会話:顧客が返信しなかったアウトバウンド会話はレポート用データセットに含まれません。エクスポートおよびレポートには、少なくとも1件のユーザーまたはリードメッセージがある会話のみが含まれます。

Intercomのデータセットで利用可能なすべてのmetrics and attributesの会話データをエクスポートできます。

注意:

  • ブラウザでのダウンロード時、会話データのエクスポートは10,000行に制限されています。この制限を超える場合は、自動的にメールで送信されます(エクスポートのサイズによっては最大1時間かかることがあります)。

  • エクスポートには選択した期間内に開始されたすべての会話が含まれます。例えば、月曜日にメッセージが作成され火曜日に送信された場合、火曜日のエクスポートにはそのメッセージは表示されません。

  • ユーザーデータは会話開始時に取得されるため、エクスポートはその時点のデータ状態を反映します。

  • アプリ内メッセージの場合、メッセージが配信されて初めてエクスポートに表示され、削除/停止されたメッセージもエクスポートに含まれます。

  • 現在、会話ごとのクローズ数を示す新しい属性はありませんが、conversation actions datasetを使い「Action type = Close」でフィルタリングすることでこのデータを見つけられます。

スケジュールエクスポート

これらのフィルタを使った会話データのエクスポートを定期的に受け取りたい場合は、エクスポートのスケジュールを設定できます。

  1. 移動先: Reports > Dataset export

  2. エクスポートの構築:定期的にエクスポートしたいデータセット、列、フィルタ、プリセット期間を選択します。

  3. 新しいスケジュールの作成:スケジュールのドロップダウンをクリックし、New scheduleを選択します。

  4. スケジュールのカスタマイズ:スケジュールに名前を付け、エクスポートの頻度を選択します。

  5. スケジュールの保存:Scheduleボタンを選択してスケジュールを作成します。

スケジュールで選択した特定の日時にエクスポートが配信されます。

スケジュールエクスポートの管理

会話データのスケジュールエクスポートを更新または削除したい場合:

  1. 移動先: Reports > Dataset export

  2. 既存のスケジュールを表示:上部のScheduleドロップダウンをクリックし、Manage schedulesを選択してスケジュールを更新または削除します。

  3. 変更するスケジュールを選択:対象のスケジュールにカーソルを合わせ、編集または削除を選択します。

  4. スケジュールの編集:タイトルや頻度を更新して保存します。

  5. スケジュールの削除:スケジュールにカーソルを合わせ、Cancel scheduleボタンを選択して削除します。

注意:スケジュールの名前と配信頻度のみ編集可能です。CSVエクスポート内容を変更するには、希望の属性で新しいスケジュールを作成する必要があります。


会話データをJSON形式でAmazon S3にエクスポートする

Amazon S3にエクスポートすると、会話はJSONデータとしてS3バケットに保存され、さらなる処理が可能です。

注意:S3にエクスポートされた会話およびticketデータにはトランスクリプトは含まれません。トランスクリプトを取得するには、Intercom UIから直接会話をエクスポートするか、REST APIを使用してください。

会話データをJSON形式でAmazon S3にエクスポートするには、IntercomのData Export機能を使用します。履歴および定期のエクスポートオプションがあります。

注意:

  • 最近、エクスポートファイル名をISO時間形式に更新しました。

    例:2025-01-01T00-00-00Z-2025-01-02T00-00-00Z-19.jsonl

  • Amazon S3に保存されたJSONファイルは構造化されており、詳細なメッセージ内容と添付ファイルを提供し、詳細な分析に最適です。

エクスポートタイプ

  • 履歴:最大2年間の会話データをエクスポートします。

  • 定期:新規および更新された会話を時間単位または日単位でエクスポートする設定が可能です。

手順

  1. 出力形式とデータAPIバージョンを選択し、エクスポートする会話に使用します。

  2. 履歴または定期のオプションを選択します。

  3. S3接続の設定手順に従ってください。

Amazon S3へのエクスポート設定について詳しく学びましょう。

エクスポートされた会話データは、新しいIntercomワークスペースにインポートできません。


よくある質問

CSVエクスポートで利用可能な会話データポイントは何ですか?

Intercomデータセットで利用可能なすべての指標と属性のCSVファイルをエクスポートできます。

データはどのくらいの期間エクスポート可能ですか?

CSVおよびJSONエクスポートの両方で最大2年間利用可能です。

なぜデータセットエクスポートページにデータが表示されないのですか?

チームメンバーは以下の権限が必要です:

  • データセットエクスポートを使用するには「チャートドリルインにアクセス可能」である必要があります。

  • エクスポートにアクセスしデータをエクスポートするには「CSVをエクスポート可能」である必要があります。

なぜ旧会話データエクスポートと同じ属性が見つからないのですか?

新しいデータエクスポートの一部の属性は旧エクスポートの対応する属性と名前が異なります。例:「Inbound/Outbound」は旧エクスポートで、「Started by」は新エクスポートです。属性の検索には指標と属性の記事をご覧ください。

旧会話データエクスポートはいつ廃止されますか?

旧会話データエクスポートは今後60日以内に廃止されます。頻繁に使用しているかスケジュールエクスポートがあるお客様には十分な通知を行います。

それまでは、レポート > データセットエクスポートページ上部のバナーをクリックして旧会話データエクスポートにアクセスできます。

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