Slack データエクスポートについて

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

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

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

dms.json  

groups.json  

integration_logs.json

mpims.json  

users.json

全チャンネルのフォルダ

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

 

Slackメッセージ

エクスポートファイルを解凍すると、各チャンネルのフォルダが表示されます。それぞれのフォルダ内に、チャンネルに投稿されたメッセージが日付順に並んだ JSON データの形で格納されています。

以下、とてもシンプルなメッセージを例にあげます :

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

 データの読み方は次のとおりです:

  • 「type」 値は、データがメッセージであることを表すものです。
  • 「channel」 値の後の ID は、メッセージの投稿先のパブリックチャンネル、プライベートチャンネルまたはダイレクトメッセージを示します。
  • 「user」 値の後の ID は、メッセージを送信したメンバーを示します。
  • 「text」 値に実際のメッセージが含まれます。
  • 「ts」 値の後の ID は、チャンネルごとに固有のタイムスタンプで、メッセージが投稿された時間を示します。

メッセージによっては、オブジェクトのリストを含む 「attachments」 値が含まれる場合があります。

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

メッセージの編集履歴

投稿後に編集されたメッセージには、「edited」値と、それに続いて変更したメンバーのユーザー 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 に投稿されたメッセージに加え、メッセージのサブタイプには、Trello のようなアプリやインテグレーションからの投稿や、メンバーがチャンネルに参加したり外れたりした時に表示されるメッセージなどが含まれます。

Screen_Shot_2016-06-06_at_2.13.13_PM.png

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

タイプ 説明
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」 値に含まれるユーザーには、リアクションしたメンバー全員が必ず含まれるとは限りませんが、「count」 には実際にリアクションしたユーザー全員の数が表示されます。

関連記事

最近チェックした記事