Comment lire les exportations des données Slack

Lorsque vous aurez exporté les données de votre espace de travail, vous pourrez télécharger un fichier ZIP pour accéder à l’historique des messages et aux liens de fichiers.  


Formats d’exportation

Votre format d’exportation dépend du type d’exportation que vous effectuez :

  • Canaux publics uniquement : les données seront exportées au format JSON.
  • Ensemble des canaux et conversations : les données seront exportées au format JSON.
  • Canaux et conversations d’un utilisateur : les données seront exportées soit au format JSON, soit au format TXT.


Ce que contient votre fichier d’exportation

Fichiers JSON

Fichiers TXT

Une fois votre exportation terminée, vous téléchargerez un fichier ZIP contenant les données de votre espace de travail et une série de liens de fichiers renvoyant vers les fichiers de votre espace de travail. En fonction du type d’exportation effectué, voici ce que votre fichier ZIP inclura :

  Canaux publics uniquement Ensemble des canaux et conversations
Canaux (channels.json)

Messages directs (dms.json)  

Canaux privés (groups.json)  

Journaux d’activité des applications (integration_logs.json)

Messages directs de groupe (mpims.json)  

Membres (users.json)*

Dossiers pour chaque canal public

Dossiers pour chaque canal privé

 

Dossiers pour chaque message direct

 

Une URL pour chaque canevas (canevas.json)**

* Si vous exportez des données à partir d’une organisation Enterprise Grid, ce dossier sera nommé org_users.json.
** Si vous exportez uniquement les données des canaux publics, ce dossier ne contiendra que les canevas partagés dans les canaux publics.

Conseil : Avec le forfait Enterprise Grid, vous pouvez choisir d’exporter des données pour l’ensemble de votre organisation ou pour un espace de travail spécifique. Les exportations pour un espace de travail spécifique comprennent les canaux publics et privés de l’espace de travail sélectionné, mais pas les canaux sur plusieurs espaces de travail.

Si vous choisissez d’exporter les données des conversations d’un utilisateur au format TXT, vous téléchargerez un fichier ZIP avec tous les messages et fichiers envoyés par l’utilisateur que vous avez sélectionné une fois votre exportation terminée. Votre fichier ZIP contiendra trois dossiers :

  • canaux
  • messages directs
  • fichiers

Chaque dossier contiendra plusieurs fichiers TXT qui contiennent quant à eux l’historique d’une conversation ou des fichiers envoyés par un seul utilisateur dans la plage de dates que vous avez sélectionnée.

Remarque : si vous appliquez une plage de dates à une exportation, Slack renverra toutes les conversations auxquelles l’utilisateur a participé, même si aucun message n’a été envoyé dans cette conversation aux dates sélectionnées. Auquel cas, le canal n’affichera aucun message dans le fichier d’exportation.


Parcourir votre fichier d’exportation

Fichiers JSON

Fichiers TXT

Lorsque vous ouvrirez votre fichier ZIP d’exportation, chaque canal ou message direct aura son propre dossier. Dans chacun des dossiers, les messages de la conversation apparaîtront dans des fichiers JSON séparés, classés par date.

Des fichiers de référence seront disponibles pour différents types de conversations : des fichiers channels.json pour les canaux publics, des fichiers groups.json pour les canaux privés et des fichiers dms.json pour les messages directs. Ils contiendront les identifiants de l’utilisateur et du canal. Pour rechercher une conversation spécifique, il vous faudra utiliser le canal et les fichiers de référence. Vous pourriez par exemple procéder comme suit : 

  1. Ouvrez le fichier users.json et recherchez les utilisateurs concernés. Prenez note de leurs identifiants. 
  2. Ensuite, ouvrez le fichier channels.json, groups.json ou dms.json et recherchez la conversation incluant ces deux identifiants dans la section membres. Prenez note du nom du canal ou de l’identifiant de la conversation en question. 
  3. Dans le dossier d’exportation principal, recherchez le dossier dont le titre inclut le nom du canal ou l’identifiant de la conversation. Vous trouverez plusieurs fichiers JSON dans ce dossier ; un pour chaque date à laquelle des messages ont été envoyés.

Remarque : un dossier sera inclus dans le fichier d’exportation uniquement si des messages sont disponibles pour la plage de dates que vous avez exportée. Par exemple, si vos règles de conservation sont définies de sorte à supprimer les messages des canaux publics au bout de 30 jours et que vous avez sélectionné une plage de dates remontant à plus de 31 jours, aucun dossier ne sera inclus dans votre exportation pour les canaux publics.

Chaque dossier de votre fichier ZIP contiendra différentes données de votre espace de travail. Le dossier canaux contiendra un fichier TXT pour chaque canal et chaque message direct de groupe auquel a participé un utilisateur unique. Le dossier messages directs contiendra un fichier TXT pour chaque message direct de personne à personne auquel a participé un utilisateur unique.

Les fichiers TXT pour les conversations auront pour titre le nom du canal ou les noms d’utilisateurs des membres participant au message direct. Par exemple, les données de votre canal #général se trouveront dans le fichier general.txt. Les données d’un message direct peuvent se trouver dans un fichier intitulé mcollins-jjordan.txt.

Pour consulter les messages d’une conversation spécifique, vous pouvez procéder comme suit :

  1. Ouvrez le dossier canaux ou messages directs.
  2. Ouvrez le fichier TXT du canal ou du message direct que vous souhaitez consulter.

Une fois le fichier TXT ouvert, vous verrez l’historique des messages de la conversation sous l’en-tête Messages. L’historique des messages contiendra les messages envoyés par l’utilisateur unique dans votre exportation et tous les autres utilisateurs ayant participé à la conversation.

Remarque : les messages modifiés et supprimés n’apparaîtront dans votre fichier d’export que si vos règles de conservation sont définies de sorte à les conserver.


Comment lire les messages 

Fichiers JSON

Fichiers TXT

Chaque message comprendra les champs suivants :

  • "type" : 
    indique que les données sont des messages.
  • "user" : 
    identifiant du membre qui a envoyé le message.
  • "text" : 
    indique le contenu du message.
  • "ts" : 
    horodatage de la publication du message. Vous pouvez utiliser n’importe quel convertisseur d’horodatage Unix en ligne pour convertir l’horodatage.

Chaque message sera consigné dans le fichier correspondant à la date à laquelle il a été envoyé. Voici à quoi ressemblera un message très simple :

{
   "type": "message",
   "user": "U2147483697",
   "text": "Bonjour tout le monde",
   "ts": "1355517523.000005"
}

Remarque : certains messages peuvent aussi inclure une valeur pour les "attachments" (pièces jointes). Cette valeur contient la liste des objets joints au message. 

Conseil : vous pouvez traduire les identifiants alphanumériques pour les champs "channel" et "user" en référençant les fichiers channels.json et users.json.

Sous-types de messages

Outre les messages que les membres publient dans Slack, il existe des sous-types de messages : les messages publiés par les applications, les bots ou les intégrations, ou encore des messages que vous voyez lorsqu’un membre rejoint un canal. Voici la liste complète des sous-types de messages :

 

Type Description
bot_message Un message publié par une appli ou par une intégration
me_message Un message a été envoyé avec la commande barre oblique /moi
message_changed Un message a été modifié
message_deleted Un message a été supprimé
channel_join Un membre a rejoint un canal
channel_leave Un membre a quitté un canal
channel_topic Le thème d'un canal a été mis à jour
channel_purpose L'objectif d'un canal a été mis à jour
channel_name Un canal a été renommé
channel_archive Canal archivé
channel_unarchive Canal désarchivé
group_join Un membre a rejoint un groupe
group_leave Un membre a quitté un groupe
group_topic Le thème d’un groupe a été mis à jour
group_purpose L’objectif d’un groupe a été mis à jour
group_name Un groupe a été renommé
group_archive Un groupe a été archivé
group_unarchive Un groupe a été désarchivé
file_share Un fichier a été partagé sur un canal
file_reply Une réponse a été ajoutée à un fichier
file_mention Un fichier a été mentionné sur un canal
pinned_item Un élément a été épinglé sur un canal
unpinned_item L’épingle d’un élément a été supprimée d'un canal

 

Réactions et éléments enregistrés et épinglés

Un message peut avoir des propriétés supplémentaires pour indiquer si quiconque a interagi avec.

  • Si vous voyez "is_starred": true, cela signifie qu’un membre a enregistré le message. Si personne ne l’a enregistré, vous ne verrez pas cette valeur.
  • Si un message a été épinglé, vous verrez les emplacements à côté de "pinned_to".
  • Si "reactions" s’affiche, vous pouvez parcourir une liste de toutes les réactions émojis ajoutées à un message ("name"), le nombre de membres qui ont réagi ("count"), et une liste des membres qui ont réagi ("users").
{
   "type": "message",
   "channel": "C2147483705",
   "user": "U2147483697",
   "text": "Bonjour tout le monde",
   "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" ]
       }

Remarque : la valeur "reactions" ne répertorie pas toujours la liste de tous les membres qui ont réagi à un message. Cependant, la valeur "count" indiquera toujours le nombre exact de personnes qui ont réagi.

Les messages apparaîtront dans l’ordre dans lequel ils ont été envoyés dans la conversation. Les messages contiendront les éléments qui suivent :

  • horodatage (en GMT) de l’envoi du message
  • nom d’utilisateur Slack de la personne qui a envoyé le message
  • contenu du message.

Voici à quoi peut ressembler un message simple :

[2020-04-20 13:47:27]  Bienvenue dans le canal de l’équipe de vente ! Notre équipe s’agrandit plus rapidement que jamais

Votre fichier d’export ne différenciera pas les messages figurant dans un fil de discussion des messages envoyés à un canal. Tous les messages d’un fil de discussion apparaîtront dans le fil de la conversation.


Comment interpréter un message modifié ?

Fichiers JSON

Fichiers TXT

Les membres peuvent modifier des messages qu’ils ont partagés avec un canal. Si votre option d’exportation vous donne accès aux journaux de modifications, un message modifié affichera la valeur "edited" avec les informations suivantes :

  • "user"
    L’identifiant du membre qui a effectué la modification.
  • "ts"
    horodatage de la modification du message. Vous pouvez utiliser n’importe quel convertisseur d’horodatage Unix en ligne pour convertir l’horodatage.

Chaque modification sera consignée dans le fichier correspondant à la date à laquelle elle a été effectuée. Voici un exemple :

{
        "type": "message",
        "user": "UTXHL6F8A",
        "upload": false,
        "ts": "1590101612.000000",
        "text": "Bonjour, voici le message une fois modifié.",
        "previous": {
            "text": "Bonjour, voici le message d’origine.",
            "blocks": [
                {
                    "type": "rich_text",
                    "block_id": "Bts",
                    "elements": [
                        {
                            "type": "rich_text_section",
                            "elements": [
                                {
                                    "type": "text",
                                    "text": "Bonjour, voici le message d’origine."
                                }
                            ]
                        }
                    ]
                }
            ]
        },
        "original_ts": "1590101603.000300",
        "subtype": "message_changed",
        "editor_id": "UTXHL6F8A",
        "blocks": [
            {
                "type": "rich_text",
                "block_id": "O+PJ",
                "elements": [
                    {
                        "type": "rich_text_section",
                        "elements": [
                            {
                                "type": "text",
                                "text": "Bonjour, voici le message une fois modifié."
                            }
                        ]
                    }
                ]
            }
        ]
    }

Les messages modifiés apparaîtront à la fin du fichier TXT de la conversation sous l’en-tête Modification des messages. Les messages modifiés contiendront les éléments qui suivent :

  • horodatage (en GMT) de la modification du message
  • nom d’utilisateur de la personne qui a mis à jour le message
  • horodatage de l’envoi du message original
  • contenu du message original, avant toute modification. Le message modifié apparaîtra dans la section Messages dans le fil de la conversation.

Voici un exemple :

[2020-04-20 13:47:27]  mis à jour [2020-04-20 13:47:09]  Bienvenue dans le canal de l’équipe de vente !


Comment lire un message supprimé

Fichiers JSON

Fichiers TXT

Les membres peuvent supprimer des messages qu’ils ont partagés avec un canal. Si vos règles de conservation autorisent la création de journaux de suppression, un message supprimé affichera la valeur "previous" avec les informations suivantes :

  • "text"
    Le texte du message supprimé.
  • "ts"
    horodatage de la suppression du message. Vous pouvez utiliser n’importe quel convertisseur d’horodatage Unix en ligne pour convertir l’horodatage.

Chaque suppression de message sera consignée dans le fichier correspondant à la date à laquelle elle a été effectuée. Voici un exemple :

{
       "type": "message",
       "user": "UTXHL6F8A",
       "upload": false,
       "ts": "1590101824.000000",
       "text": "",
       "previous": {
           "text": "Voici un message ayant été supprimé.",
           "blocks": [
               {
                   "type": "rich_text",
                   "block_id": "ABSkQ",
                   "elements": [
                       {
                           "type": "rich_text_section",
                           "elements": [
                               {
                                   "type": "text",
                                   "text": "Voici un message ayant été supprimé."
                               }
                           ]
                       }
                   ]
               }
           ]
       },
       "original_ts": "1590101818.000600",
       "subtype": "message_deleted",
       "editor_id": "UTXHL6F8A"
   }

Les messages supprimés apparaîtront à la fin du fichier TXT de la conversation sous l’en-tête Modification des messages. Les messages supprimés contiendront les éléments qui suivent :

  • horodatage (en GMT) de la suppression du message
  • nom d’utilisateur de la personne qui a supprimé le message
  • horodatage de l’envoi du message original
  • contenu du message original.

Voici à quoi peut ressembler un message supprimé :

[2020-04-20 13:47:47]  supprimé [2020-04-20 13:47:42]  La semaine dernière, nous avons réalisé un chiffre d’affaires de X !


Comment consulter des fichiers

Fichiers JSON

Fichiers TXT

Les fichiers d’exportation Slack au format JSON ne contiennent aucun fichier de l’espace de travail. Ils incluent des liens de fichiers, disponibles dans les fichiers JSON d’historique des messages de votre fichier d’exportation, qui redirigent vers les fichiers de l’espace de travail. Pour ouvrir les fichiers, copiez les liens du fichier JSON et collez-les dans votre navigateur.

Procédez comme suit pour rechercher un fichier spécifique :

  1. Ouvrez le dossier correspondant à la conversation dans laquelle le fichier a été partagé.
  2. Recherchez le fichier JSON correspondant à la date à laquelle le fichier a été partagé.
  3. Le lien de fichier apparaîtra dans les détails du message dans lequel il a été partagé, dans la section "files:".

Remarque : si vous supprimez un fichier, ou bien le canal ou l’espace de travail dans lequel il a été partagé, celui-ci ne sera plus accessible via le lien de fichier dans votre exportation.

Le dossier fichiers de votre fichier ZIP contient les fichiers envoyés par l’utilisateur unique sélectionné dans votre exportation. Les titres des fichiers apparaîtront dans vos fichiers TXT canaux et messages directs dans le fil d’une conversation, comme suit :

[2020-04-20 13:47:27] jjordan a partagé le(s) fichier(s) F01243S814M

Procédez comme suit pour rechercher un fichier spécifique :

  1. Ouvrez le fichier TXT correspondant à la conversation dans laquelle le fichier a été partagé.
  2. Localisez le fichier que vous souhaitez ouvrir dans l’historique des messages et prenez note du titre du fichier correspondant (ex. : F01243S814M).
  3. Ouvrez le dossier des fichiers et sélectionnez le titre du fichier pour l’ouvrir.


Comment consulter les canevas

Fichiers JSON

Fichiers TXT

Les fichiers d’exportation Slack au format JSON incluront un fichier spécifique qui contient des liens pour télécharger tous les canevas disponibles en HTML.

Canevas

Voici comment trouver un canevas :

  1. Ouvrez canvases.json et recherchez le titre d’un canevas.
  2. Repérez le url_private_download dans les détails qui correspondent à votre canevas.
  3. Collez l’URL dans un navigateur pour télécharger le canevas et lire son contenu.
  {
    "id": "F05UA7XQXHS",
    "created" : 1695846651,
    "name": "This_canvas_is_shared_in_General",
    "title" : "This canvas is shared in General",
    "mimetype" : "application/vnd.slack-docs",
    "filetype" : "quip",
    "pretty_type" : "Canvas",
    "user": "U018Y4QJK0E",
    "editable": true,
    "size": 48,
    "mode": "quip",
    "is_public": true,
    "is_tombstoned": false,
    "public_url_shared": false,
    "date_delete": 0,
    "url_private_download": "https://files.slack.com/files-pri/T019B299WNQ-F05UA7XQXHS/download/canvas?t=xoxe-1317077336772-EXAMPLE-TOKEN-INFO",
    "shares": [
      {
        "team": "T019B299WNQ",
        "channel": "C019UMH0P40"
      }

Canevas du canal

Voici comment trouver un canevas de canal :

  1. Ouvrez le dossier de la conversation dans le canevas du canal.
  2. Repérez le fichier canvas_in_the_conversation.json, qui contient url_private_download.
  3. Collez l’URL dans un navigateur pour télécharger le canevas et lire son contenu.
{
    "id": "F05U12FNWT0",
    "created" : 1695845524,
    "name": "GENERAL_CHANNEL_CANVAS",
    "title" : "GENERAL CHANNEL CANVAS",
    "mimetype": "application\/vnd.slack-docs",
    "filetype" : "quip",
    "pretty_type" : "Canvas",
    "user": "USLACKBOT",
    "editable": true,
    "size": 17,
    "mode": "quip",
    "is_public": true,
    "is_tombstoned": false,
    "public_url_shared": false,
    "date_delete": 0,
    "url_private_download": "https:\/\/files.slack.com\/files-pri\/T019B299WNQ-F05U12FNWT0\/download\/canvas?t=xoxe-1317077336772-EXAMPLE-TOKEN-INFO",
    "shares": [
        {
            "team": "T019B299WNQ",
            "channel": "C019UMH0P40"
        }

Commentaires de canevas

Les commentaires d’un canevas peuvent être exportés dans leurs propres dossiers dans votre fichier d’exportation. Voici comment associer les commentaires aux canevas dans un fichier d’exportation :

  1. Ouvrez file_conversations.json et recherchez le titre d’un canevas.
  2. Dans le champ "name":, notez l’identifiant FC ou le canevas dont vous souhaitez voir les commentaires (par exemple FC:F05UA7XQXHS).
  3. Revenez à votre exportation et localisez le dossier ayant un identifiant FC correspondant.
  4. Ouvrez le dossier FC pour consulter les commentaires du canevas. Les commentaires seront triés par date d’ajout.
{
    "id": "C05UA7XQXHS",
    "name": "FC:F05UA7XQXHS:This canvas is shared in General",
    "created" : 1695846691,
    "creator": "USLACKBOT",
    "is_archived": false,
    "members": [
        "U018Y4QJK0E"
    ],
    "topic": {
        "value": "",
        "creator": "",
        "last_set": 0
    },
    "purpose": {
        "value": "",
        "creator": "",
        "last_set": 0
    }

Lorsque l’utilisateur ciblé a interagi avec un canevas ou est membre d’un canal où un canevas a été partagé, l’exportation au format TXT contiendra les fichiers et dossiers suivants liés aux canevas :

  • canvas_in_the_conversation.txt
    Ce fichier se trouve dans chaque dossier de conversation et contient un lien permettant de télécharger le canevas de cette conversation.
  • Canvases 
    Ce dossier contient des sous-dossiers uniques pour chaque canevas auquel l’utilisateur ciblé a accès. Dans les dossiers, vous pouvez accéder au canevas au format HTML.
  • Fichiers
    Ce dossier contient des sous-dossiers uniques pour chaque canevas qui contient un fichier intégré auquel l’utilisateur ciblé a accès.

Procédez comme suit pour rechercher un canevas spécifique :

  1. Ouvrez le dossier des Canevas pour consulter une liste de tous les canevas auquel l’utilisateur ciblé peut accéder, organisée en dossiers individuels.
  2. Ouvrez le dossier dans lequel vous souhaitez afficher le canevas, puis ouvrez le fichier HTML du canevas.

Remarque : vous devrez également faire référence aux dossiers FC pour localiser les liens de fichiers ou de sites web qui ont été intégrés dans le canevas, lorsqu’un lien de message est affiché sous forme de carte ou lorsqu’un utilisateur est mentionné.