Slack データエクスポートの確認方法

Slack チームのデータをエクスポートすると、メッセージ履歴 (JSON 形式) を含む .zip ファイルとアップロードされたファイルへのリンクが届きます。

どちらのタイプのエクスポートが利用可能かにより、.zip ファイルに含まれる内容が異なります :

  スタンダードエクスポート プラスデータエクスポート
channels.json

dms.json  

groups.json  

integration_logs.json

mpims.json  

users.json

全チャンネルのフォルダ

注意 :  利用可能なエクスポートのタイプに関して詳しくは、 Slack データエクスポート ガイド  を確認してください。 

 

.zip ファイルを解凍すると、チャンネル別のフォルダがあり、各フォルダ内には投稿された日別に分かれたメッセージの JSON ファイルが確認できます。 以下、とてもシンプルなメッセージを例にあげます :

{
   "type": "message",
   "channel": "C2147483705",
   "user": "U2147483697",
   "text": "Hello world",
   "ts": "1355517523.000005"
}

`channel` 値に続く ID によって、どのチャンネル、プライベートチャンネルまたはダイレクトメッセージにそのメッセージが投稿されたかが判別できます。また `user` 値に続く ID からはどのメンバーがそのメッセージを送信したのかが分かり、さらに `text` 値には実際のメッセージが含まれます。最後に、`ts` 値は (チャンネルごとの) ユニークなタイムスタンプで、メッセージが投稿された時間を示します。 

また、メッセージによっては `attachments` 値を含み、Attachment オブジェクト  のリストを含みます。

Tip :   チャンネルやユーザーを示す英数字のコードリファレンスが何を意味するのかは、 エクスポートに含まれるそれぞれの channels.jsonusers.json ファイルを参照してください。

 

メッセージの編集履歴

投稿後に編集されたメッセージには、 `edited` 値と、それに続いて編集したメンバーの user ID、編集された時間を示すタイムスタンプが含まれます。 以下に例をあげます :

 {
    "type": "message",
    "user": "U06NKBGN8",
    "text": "test:edited",
    "edited": {
        "user": "U06NKBGN8",
        "ts": "1458672560.000000"
    },
    "ts": "1458672049.000002" 
},
{
    "type": "message",
    "message": {
        "type": "message",
        "user": "U06NKBGN8",
        "text": "test:edited",
        "edited": {
            "user": "U06NKBGN8",
            "ts": "1458672560.000000"
        },
        "ts": "1458672049.000002"
    },
    "subtype": "message_changed",
    "hidden": true,
    "channel": "C0AJZ3BT4",
    "ts": "1458672560.000003",
    "original": {
        "type": "message",
        "user": "U06NKBGN8",
        "text": "test:original",
        "ts": "1458672049.000002"
    },
    "edited_by": "U06NKBGN8
}


メッセージのサブタイプ

メンバーが実際に Slack に投稿したメッセージに加え、メッセージの subtype (サブタイプ) があります。

メッセージのサブタイプには、Trello のような連携アプリからの投稿や、メンバーがチャンネルに参加・離脱した時に表示されるメッセージなどが含まれます。


以下、メッセージのサブタイプの一覧です :

タイプ 説明
bot_message アプリやインテグレーションによる投稿メッセージ
me_message  /me  メッセージが送信された
message_changed メッセージが変更された
message_deleted メッセージが削除された
channel_join メンバーがチャンネルに参加した
channel_leave チャンネルからメンバーが抜けた
channel_topic チャンネルのトピックが更新された
channel_purpose チャンネルの目的が更新された
channel_name チャンネル名が変更された
channel_archive チャンネルがアーカイブされた
Channel_unarchive アーカイブされたチャンネルが復元された
group_join メンバーがグループに参加した
group_leave メンバーがグループから抜けた
group_topic グループのトピックが更新された
group_purpose グループの目的が更新された
group_name グループ名が変更された
group_archive グループがアーカイブされた
group_unarchive アーカイブされたグループが復元された
file_share ファイルがチャンネルで共有された
file_comment ファイルにコメントが追加された
file_mention チャンネルでファイルがメンションされた
pinned_item チャンネルでアイテムがピンされた
unpinned_item チャンネルでアイテムのピンが外された


隠しサブタイプ

メッセージのサブタイプの中には、特殊な隠しプロパティを持つものがあります。これには、チャンネルの履歴の一部とみなされる必要があるが、他のメンバーに必ずしも表示されるわけではないメッセージなどが該当します。メッセージの編集・削除ログが隠しサブタイプの良い例です。

 {
   "type": "message",
   "subtype": "message_deleted",
   "hidden": true,
   "channel": "C024BE91L",
   "ts": "1358878755.000001",
   "deleted_ts": "1358878749.000002",
   "event_ts": "1358878755.000002"
}

 

スター・ピン・リアクション

また、メッセージには、メンバーがメッセージをスター・ピン・リアクションしたことを示す、いくつかの特別プロパティがあります。

{
   "type": "message",
   "channel": "C2147483705",
   "user": "U2147483697",
   "text": "Hello world",
   "ts": "1355517523.000005",
   "is_starred": true,
   "pinned_to": ["C024BE7LT", ...],
   "reactions": [
       {
           "name": "astonished",
           "count": 3,
           "users": [ "U1", "U2", "U3" ]
       },
       {
           "name": "facepalm",
           "count": 1034,
           "users": [ "U1", "U2", "U3", "U4", "U5" ]
       }

⭐️   `is_starred` が存在し、値が true の場合、チームのメンバーによってメッセージがスターされている状態であることを示します。メッセージがスターされていない場合は、この値は表示されません。

📌  どこかのチャンネルにメッセージがピンされている場合、`pinned_to` の横に、メッセージがピンされているロケーションの ID が表示されます。

👍🏼  `reactions` が存在する場合、それまでにメッセージに追加された全てのリアクションに関し、リアクション名 (`name`)・リアクションしたメンバー数 (`count`)・リアクションしたメンバーのリスト (`users`) の情報がリストアップされます。

注意 :   `reactions` 値に含まれる `users` には、リアクションした全メンバーが必ずリストされるとは限りませんが、 `count` にはリアクションしたユーザー全員の数が必ず表示されます。

関連記事

最近チェックした記事