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.  


Options d’exportation

Vos options pour exporter des données dépendent de votre forfait :

  • Tous les forfaits Slack : exportez des données depuis des canaux publics au format JSON.
  • Forfaits Plus et Enterprise Grid : demandez à exporter des données depuis toutes les conversations, y compris les canaux privés et les messages directs au format JSON.
  • Forfait Enterprise Grid : demandez à exporter des données depuis toutes les conversations auxquelles participe un utilisateur au format JSON ou 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

 

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.

Avec le forfait Enterprise Grid, vous avez la possibilité de demander à accéder aux exportations de données pour un utilisateur au format TXT. Une fois votre exportation terminée, vous téléchargerez un fichier ZIP avec les données de l’espace de travail et du fichier concernant l’utilisateur que vous avez sélectionné. Votre fichier ZIP contiendra trois dossiers, canaux, messages directs et fichiers, chacun contenant 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 indiqué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 members. 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 : c’est-à-dire des messages publiés par les applis, les bots ou les intégrations, ou encore des messages que vous voyez lorsqu’un membre rejoint un canal. Veuillez consulter ci-dessous la liste complète des sous-types de messages :

 

Tapez 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 Un canal a été archivé
channel_unarchive Un canal a été 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

Les messages peuvent 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. Par contre 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] <jjordan> 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, mêlés au reste des messages.

Conseil : si une personne est mentionnée dans un message, son nom d’affichage ne sera plus précédé du symbole @.


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"
    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] <jjordan> mis à jour [2020-04-20 13:47:09] <jjordan> 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"
    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] <jjordan> supprimé [2020-04-20 13:47:42] <jjordan> 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. Copiez ces liens de fichiers à partir du fichier JSON et collez-les dans votre navigateur pour ouvrir les fichiers.

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.