Como ler exportações de dados do Slack

Após a exportação dos dados do workspace, é possível baixar um arquivo ZIP para acessar o histórico de mensagens e os links de arquivos.  


Formatos de exportações

O formato da exportação depende do tipo de exportação que você executar:

  • Somente canais públicos: Os dados serão exportados em formato JSON.
  • Todos os canais e as conversas: Os dados serão exportados em formato JSON.
  • Conversas e canais de usuário único: Os dados podem ser exportados em formato JSON ou TXT.


O que há no arquivo de exportação

Arquivos JSON

Arquivos TXT

Quando a exportação estiver pronta, você baixará um arquivo ZIP com os dados do seu workspace e diversos links de arquivos que direcionam de volta para os arquivos do workspace. Dependendo do tipo de exportação, seu arquivo ZIP incluirá:

  Somente canais públicos Todos os canais e as conversas
Canais (channels.json)

Mensagens diretas (dms.json)  

Canais privados (groups.json)  

Registros de atividade do app (integration_logs.json)

Mensagens diretas de grupo (mpims.json)  

Membros (users.json)*

Pastas para todos os canais públicos

Pastas para todos os canais privados

 

Pastas para todas as mensagens diretas

 

*Se você exportar dados de uma organização Enterprise Grid, o título desta pasta será org_users.json

Dica: no plano Enterprise Grid, é possível escolher exportar os dados de toda a organização ou de um workspace específico. As exportações de um workspace específico incluem canais públicos e privados no workspace selecionado, mas não canais de vários workspaces.

Se você optar por exportar dados de conversas de um usuário único em formato TXT, deverá baixar um arquivo ZIP, após a conclusão da exportação, com todas as mensagens e os arquivos enviados pelo usuário que você selecionou. O arquivo ZIP terá três pastas:

  • canais
  • MDs
  • relacionados

Cada pasta incluirá um conjunto de arquivos TXT com o histórico de uma conversa ou os arquivos enviados por um usuário único durante o intervalo de datas selecionado.

Observação: se você selecionar um intervalo de datas para uma exportação, o Slack retornará todas as conversas das quais o usuário tiver participado, até mesmo se nenhuma mensagem tiver sido enviada nas conversas durante o período indicado. Nesse caso, o canal não mostrará mensagens no arquivo de exportação.


Navegar no arquivo de exportação

Arquivos JSON

Arquivos TXT

Quando você abrir o arquivo de exportação ZIP, cada canal ou mensagem direta terá sua própria pasta. Cada pasta contém mensagens da conversa, organizadas por data em arquivos JSON separados. 

Você verá arquivos de referência para diferentes tipos de conversas: arquivos channels.json para canais públicos, arquivos groups.json para canais privados, e arquivos dms.json para mensagens diretas. Esses arquivos contêm os IDs de usuário e de canal. Para localizar uma conversa específica, você precisará usar os arquivos de canal e de referência. Por exemplo, para localizar uma mensagem específica, você pode fazer o seguinte: 

  1. Abra o arquivo users.json e pesquise os usuários em questão. Anote os IDs deles. 
  2. Em seguida, abra o arquivo channels.json, groups.json ou dms.json e pesquise a conversa que inclua esses dois IDs na seção de membros. Anote o ID da conversa ou o nome do canal para a conversa em questão. 
  3. Na pasta de exportação principal, localize a pasta que tem como título o nome do canal ou o ID da conversa em questão. Você encontrará vários arquivos JSON nessa pasta — um para cada data em que foram enviadas mensagens.

Observação: O arquivo de exportação só conterá uma pasta se houver mensagens no intervalo de datas que você exportou. Por exemplo, se sua política de retenção estiver configurada para excluir mensagens em canais públicos após 30 dias, e você selecionar um intervalo de datas situado mais de 31 dias atrás, sua exportação não incluirá pastas para canais públicos.

Cada pasta no arquivo ZIP terá dados diferentes do workspace. A pasta de canais incluirá um arquivo TXT de cada canal e mensagem direta em grupo dos quais um usuário único tiver participado. A pasta de MDs incluirá um arquivo TXT de todas as mensagens diretas individuais das quais um usuário único tiver participado.

Os arquivos TXT de conversas serão nomeados de acordo com o nome do canal ou dos membros da mensagem direta. Por exemplo, o arquivo de dados do canal #geral será geral.txt. O arquivo de dados de uma mensagem direta, por sua vez, será esantos-ssilveira.txt.

Para ver as mensagens de uma conversa específica, você pode fazer o seguinte:

  1. Abra a pasta de canais ou MDs.
  2. Abra o arquivo TXT do canal ou da mensagem direta que você gostaria de ver.

Após abrir o arquivo TXT, você verá o histórico de mensagens da conversa no cabeçalho Mensagens. O histórico incluirá as mensagens enviadas pelo usuário único na exportação e por outros usuários na conversa.

Observação: mensagens editadas e excluídas só serão exibidas no arquivo de exportação se a política de retenção estiver configurada para mantê-las.


Como ler mensagens 

Arquivos JSON

Arquivos TXT

Cada mensagem inclui os seguintes campos:

  • "type": 
    indica que os dados se referem a uma mensagem
  • "user": 
    o ID do membro que enviou a mensagem
  • "text": 
    o texto real da mensagem
  • "ts": 
    a data e a hora em que a mensagem foi postada Você pode usar qualquer conversor de horário unix on-line para traduzir a data e a hora.

As mensagens serão registradas no arquivo de data associado à data em que a mensagem foi enviada. Uma mensagem bem simples tem uma aparência assim:

{
   "type": "message",
   "user": "U2147483697",
   "text": "Olá, mundo!",
   "ts": "1355517523.000005"
}

Observação: Algumas mensagens também poderão incluir um valor "attachments". Esse valor contém uma lista de objetos anexados à mensagem. 

Dica: você pode traduzir os IDs alfanuméricos dos campos "channel" e "user" fazendo referência aos arquivos channels.json e users.json.

Subtipos de mensagem

Além das mensagens que os membros compartilham no Slack, há subtipos de mensagens. Essas são mensagens postadas por apps, bots ou integrações. Elas também podem ser mensagens exibidas quando um membro entra em um canal. Aqui está uma lista completa dos subtipos de mensagens:

 

Type Descrição
bot_message Uma mensagem foi postada por um app ou uma integração
me_message Uma mensagem foi enviada com o comando de barra /eu
message_changed Uma mensagem foi alterada
message_deleted Uma mensagem foi excluída
channel_join Um membro entrou em um canal
channel_leave Um membro saiu de um canal
channel_topic O assunto de um canal foi atualizado
channel_purpose O objetivo de um canal foi atualizado
channel_name Um canal foi renomeado
channel_archive Um canal foi arquivado
channel_unarchive Um canal foi desarquivado
group_join Um membro entrou em um grupo
group_leave Um membro saiu de um grupo
group_topic O assunto de um grupo foi atualizado
group_purpose O objetivo de um grupo foi atualizado
group_name Um grupo foi renomeado
group_archive Um grupo foi arquivado
group_unarchive Um grupo foi desarquivado
file_share Um arquivo foi compartilhado em um canal
file_reply Uma resposta foi adicionada a um arquivo
file_mention Um arquivo foi mencionado em um canal
pinned_item Um item foi fixado em um canal
unpinned_item Um item foi desafixado de um canal

 

Itens salvos, itens fixados e reações

As mensagens podem ter propriedades adicionais para mostrar se alguém interagiu com ela.

  • Se houver "is_starred": true, isso significa que um membro salvou a mensagem. Se ninguém tiver salvo a mensagem, você não verá esse valor.
  • Se uma mensagem for fixada em algum lugar, você verá os IDs dos locais ao lado de "pinned_to".
  • Se houver o valor "reactions", serão listadas todas as reações de emoji que foram adicionadas à mensagem ("name"), o número de membros que reagiram ("count") e uma lista de membros que reagiram ("users").
{
   "type": "message",
   "canal": "C2147483705",
   "user": "U2147483697",
   "text": "Olá, mundo!",
   "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" ]
       }

Observação: o valor "reactions" talvez não liste todos os membros que reagiram a uma mensagem, mas o valor "count" sempre mostrará o número real de membros que reagiram.

As mensagens serão exibidas na ordem em que foram enviadas na conversa. As mensagens incluem:

  • A data e a hora (em GMT) em que a mensagem foi enviada.
  • O nome de usuário no Slack de quem enviou a mensagem.
  • O conteúdo da mensagem.

Veja como fica uma mensagem simples:

[2020-04-20 13:47:27] <ssilveira> Boas-vindas ao canal da equipe de vendas! Nossa equipe está crescendo a um ritmo mais rápido do que nunca.

No arquivo de exportação, não haverá diferença entre as mensagens enviadas a um canal e as de uma conversa. Todas as mensagens de uma conversa serão exibidas na ordem em que foram enviadas, misturadas com o restante das mensagens.

Dica: quando uma pessoa for mencionada em uma mensagem, não haverá o símbolo @ antes do nome exibido.


Como ler uma mensagem editada

Arquivos JSON

Arquivos TXT

Os membros podem editar mensagens que compartilharam em um canal. Se sua opção de exportação permitir registros de edição, uma mensagem editada terá o valor "edited" com as seguintes informações:

  • "user"
    O ID do membro que fez a alteração
  • "ts"
    A data e a hora em que a mensagem foi editada. Você pode usar qualquer conversor de horário unix on-line para traduzir a data e a hora.

Essas edições serão registradas no arquivo de data associado à data em que a edição ocorreu. Veja um exemplo:

{
        "type": "message",
        "user": "UTXHL6F8A",
        "upload": false,
        "ts": "1590101612.000000",
        "text": "Olá, esta é a mensagem editada.",
        "previous": {
            "text": "Olá, esta é a mensagem original.",
            "blocks": [
                {
                    "type": "rich_text",
                    "block_id": "Bts",
                    "elements": [
                        {
                            "type": "rich_text_section",
                            "elements": [
                                {
                                    "type": "text",
                                    "text": "Olá, esta é a mensagem original."
                                }
                            ]
                        }
                    ]
                }
            ]
        },
        "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": "Olá, esta é a mensagem editada."
                            }
                        ]
                    }
                ]
            }
        ]
    }

As mensagens editadas serão exibidas no final do arquivo TXT de uma conversa, no cabeçalho Edições de mensagens. As mensagens editadas incluem:

  • A data e a hora (em GMT) em que a mensagem foi editada.
  • O nome de usuário de quem atualizou a mensagem.
  • A data e a hora em que a mensagem original foi enviada.
  • O conteúdo da mensagem original, antes de qualquer edição. A mensagem editada será exibida na seção Mensagens na ordem em que foi enviada.

Veja um exemplo:

[2020-04-20 13:47:27] <ssilveira> atualizada [2020-04-20 13:47:09] <ssilveira> Boas-vindas ao canal da equipe de vendas!


Como ler uma mensagem excluída

Arquivos JSON

Arquivos TXT

Os membros podem excluir mensagens que compartilharam em um canal. Se suas políticas de retenção permitirem registros de exclusão, as mensagens excluídas terão um valor "previous" e as seguintes informações:

  • "text"
    O texto da mensagem excluída
  • "ts"
    A data e a hora em que a mensagem foi excluída. Você pode usar qualquer conversor de horário unix on-line para traduzir a data e a hora.

A exclusão de mensagens será registrada no arquivo de data associado à data em que a mensagem foi excluída. Veja um exemplo:

{
       "type": "message",
       "user": "UTXHL6F8A",
       "upload": false,
       "ts": "1590101824.000000",
       "text": "",
       "previous": {
           "text": "Esta é uma mensagem que foi excluída.",
           "blocks": [
               {
                   "type": "rich_text",
                   "block_id": "ABSkQ",
                   "elements": [
                       {
                           "type": "rich_text_section",
                           "elements": [
                               {
                                   "type": "text",
                                   "text": "Esta é uma mensagem que foi excluída."
                               }
                           ]
                       }
                   ]
               }
           ]
       },
       "original_ts": "1590101818.000600",
       "subtype": "message_deleted",
       "editor_id": "UTXHL6F8A"
   }

As mensagens excluídas serão exibidas no final do arquivo TXT de uma conversa, no cabeçalho Edições de mensagens. As mensagens excluídas incluem:

  • A data e a hora (em GMT) em que a mensagem foi excluída.
  • O nome de usuário de quem excluiu a mensagem.
  • A data e a hora em que a mensagem original foi enviada.
  • O conteúdo da mensagem original.

Veja como fica uma mensagem excluída:

[2020-04-20 13:47:47] <ssilveira> excluída [2020-04-20 13:47:42] <ssilveira> Semana passada, fizemos uma venda de X!


Como ver os arquivos

Arquivos JSON

Arquivos TXT

Os arquivos de exportação do Slack em formato JSON não têm arquivos do workspace. Eles incluem uma série de links de arquivos, localizados nos arquivos JSON do histórico de mensagens do seu arquivo de exportação, que direcionam de volta para os arquivos do workspace. Copie esses links de arquivos do arquivo JSON e cole-os no seu navegador para abrir os arquivos.

Eis aqui como localizar um arquivo específico:

  1. Abra a pasta da conversa na qual o arquivo foi compartilhado.
  2. Localize o arquivo JSON que corresponde à data em que o arquivo foi compartilhado.
  3. você verá o link do arquivo nos detalhes da mensagem em que ele foi compartilhado, na seção "files:".

Observação: se você excluir um arquivo ou o canal ou workspace em que ele foi compartilhado, o arquivo não poderá mais ser acessado pelo do link de arquivo da sua exportação.

A pasta de arquivos do ZIP tem arquivos enviados pelo usuário único selecionado na exportação. Os títulos deles serão exibidos nos arquivos TXT de canais e MDs seguindo a ordem de uma conversa, da seguinte maneira:

[2020-04-20 13:47:27] ssilveira compartilhou arquivo(s) F01243S814M

Eis aqui como localizar um arquivo específico:

  1. Abra o arquivo TXT da conversa na qual o arquivo foi compartilhado.
  2. Localize o arquivo que gostaria de abrir no histórico de mensagens e anote o título do arquivo correspondente (por exemplo, F01243S814M).
  3. Abra a pasta de arquivos e selecione o título do arquivo para abri-lo.