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

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

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

対応者:Michelle Faughnan

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

このガイドは会話関連のエクスポートに特化しており、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. 表示される一括操作バーで...(その他の操作)をクリックします。

  4. 検索ボックスに「export」と入力し、テキストとしてエクスポートまたはPDFとしてエクスポートを選択します。

  5. 選択した会話が個別ファイルとしてデバイスにダウンロードされます。

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

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

  • すべての参加者情報

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

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

  • 機密性の高い支払いデータを編集済み(入力時にPAN編集適用)

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

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

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

  • Chart drill-inにアクセス可能 — Datasetエクスポートページへのアクセスとデータ閲覧に必要です。

  • 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のデータセットで利用可能なすべての指標と属性の会話データをエクスポートできます。

注意:

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

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

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

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

  • 現在、会話ごとのクローズ数を示す新しい属性はありませんが、会話アクションデータセットを使い「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機能を使用します。historicalperiodicの両方のエクスポートオプションがあります。

注意:

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

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

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

エクスポートタイプ

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

  • Periodic: 新規および更新された会話の毎時または毎日のエクスポートを設定します。

手順

  1. 出力形式とデータAPIバージョンを選択して、エクスポートされる会話が使用するものを指定します。

  2. Historical または Periodic オプションのいずれかを選択します。

  3. セットアップ手順に従ってS3接続を構成します。

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

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


よくある質問

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

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

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

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

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

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

  • データセットエクスポートを使用するには「Chart drill-inにアクセス可能」である必要があります。

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

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

新しいデータエクスポートの一部の属性は旧エクスポートの対応する属性と名前が異なります。例:「Inbound/Outbound」は新エクスポートでは「Started by」です。探している属性の確認にはReporting metrics & attributes記事をご覧ください。

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

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

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

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