Teammates と Teammate activity logs を会話データと共に Amazon S3、Google Cloud Storage、または Azure Blob Storage にエクスポートします。
スケジュールされたデータエクスポートは以前は会話のみを対象としていました。現在は、各スケジュールエクスポートに含めるデータオブジェクトを選択でき、チームメンバーデータを他のすべてと同じスケジュールでクラウドストレージに配信できます。
用途例:
アクセスレビューと監査証拠 — ワークスペースへのアクセス権と変更内容の確認
セキュリティ監視 — ログイン、権限変更、SSO変更を自社のSIEM（セキュリティ情報およびイベント管理システム）で監視
会話データと共にデータガバナンスと保持管理
どのデータオブジェクトをエクスポートできますか？
以下の表は各データオブジェクトの内容とエクスポート頻度を説明しています。
データオブジェクト | 内容 | エクスポート方法 |
会話 | 会話とその構成要素（作成者、割り当て、タグ、カスタム属性を含む）。 | 各実行時の新規および更新された会話 |
Teammates | ワークスペース内のすべてのチームメンバーの名前、メールアドレス、役割。 | 各実行時の完全スナップショット |
Teammate activity logs | ログイン、権限変更、SSO変更などのチームメンバーアカウントの活動記録。 | 前回実行以降の新しい活動 |
各データオブジェクトは既存のスケジュールで独立したエクスポートとして実行され、同じバケットにオブジェクトごとに別フォルダで配信されます。実行は個別に追跡されるため、あるデータオブジェクトの問題が他に影響しません。
チームメンバーデータはJSONまたはJSONL（各行が独立したJSONオブジェクトの形式で、大規模データセットのストリーミングに便利）でエクスポートされ、エクスポート設定されたData API versionのList all adminsおよびList all activity logsエンドポイントと同じスキーマを使用します。
エクスポートされたチームメンバーデータはバケットのどこに保存されますか？
チームメンバーデータはデータオブジェクトごとに専用フォルダに書き込まれ、会話ファイルと混ざることはありません。既存の会話ファイルは移動しません — エクスポートフォルダのルートにそのまま残ります。
チームメンバーデータは既存のエクスポートバケット内の専用サブフォルダに保存され、会話ファイルとは別に管理されます。以下の通りです。
フォルダ | 内容 |
| 会話ファイル（変更なし） |
| Teammates |
| Teammate activity logs |
Export data dated foldersを有効にした場合、日付フォルダはデータオブジェクトフォルダの内側に配置されます。逆ではありません。
日付フォルダ | 例のパス |
オフ |
|
オン |
|
下流パイプラインで会話のプレフィックスをグロブしても、そのパターンは変わらず機能し、チームメンバーファイルを拾いません。
ファイル名は会話エクスポートと同じ規則に従います — UTCの<batch start>-<batch end>-<batch id>形式で、:は-に置換され、Output formatに合わせて.jsonまたは.jsonl拡張子が付きます。
1回の実行あたりのファイル数:
Teammates — 1回の実行につき1ファイルで、全メンバーを含みます。
Teammate activity logs — 会話と同様にバッチに分割され、1回の実行で1ファイル以上になります。
フォルダ名の日付はエクスポートが実行された日付であり、活動が発生した日付ではありません。
チームメンバーデータをエクスポートする前に何が必要ですか？
権限。 Manage teammates と See all teammates and team details の両方が必要です。両方がないとチームメンバーデータオブジェクトは提供されません。
宛先。 TeammateデータオブジェクトはAWS S3、Google Cloud Storage、およびAzure Blob Storageで利用可能です。Snowflake Data Shareの宛先では利用できません。
Data API version。 Teammateのアクティビティログには最新のData API versionが必要です。古いバージョンに固定されたエクスポートには含めることができません。
Teammateデータをクラウドストレージにエクスポートする方法
1. 設定 > データ > インポートとエクスポート > データのエクスポートに移動し、既存のデータエクスポートを開くか、新しいデータエクスポートを選択します。
新しいエクスポートを作成する場合は、会話データをクラウドストレージにエクスポートする方法に従って、最初にData API version、出力形式、フォルダオプション、宛先バケット、スケジュールを設定してください。
2. データオブジェクトセクションで、エクスポートしたいデータオブジェクトにチェックを入れます。任意の組み合わせを選択できます。
エクスポートには少なくとも1つのデータオブジェクトが必要です。最後の1つのチェックボックスは無効になります。削除する前に別のデータオブジェクトにチェックを入れてください。
3. ページの一番下までスクロールし、更新（新しいエクスポートの場合はデータエクスポートを開始）をクリックします。
4. Teammateデータの流れが開始または停止すると、確認ダイアログが表示されます。データオブジェクトの追加か削除かによって2種類のダイアログがあり、内容を読み変更を保存をクリックしてください。
Teammateデータを追加すると、次のスケジュールされた実行から含まれること、個人データ（名前、メールアドレス、役割、ログイン、権限変更、SSO変更などのアカウントアクティビティ）が含まれること、およびお客様が管理するストレージに書き込まれるため、エクスポート後にIntercomがデータを呼び戻したり削除したりできないことが確認されます。
データオブジェクトを削除すると、回復可能な内容がダイアログで説明されます。
Teammateアクティビティログ — 数日以内に再度有効にすると、次のエクスポートで追いつきます。それ以降はIntercomに依頼した履歴エクスポートのみがギャップを埋められます。
Teammates — 毎回フルリストをエクスポートするため、再度有効にすると完全なデータが復元され、恒久的なギャップはありません。
データオブジェクトの追加と削除を同時に行う保存では、両方をカバーする単一のダイアログが表示されます。キャンセルをクリックすると何も送信されず、未保存の選択が画面に残ります。Teammateデータオブジェクトを保存すると、出力形式の切り替えなど無関係な変更では再度プロンプトが表示されません。
5. 次のスケジュールされた実行後、バケットを確認してください。Teammateデータはデータオブジェクトごとに独自のフォルダに表示されます — admins/ と admin_activity_logs/。
6. エクスポートが実行されたことを確認するには、設定 > データ > インポートとエクスポート > データのエクスポートに戻り、実行タブを確認します。各行はデータオブジェクトでラベル付けされています — 会話、Teammates、またはTeammateアクティビティログ。
7. エクスポート設定を誰がいつ変更したかを見るには、設定 > ワークスペース > Teammates > アクティビティログに移動し、データエクスポートイベントでフィルターします。エントリには関係したデータオブジェクトが記録されます。この機能がリリースされる前のイベントは元の文言のままで、データオブジェクトは含まれません。
8. Teammateデータのエクスポートを停止するには、データオブジェクトのチェックを外し、更新をクリックして確認します。エクスポート全体を削除すると設定は削除されますが、既にバケットに書き込まれたファイルは削除されません。
現在の制限事項は何ですか？
以下の制限は、Teammateおよびアクティビティログのクラウドストレージへのデータエクスポートに適用されます。
Intercomはエクスポートされたファイルを削除できません。 データがバケットに書き込まれると、Intercomは書き込みのみ可能で、読み取りや削除はできません。消去要求はエクスポート済みファイルに反映されないため、既にバケットにあるファイルからTeammateのデータを削除する責任はお客様にあります。これは既存の会話エクスポートと同様です。
Teammatesは差分ではなく完全なスナップショットです。 毎回、全リストを単一ファイルでエクスポートします。増分や変更のみのモードはなく、個別のTeammateや日付範囲でのフィルタリングもありません。
Teammateデータのセルフサービス履歴エクスポートはありません。 会話とは異なり、2年間のバックフィルオプションはなく、有効化後の次のスケジュール実行からデータが流れ始めます。過去のアクティビティが必要な場合はサポートに連絡し、Intercomに履歴エクスポートを依頼してください。
少なくとも1つのデータオブジェクトが必要です。 何も選択されていないエクスポートはできません。
Teammateアクティビティログには最新のData API versionが必要です。 古いバージョンに固定されたエクスポートには含めることができません。
一部のアクティビティは匿名化されています。 アクションを実行したアカウントがワークスペースのTeammateリストに存在しない場合、実行者のIDやIPアドレスは含まれません。アクティビティログのメタデータは厳選されたフィールドに限定されているため、エクスポートされたアクティビティログはData APIの同じ記録より詳細が少ない場合があります。
バケットあたり1つのワークスペース。 会話と同様に、複数のワークスペースを同じバケットにエクスポートすることはできません。
トラブルシューティング
エクスポート設定や実行履歴に問題がある場合は、以下の表を使って診断してください。
表示される内容 | 意味 |
Teammateのチェックボックスが表示されず、会話のみ表示される | おそらくTeammatesの管理および/またはすべてのTeammatesとチームの詳細を見る権限が不足しています。 |
チェックボックスがグレーアウトして外せない | 最後の1つのデータオブジェクトです。先に別のものにチェックを入れてください。 |
チェックボックスがチェックされていてかつグレーアウトしている | エクスポートにはすでにそのデータオブジェクトが含まれていますが、ここでは変更できません。権限またはエクスポートのData API versionが設定後に変更されたためです。フル権限を持つTeammateに依頼するか、サポートに連絡してください。 |
「Teammatesの管理とすべてのTeammatesとチームの詳細を見る権限が必要です…」 | 必要な両方の権限がありません。管理者が設定 > Teammatesで付与できます。 |
「利用可能なオブジェクトタイプを表示するにはページを更新してください…」 | ページ読み込み後に利用可能なデータオブジェクトが変わった可能性があります。通常はアクティビティログを提供できないData API versionです。更新して再試行し、それでも続く場合はサポートに連絡してください。 |
実行タブに実行が表示されるが、バケットにファイルが届かない | 通常はバケットの権限が原因です。宛先のテストボタンを再実行し、その後サポートに連絡してください。 |
一部のアクティビティログの行に実行者がいない、またはメタデータが空 | 想定される状況です — アクションを実行したTeammateはワークスペースのリストにもう存在しません。 |
エクスポートされたメタデータは | 期待されること — エクスポートはAPIレスポンスよりも厳格でキュレーションされたメタデータフィールドのセットを使用します。 |
ウィンドウを見逃してしまい、バックフィルが必要です。 | サポートに連絡してください — Intercomはチームメイトとアクティビティログデータの履歴エクスポートを実行できます。 |