Leggere le esportazioni dei dati di Slack

Dopo aver esportato i dati della tua area di lavoro, puoi scaricare un file ZIP per accedere alla cronologia dei messaggi e ai link ai file.  


Formati di esportazione

Il formato di esportazione dipende dal tipo di esportazione che esegui:

  • Solo canali pubblici: I dati saranno esportati in formato JSON.
  • Tutti i canali e le conversazioni: I dati saranno esportati in formato JSON.
  • Canali e conversazioni di un utente singolo: I dati possono essere esportati nei formati JSON o TXT.


Cosa contengono i file di esportazione

File JSON

File TXT

Dopo aver portato a termine l’esportazione, potrai scaricare un file ZIP con i dati dell’area di lavoro e una serie di link a file che reindirizzano ai file dell’area di lavoro. A seconda del tipo di esportazione, il file ZIP includerà:

  Solo canali pubblici Tutti i canali e le conversazioni
Canali (channels.json)

Messaggi diretti (dms.json)  

Canali privati (groups.json)  

Registri delle attività delle app (integration_logs.json)

Messaggi diretti di gruppo (mpims.json)  

Membri (users.json)*

Contenuti contrassegnati† (content_flags.json)

 

Cartelle per ciascun canale pubblico

Cartelle per ciascun canale privato

 

Cartelle per ciascun messaggio diretto

 

Un URL per ogni canvas (canvases.json)**

*Se esporti dati da un'organizzazione Enterprise Grid, questa cartella sarà denominata org_users.json
** Se esporti dati solo da canali pubblici, questa cartella conterrà solo canvas condivisi in canali pubblici.
† Disponibili solo per i piani Enterprise Grid in cui è abilitato il contenuto contrassegnato.

Suggerimento: con il piano Enterprise Grid, puoi scegliere di esportare i dati per l’intera organizzazione o per un’area di lavoro specifica. Le esportazioni per un’area di lavoro specifica includono i canali pubblici e privati dell’area di lavoro selezionata, ma non i canali per più aree di lavoro.

Se scegli di esportare i dati per le conversazioni di un utente singolo in formato TXT, quando l’esportazione sarà completata scaricherai un file ZIP con tutti i messaggi e i file inviati dall’utente che hai selezionato. Il file ZIP conterrà tre cartelle:

  • creare canali
  • MD
  • file

Ogni cartella conterrà un insieme di file TXT con la cronologia di una conversazione oppure i file inviati da un utente singolo nell’intervallo di date selezionato.

Nota: se applichi un intervallo di date a un’esportazione, Slack restituirà ogni conversazione di cui l’utente ha fatto parte, anche se non sono stati inviati messaggi in quella conversazione durante le date selezionate. In questo caso, il canale non mostrerà messaggi nel file di esportazione.


Navigare nel file di esportazione

File JSON

File TXT

Quando apri il file ZIP di esportazione, ciascun canale o messaggio diretto avrà la sua cartella. Ciascuna cartella conterrà i messaggi della conversazione, suddivisi per data in una serie di file JSON separati.

Visualizzerai i file di riferimento per i diversi tipi di conversazione: i file channels.json per i canali pubblici, i file groups.json per i canali privati e quelli dms.json per i messaggi diretti. Questi file conterranno l’ID dell’utente e del canale. Per rintracciare una determinata conversazione dovrai utilizzare sia il file del canale sia quelli di riferimento. Ad esempio, per trovare un messaggio specifico potresti seguire questi passaggi: 

  1. Apri il file users.json e cerca gli utenti che ti interessano. Prendi nota dei loro ID. 
  2. A questo punto apri i file channels.json, groups.json o dms.json e cerca la conversazione che include questi due ID nella sezione members. Prendi nota del nome del canale o dell’ID di quella conversazione. 
  3. Nella cartella di esportazione principale, cerca la cartella con il titolo che contiene quel nome del canale o l’ID di quella conversazione. Nella cartella troverai vari file JSON, uno per ciascuna data in cui sono stati inviati i messaggi.

Nota: la cartella verrà inclusa nel file di esportazione solo se sono presenti dei messaggi relativi all’intervallo di date che hai esportato. Ad esempio, se i criteri di conservazione prevedono l’eliminazione dei messaggi dei canali pubblici dopo 30 giorni e hai selezionato una data che si riferisce a oltre 31 giorni fa, il file di esportazione non conterrà alcuna cartella per i canali pubblici.

Ogni cartella nel file ZIP conterrà diversi dati dell’area di lavoro. La cartella canali conterrà un file TXT per ogni canale e messaggio diretto di gruppo di cui un utente ha fatto parte. La cartella md conterrà un file TXT per ogni messaggio diretto tra due persone di cui un utente ha fatto parte.

Il nome dei file TXT per le conversazioni corrisponderà al nome del canale o ai nomi utenti dei membri di un messaggio diretto. Per esempio, i dati del canale #generale saranno contenuti nel file generale.txt. I dati di un messaggio diretto potrebbero essere contenuti nel file mcollins-jjordan.txt.

Per visualizzare i messaggi da un conversazione specifica, puoi seguire questi passaggi:

  1. Apri la cartella canali o md.
  2. Apri il file TXT per il canale o per il messaggio diretto che vuoi visualizzare.

Una volta aperto il file TXT, vedrai la cronologia dei messaggi della conversazione sotto l’intestazione Messaggi. La cronologia dei messaggi includerà i messaggi inviati dall’utente singolo dell’esportazione e da tutti gli altri utenti nella conversazione.

Nota: i messaggi modificati o eliminati saranno inclusi nel file di esportazione solo se i criteri di conservazione sono configurati per conservarli.


Come leggere i messaggi 

File JSON

File TXT

Tutti i messaggi contengono i seguenti campi:

  • “type”: 
    Indica che i dati si riferiscono a un messaggio
  • “user”: 
    L’ID del membro che ha inviato il messaggio
  • "text": 
    Il testo del messaggio
  • "ts": 
    Il timestamp della pubblicazione del messaggio. Per trasformare il timestamp, puoi utilizzare un convertitore online Unix.

I messaggi verranno registrati nel file corrispondente alla data in cui è stato inviato il messaggio. Ecco come verrà visualizzato un messaggio semplice:

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

Nota: alcuni messaggi potrebbero anche comprendere un valore “attachments”. Questo valore contiene una lista di oggetti allegati al messaggio. 

Suggerimento: è possibile convertire gli ID alfanumerici del campo “channel” e “user” facendo riferimento ai file channels.json e users.json.

Sottotipi dei messaggi

Oltre ai messaggi che i membri condividono su Slack, esistono dei sottotipi di messaggi: i messaggi postati da app, bot o integrazioni, oppure i messaggi che vedi quando un membro entra in un canale. Ecco l’elenco completo dei sottotipi dei messaggi:

 

Tipo Descrizione
messaggio_bot Un messaggio postato tramite un’app o un’integrazione
messaggio_me Un messaggio inviato con il comando slash /me
messaggio_modificato Un messaggio che è stato modificato
message_deleted Un messaggio che è stato eliminato
accesso_canale Un membro è entrato in un canale
uscita_canale Un membro è uscito da un canale
argomento_canale Un argomento del canale è stato aggiornato
scopo_canale Una descrizione del canale è stata aggiornata
nome_canale Un canale è stato rinominato
canale_archiviato Un canale è stato archiviato
annullamento_archiviazione_canale È stata annullata l’archiviazione di un canale
entrata_canale Un membro è entrato in un gruppo
uscita_gruppo Un membro è uscito dal gruppo
argomento_gruppo L’argomento del gruppo è stato aggiornato
scopo_gruppo Lo scopo del gruppo è stato aggiornato
nome_gruppo Un gruppo è stato rinominato
archiviazione_gruppo Un gruppo è stato archiviato
archiviazione_gruppo_annullata È stata annullata l’archiviazione del gruppo
condivisione_file Un file è stato condiviso in un canale
risposta_file È stata aggiunta una risposta a un file
tag_file Un file è stato taggato in un canale
elemento_fissato Un elemento è stato fissato in un canale
elemento_sbloccato Un elemento è stato sbloccato da un canale

 

Elementi salvati, fissati e reazioni

Un messaggio può mostrare altre proprietà se qualcuno ci interagisce.

  • Se “is_starred”: true, vuol dire che un membro ha salvato il messaggio. Se nessuno ha salvato il messaggio non visualizzerai questo valore.
  • Se il messaggio è stato fissato da qualche parte, visualizzerai l’ID della sua posizione accanto a “pinned_to”.
  • Se “reactions” è presente, elencherà tutte le reazioni con emoji che sono state aggiunte al messaggio (“name”), il numero di membri che hanno reagito (“count”) e l’elenco dei membri che hanno reagito (“users”).
{
   "type": "message",
   "channel": "C2147483705",
   "user": "U2147483697",
   "text": "Hello world",
   "ts": "1355517523.000005",
   "is_starred": true,
   "pinned_to": ["C024BE7LT", ...],
   "reactions": [
       {
           "name": "astonished",
           "totale": 3,
           "utenti": [ "U1", "U2", "U3" ]
       },
       {
           "nome": "facepalm",
           "totale": 1034,
           "utenti": [ "U1", "U2", "U3", "U4", "U5" ]
       }

Nota: il valore "reactions" potrebbe non riportare tutti i membri che hanno reagito al messaggio ma il valore "count" mostrerà sempre il numero di volte in cui la reazione è stata utilizzata.

I messaggi compariranno nell’ordine in cui erano stati inviati nella conversazione. I messaggi includono gli elementi seguenti:

  • Il timestamp (in GMT) dell’invio del messaggio.
  • Il nome utente Slack della persona che ha inviato il messaggio.
  • Il contenuto del messaggio.

Ecco come sarà visualizzato un messaggio semplice:

2020-04-20 13:47:27]  Ti diamo il benvenuto nel canale del team di vendita. Il nostro team sta crescendo più velocemente che mai!

Il file di esportazione non applica una distinzione tra i messaggi in una conversazione e i messaggi inviati in un canale. Tutti i messaggi in una conversazione compariranno nel flusso della conversazione.


Come leggere un messaggio modificato

File JSON

File TXT

I membri possono modificare i messaggi che hanno condiviso su un canale. Se l’opzione di esportazione consente di modificare i registri, un messaggio modificato avrà un valore "edited" con le seguenti informazioni:

  • "utente"
    L’ID del membro che ha effettuato la modifica.
  • "ts"
    Il timestamp della modifica del messaggio. Per trasformare il timestamp, puoi utilizzare un convertitore online Unix.

Le modifiche verranno registrate nel file relativo alla data in cui è avvenuta la modifica. Ecco un esempio:

{
        "type": "message",
        "user": "UTXHL6F8A",
        "caricamento": falso,
        "ts": "1590101612.000000",
        "text": "Questo è il messaggio dopo essere stato modificato.",
        "precedente": {
            "text": "Questo è il messaggio originale.",
            "blocchi": [
                {
                    "tipo": "rtf",
                    "id_blocco": "Bts",
                    "elementi": [
                        {
                            "tipo": "sezione_rtf",
                            "elementi": [
                                {
                                    "tipo": "testo",
                                    "text": "Questo è il messaggio originale."
                                }
                            ]
                        }
                    ]
                }
            ]
        },
        "ts_originale": "1590101603.000300",
        "sottotipo": "messaggio_modificato",
        "id_modificatore": "UTXHL6F8A",
        "blocchi": [
            {
                "tipo": "rtf",
                "id_blocco": "O+PJ",
                "elementi": [
                    {
                        "tipo": "sezione_rtf",
                        "elementi": [
                            {
                                "tipo": "testo",
                                "text": “Hello, this is the message after it was edited.”
                            }
                        ]
                    }
                ]
            }
        ]
    }

I messaggi modificati compariranno alla fine del file TXT di una conversazione, sotto l’intestazione Modifiche ai messaggi. I messaggi modificati includono gli elementi seguenti:

  • Il timestamp (in GMT) della modifica del messaggio.
  • Il nome utente della persona che ha aggiornato il messaggio.
  • Il timestamp dell’invio originale del messaggio.
  • Il contenuto del messaggio originale, precedente a qualsiasi modifica. Il messaggio modificato comparirà nella sezione Messaggi nel flusso della conversazione.

Ecco un esempio:

[2020-04-20 13:47:27]  ha aggiornato [2020-04-20 13:47:09]  Ti diamo il benvenuto nel canale del team di vendita!


Come leggere un messaggio eliminato

File JSON

File TXT

I membri possono eliminare i messaggi che hanno condiviso su un canale. Se i criteri di conservazione consentono l’eliminazione dei registri, un messaggio eliminato avrà un valore "previous" e le seguenti informazioni:

  • "testo"
    Il testo del messaggio eliminato.
  • "ts"
    Il timestamp dell’eliminazione del messaggio. Per trasformare il timestamp, puoi utilizzare un convertitore online Unix.

L’eliminazione dei messaggi verrà registrata nel file corrispondente alla data in cui è stato eliminato il messaggio. Ecco un esempio:

{
       "type": "message",
       "user": "UTXHL6F8A",
       "caricamento": falso,
       "ts": "1590101824.000000",
       "testo": "",
       "precedente": {
           "text": “This is a message that has been deleted.”,
           "blocchi": [
               {
                   "tipo": "rtf",
                   "id_blocco": "ABSkQ",
                   "elementi": [
                       {
                           "tipo": "sezione_rtf",
                           "elementi": [
                               {
                                   "tipo": "testo",
                                   "text": “This is a message that has been deleted.”
                               }
                           ]
                       }
                   ]
               }
           ]
       },
       "ts_originale": "1590101818.000600",
       "sottotipo": "messaggio_eliminato",
       "id_modificatore": "UTXHL6F8A"
   }

I messaggi eliminati compariranno alla fine del file TXT di una conversazione, sotto l’intestazione Modifiche ai messaggi. I messaggi eliminati includono gli elementi seguenti:

  • Il timestamp (in GMT) dell’eliminazione del messaggio.
  • Il nome utente della persona che ha eliminato il messaggio.
  • Il timestamp dell’invio originale del messaggio.
  • Il contenuto del messaggio originale.

Ecco come sarà visualizzato un messaggio eliminato:

[2020-04-20 13:47:47]  ha eliminato [2020-04-20 13:47:42]  La settimana scorsa il team di vendita ha fatturato X!


Come leggere il contenuto contrassegnato 

Nelle organizzazioni Enterprise Grid con il contenuto contrassegnato abilitato, i messaggi contrassegnati e tutti i commenti lasciati dai revisori verranno inclusi in un'esportazione di Tutti i canali e le conversazioni.

File JSON

File TXT

L’esportazione conterrà una cartella content_flags. All'interno della cartella saranno presenti singoli file JSON per ogni messaggio contrassegnato. I file JSON includono le seguenti informazioni:
  • "flagger_user_id"
    L’ID dell’utente che ha contrassegnato il messaggio.
  • "content_user_id"
    L’ID dell’utente che ha scritto il messaggio contrassegnato.
  • "date_created"
    Il timestamp in cui il messaggio è stato contrassegnato.
  • "comments"
    Eventuali commenti lasciati dai revisori, inclusi dettagli come timestamp, chi ha lasciato il commento e se il commento è stato eliminato.
  • "flagged_message"
    I dettagli del messaggio contrassegnato, inclusi il contenuto del messaggio, le informazioni sul profilo dell'autore del messaggio e lo stato di revisione.

Ecco un esempio:

[
{
    "flag": {
        "id": "Fg016WC7RU9Z",
        "flagger_team_id": "E019B299WNQ",
        "flagger_user_id": "UTXHL6F8A",
        "content_user_id": "U014QD5SE67",
        "content_team_id": "T019B299WNQ",
        "date_created": 1727216082
    },
    "comments": [],
    "flagged_message": {
        "subtype": "moderated",
        "text": "This is the content of a message that was flagged for review",
        "user": "U014QD5SE67",
        "hidden": false,
        "type": "message",
        "ts": "1727216072.664659",
        "client_msg_id": "eba94731-3cf1-4005-90fa-49e0930fc9b3"
    }
}
]

Il contenuto contrassegnato non è incluso nelle esportazioni .TXT.


Come visualizzare i file

File JSON

File TXT

I file di esportazione di Slack in formato JSON non contengono alcun file dell’area di lavoro. Comprendono una serie di link che si trovano nella cronologia dei messaggi dei file JSON del file di esportazione, che rimandano direttamente ai file dell’area di lavoro. Per aprire i file, copia i link al file dal file JSON e incollali nel tuo browser.

Ecco come trovare un file particolare:

  1. Apri la cartella della conversazione in cui è stata condiviso il file.
  2. Individua il file JSON che corrisponde alla data in cui è stato condiviso il file.
  3. Vedrai il link al file tra i dettagli del messaggio in cui è stato condiviso, nella sezione "files:".

Nota: se elimini un file, il canale o l’area di lavoro su cui è stato condiviso, il file non sarà più accessibile tramite il link del file di esportazione.

La cartella file del file ZIP contiene i file inviati dall’utente singolo selezionato nell’esportazione. I titoli dei file appariranno nei file TXT canali e md nel flusso di una conversazione, in questo modo:

[2020-04-20 13:47:27] jjordan ha condiviso il file F01243S814M

Ecco come trovare un file particolare:

  1. Apri il file TXT della conversazione in cui è stato condiviso il file.
  2. Trova il file che vuoi aprire nella cronologia dei messaggi e annota il titolo del file corrispondente (per esempio: F01243S814M).
  3. Apri la cartella dei file e seleziona il titolo del file per aprirlo.


Come visualizzare i canvas

File JSON

File TXT

I file di esportazione di Slack in formato JSON includeranno un file specifico che contiene i link per scaricare tutti i canvas disponibili in HTML.

Canvas

Ecco come trovare un canvas:

  1. Apri il file canvases.json e cerca il titolo di un canvas.
  2. Individua il file url_private_download nei dettagli che corrispondono al tuo canvas.
  3. Incolla questo URL in un browser per scaricare il canvas e leggerne il contenuto.
  {
    "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"
      }

Canvas del canale

Ecco come trovare un canvas del canale:

  1. Apri la cartella delle conversazioni a cui appartiene il canvas del canale.
  2. Individua il file canvas_in_the_conversation.json, che conterrà il file url_private_download.
  3. Incolla questo URL in un browser per scaricare il canvas e leggerne il contenuto.
{
    "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"
        }

Nota: puoi scaricare la cronologia delle versioni del canvas dall'URL url_private_download se nell’area di lavoro o organizzazione sono abilitate le esportazioni di dati per tutte le conversazioni.

Commenti sui canvas

I commenti su un canvas saranno esportati nelle loro cartelle nel file di esportazione. Ecco come associare i commenti di un file di esportazione ai loro canvas:

  1. Apri il file file_conversations.json e cerca il titolo di un canvas.
  2. Nel campo "name": prendi nota dell’ID FC o del canvas per il quale desideri visualizzare i commenti (ad es. FC:F05UA7XQXHS).
  3. Torna all’esportazione e individua la cartella con l’ID FC corrispondente.
  4. Apri la cartella FC per visualizzare i commenti fatti sul canvas. I commenti saranno ordinati in base alla data in cui sono stati fatti.
{
    "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
    }

Quando l’utente interessato ha interagito con un canvas o è membro di un canale in cui è stato condiviso un canvas, l’esportazione TXT conterrà i seguenti file e cartelle relativi ai canvas:

  • canvas_in_the_conversation.txt
    Questo file si trova all’interno di ogni cartella di conversazione e contiene un link per scaricare il canvas di quella conversazione.
  • Canvases 
    Questa cartella contiene sottocartelle uniche per ogni canvas a cui l’utente ha accesso. All’interno delle cartelle, puoi accedere al canvas in formato HTML.
  • File
    Questa cartella contiene delle sottocartelle uniche per ogni canvas che contiene un file incorporato a cui l’utente interessato ha accesso.

Ecco come trovare un canvas particolare:

  1. Apri la cartella Canvases per visualizzare un elenco di tutti i canvas a cui l’utente interessato può accedere, organizzati in cartelle individuali.
  2. Apri la cartella per la quale desideri visualizzare il canvas, quindi apri il file HTML del canvas.

Nota: dovrai anche fare riferimento alle cartelle FC per individuare i link a file o web che sono stati incorporati nel canvas, quando un link a un messaggio viene visualizzato come una scheda o quando viene un utente viene taggato.