O conteúdo desta página foi traduzido automaticamente. A Zoom não garante a exatidão.
Page cover
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Guia de campo do aplicativo de migração do Zoom chat

Introdução

O Guia de Campo do Aplicativo de Migração do Zoom chat é um recurso abrangente para administradores de TI, fornecendo instruções passo a passo para transferir locais de trabalho do Slack para o Zoom chat. Ele aborda processos essenciais para migrar canais públicos, canais privados e mensagens diretas, mantendo a integridade dos dados e o histórico de comunicação do usuário.

O Aplicativo de Migração do Zoom chat implementa uma arquitetura de duplo mecanismo para transferir dados do local de trabalho do Slack para ambientes do Zoom chat. Os administradores do sistema têm acesso a vários caminhos de migração.

Visão geral da migração

Há várias maneiras de migrar seus dados do Slack usando o Aplicativo de Migração do Zoom chat, dependendo do tamanho da sua Organização, do plano do Slack e dos requisitos de segurança.

Além disso, você deve atender a certos pré-requisitos do Slack e do Zoom, criar um plano de migração e consolidar seus locais de trabalho do Slack. Esta seção fornece uma visão geral desses pré-requisitos e considerações.

Opções de migração

A tabela a seguir detalha as abordagens de migração mais comuns:

Método de migração
Descrição
Melhor para
Requisitos
Benefício

Migração por API (baseada em aplicativo)

Usa um aplicativo de migração para se conectar diretamente às APIs do Slack e transferir dados. Suporta canais públicos, canais privados e DMs.

Organizações menores ou casos em que obter a autorização do usuário seja viável

Os usuários devem autorizar o acesso aos seus dados para chats privados e DMs

Transferência totalmente automatizada e integrada de dados diretamente do Slack

Migração com Ferramenta de Importação (baseada em arquivos)

Usa arquivos de exportação do Slack para migrar dados por meio da Ferramenta de Importação do Zoom

Organizações com planos Slack Plus ou Grid empresarial

Os administradores devem exportar os dados do Slack a partir do Painel do administrador do Slack

Não é necessária autorização do usuário; ideal para migração em massa, especialmente chats privados

Abordagem híbrida (API + Importação)

Combina os métodos de API e Importação: canais públicos via API; canais privados e DMs via Ferramenta de Importação

Organizações de médio a grande porte que querem evitar a complexidade da autorização do usuário

Acesso de administrador tanto para a exportação do Slack quanto para a configuração da migração por API baseada em aplicativo

Evita o atrito da autorização do usuário para chats privados, mantendo a automação para a migração de canais públicos

Restrições do sistema

O processo de migração está sujeito a restrições específicas:

  • Capacidade máxima de uma única tarefa: 12 meses de dados históricos

  • Janela total de migração: 60 meses (5 anos)

  • Concorrência de tarefas: Apenas uma tarefa pode estar em execução por vez

Essa arquitetura técnica permite a migração sistemática de dados de comunicação empresarial, mantendo os protocolos de segurança e a integridade dos dados.

Mapeamento de dados do Slack para o Zoom

A tabela a seguir de detalhes de mapeamento pode ajudá-lo a entender a conexão entre o Slack e o Zoom chat antes da migração:

Recursos do Slack
Equivalente no Zoom chat
Notas

Canais públicos

Canais públicos

Migrados automaticamente

Canais privados

Canais privados

Requer aprovação do usuário

Mensagens diretas (DMs)

Chats 1:1

Requer aprovação do usuário

DMs em grupo

Chats em grupo

Requer aprovação do usuário

Tópicos

Respostas em linha

Não totalmente em tópicos como o Slack, mas mantém a ordem das respostas

@ Menções

@ Menções

Mesmo comportamento

Reações

Reações com emoji

Mesmo comportamento

Ficheiros

Ficheiros partilhados

Requer Armazenamento em nuvem ativado

Mensagens fixadas

Mensagens marcadas com estrela

As mensagens fixadas tornam-se marcadas com estrela

Mensagens de Bots/Aplicativos do Slack

Apenas texto (sem cartões)

Os cartões avançados do aplicativo não serão migrados

Pré-requisitos de conta e Permissão

Você deve verificar os níveis das suas contas Slack e da sua conta Zoom e as permissões de administrador antes de prosseguir.

  • A Pro, Corporativo, empresarial ou Educação É necessária uma conta Zoom.

  • Slack e Zoom permissões de administrador são necessárias para autorizar a migração.

O administrador que instala o aplicativo Zoom Marketplace deve aceder ao Gerenciamento de função no portal web. Deve garantir que lhe foram atribuídas as permissões corretas de gerenciamento de chat - o Editar a caixa de seleção deve ser marcada para Canais de chat e Mensagens de chat funções. Caso contrário, não poderão autorizar o aplicativo Zoom Slack Migration devido a permissões insuficientes.

  • O Armazenamento em nuvem deve estar ativado para retenção de mensagens/ficheiros.

APIs do Slack: Escopos, Permissões e limites de taxa

As APIs do Slack são usadas para obter os dados de usuário, canal e mensagem do Slack. Esses tipos de dados têm limites de taxa, permitindo apenas um certo número de pedidos por minuto para um local de trabalho do Slack. Esta é uma consideração importante ao planear a sua cronologia de migração.

Referências de desempenho dos trabalhos de migração do Slack

As tabelas seguintes fornecem estimativas para migrações do Slack.

Método de migração
Intervalo de dados
Tempo de processamento por canal
Tempo de migração estimado*

Migração por importação

~2 semanas

5-10 segundos

45 segundos - 1 minuto e 15 segundos por canal

Migração baseada em API

~2 semanas

20-30 segundos

3-5 minutos por canal

*Com base num local de trabalho Slack de médio porte com um ano de dados históricos

Os trabalhos de migração enfrentam dois estrangulamentos fundamentais que afetam diretamente os prazos de implementação e o planeamento de recursos. As limitações de processamento da transferência de ficheiros afetam tanto os métodos de migração por importação como os baseados em API, criando restrições de desempenho que exigem alocação adequada de largura de banda e estratégias de otimização da transferência durante o planeamento da implementação. Os trabalhos de migração baseados em API enfrentam restrições adicionais de desempenho devido aos mecanismos nativos de limitação de taxa da API do Slack. Estas restrições não afetam as migrações por importação, mas impactam significativamente as implementações baseadas em API, exigindo janelas de processamento alargadas e agendamento cuidadoso dos trabalhos para otimizar a taxa de transferência, mantendo a conformidade com as limitações da plataforma.

Embora o seu local de trabalho Slack possa conter centenas ou milhares de canais, a distribuição da atividade dos canais segue padrões previsíveis que afetam diretamente o desempenho da migração e os requisitos de alocação de recursos. Os canais de elevada atividade, com históricos extensos de mensagens, anexos de ficheiros e interações de usuários, exigirão os tempos de processamento completos de referência descritos acima. No entanto, a maioria dos canais do local de trabalho normalmente contém atividade mínima — consistindo em conversas breves, anúncios ou discussões arquivadas que migram significativamente mais rápido do que as estimativas de referência.

Permissões e scopes de administrador necessários

A Zoom App Marketplace requer as seguintes permissões de administrador e escopos dentro do tenant Zoom:

  • Gestão de chat > Canais de chat = Editar

  • chat Mensagens = Editar

A ferramenta de Migração do Zoom usa APIs internas que exigem os seguintes escopos do aplicativo Zoom:

  • chat_mensagem:escrever:administrador

  • imchat:bot

  • chat_canal:escrever:administrador

  • usuário:write:administrador

Zoom XMPP inclui um campo contendo o ID da mensagem do Slack para autenticidade e rastreamento histórico.

O aplicativo Slack criado pelo Zoom será instalado automaticamente no locatário do Slack quando um administrador se conectar a um local de trabalho por meio da ferramenta de migração. O aplicativo Slack usa autenticação OAuth2 para se conectar com o Zoom, fornecendo o token de autorização para a migração de dados. Os usuários devem autorizar a migração de conversas privadas (DMs, chats em grupo e canais privados).

Você também deve definir a opção para Permitir apenas aplicativos do diretório do Slack para DESATIVADO, o que permite que o aplicativo do Slack seja instalado assim que a conexão com o local de trabalho tiver sido criada. Os seguintes escopos do Slack também são necessários:

  • files:read

  • channels:history

  • channels:read

  • grupos:histórico

  • grupos:leitura

  • im:histórico

  • im:leitura

  • mpim:histórico

  • mpim:leitura

  • pins:leitura

  • estrelas:leitura

  • utilizadores:leitura

  • utilizadores:leitura.e-mail

Considerações sobre a migração

Considerar uma estratégia de migração com antecedência economizará esforço e garantirá uma transição suave entre plataformas. Como exemplo de alto nível, o Zoom oferece o seguinte esboço de estratégia:

  1. Decidir quais Espaços de trabalho do Slack migrar (um ou mais)

  2. Escolher quais dados migrar:

    1. Canais públicos (migração automática)

    2. Canais privados e mensagens diretas (DMs) (requer autorização do usuário)

    3. Mensagens de bot e/ou aplicativo

  3. Decidir qual método de migração melhor atende às suas necessidades

  4. Definir um prazo para a migração (até um máximo de um ano por tarefa)

  5. Comunicar com os usuários sobre aprovações de mensagens privadas

Consolidação de local de trabalho do Slack

Para organizações que usam vários locais de trabalho do Slack, como usuários do empresarial Grid, a migração para o Zoom chat consolida todos os locais de trabalho em uma única conta.

Para diferenciar entre locais de trabalho, o Zoom adiciona o nome original do local de trabalho aos nomes de canal e chat. Por exemplo:

  • Canal original do Slack:

    • #engineering (com um local de trabalho "US Team")

  • Canal migrado do Zoom:

    • #engineering: US Team

Essa consolidação garante que todos os dados sejam migrados para uma única conta do Zoom chat, preservando o contexto original do local de trabalho. Os espaços compartilhados podem fornecer estrutura adicional para equipes ou departamentos específicos, tornando mais fácil organizar e Acessar conteúdo.

Consolidação de dados do chat

Espaços de trabalho com mais de 100 utilizadores podem ter dezenas de milhares de chats de grupo privados e DMs que nunca foram arquivados ou eliminados, mesmo após os utilizadores terem sido removidos da empresa. Isto faz com que os trabalhos de migração privados demorem significativamente mais tempo do que os trabalhos públicos.

Os administradores devem limpar os dados antigos arquivando manualmente estas conversas antigas ou atualizando o período de retenção do Slack para as eliminar automaticamente.

O Zoom recomenda validar quais dados precisam permanecer como dados Ativo no Zoom chat e quais dados podem ser arquivados para quaisquer futuros fins legais, de conformidade, de mitigação de riscos, de recursos humanos ou outros.

Além disso, é importante considerar se os dados atualmente residem no Slack ou se estão integrados a serviços de terceiros para prevenção contra perda de dados (DLP), e-Discovery ou arquivamento.

Retenção do histórico de chat

Existem várias considerações relacionadas à retenção ao migrar do Slack para o Zoom, já que o Slack é totalmente baseado em nuvem, enquanto o Zoom oferece opções de retenção mais granulares:

  • O Zoom oferece armazenamento local no Dispositivo e Armazenamento em nuvem. Armazenamento local do Dispositivo pode variar de um (1) dia a sete (7) anos. Armazenamento em nuvem pode ser desativado ou configurado para um período de retenção de 7 anos.

  • Políticas de retenção podem ser configuradas nos níveis de conta e grupo para usuários.

  • Os administradores podem definir tempos de retenção específicos para canais individuais, conforme necessário.

  • Os administradores podem especificar uma política de retenção para DMs ou chats em grupo e definir outra política para canais de chat.

  • Para relatórios do histórico de chat, o Zoom recomenda armazenar revisões de mensagens editadas e exclusões.

Consulte o artigo do Suporte do Zoom Armazenando o histórico de mensagens do Zoom Chat para saber mais sobre a retenção do histórico de chat.

Melhores práticas

Melhores práticas para a pré-migração

Siga estas recomendações para um processo de pré-migração mais fácil:

  • Certifique-se de que os usuários tenham criado contas no Zoom e tenham se autenticado ao menos uma vez.

  • Os administradores adicionaram o aplicativo de Migração do Slack à sua conta Zoom.

  • Os administradores que realizam a migração devem ter permissões para ambas as plataformas (Slack e Zoom Chat), e o e-mail deles deve corresponder entre suas contas Zoom e Slack.

  • Os administradores devem usar o aplicativo de Migração do Zoom Chat para Configurar trabalhos de migração para executar e mover dados do Slack para o Zoom Chat. Observação: esse processo requer um mínimo de 2 trabalhos, porque pelo menos 1 trabalho moverá conversas privadas e 1 trabalho moverá canais públicos.

  • Os administradores devem arquivar ou excluir quaisquer dados desnecessários do Slack que não desejem migrar para o chat para ajudar a acelerar as migrações.

  • Se estiver usando trabalhos de migração de API para migrar dados privados, certifique-se de que os usuários estejam cientes de quando e como eles autorizarão o Slack a mover seus dados para o chat.

  • Se estiver planejando usar trabalhos de migração de importação, siga as instruções do Slack sobre como exportar os dados de chat do seu local de trabalho como um arquivo .zip.

    • Requisitos do arquivo:

      • O nome do arquivo .zip não deve ser alterado em relação ao formato original exportado pelo Slack

      • O tamanho do arquivo .zip não deve exceder 10 GB

Melhores práticas para a migração

O processo a seguir fornece uma visão geral de alto nível da migração:

  1. Antes da migração, certifique-se de que os usuários sejam criados no Zoom e tenham se autenticado pelo menos uma vez.

  2. Os administradores devem preparar e Adicionar o aplicativo Slack Migration à sua conta Zoom.

  3. O administrador que realizar a migração deve ter permissões apropriadas para ambas as plataformas e endereços de e-mail correspondentes entre as suas contas do Zoom e do Slack.

  4. Os administradores devem instalar o aplicativo privado no Slack para se conectar ao Zoom e realizar autenticação OAuth.

  5. Os administradores usam o aplicativo Zoom Chat Migration para Configurar trabalhos de migração para mover dados do Slack para o Zoom Chat. Isso requer um mínimo de 2 trabalhos - um para conversas privadas e um para canais públicos.

Ao migrar, siga estas etapas recomendadas:

  1. Migre dados de um canal ao Selecionar o tipo de conversa Canais Públicos e escolher um canal específico. Selecionar uma semana de dados de alguns dos seus canais mais antigos.

  2. Crie trabalhos para transferir todos os canais públicos de mais de um ano atrás e, em seguida, verifique se todos os canais foram criados com usuários.

  3. Depois de verificar que o aplicativo funciona como esperado, crie e execute menos trabalhos com intervalos de tempo maiores, em vez de mais trabalhos com intervalos de tempo menores. Cada trabalho contém o mesmo número de etapas para migrar.

  4. (Opcional) Repita estas etapas para migrações de trabalhos privados.

Após a migração de dados, os seus dados aparecerão da seguinte forma:

  • Os nomes de canais públicos/privados e de grupos de chat aparecerão como: #nome-do-canal: nome-do-local de trabalho

  • Mensagens enviadas por usuários do Slack com conta Zoom Ativo irão Mostrar normalmente como se tivessem sido enviadas por esses usuário do Zoom

  • Mensagens enviadas por usuários do Slack sem conta Zoom Ativo irão Mostrar como enviadas por um usuário do Zoom desativado com o nome do remetente da mensagem do Slack

  • Mensagens do sistema serão migradas (por exemplo, "@Algum Usuário entrou no canal")

  • Todas as mensagens serão migradas como lidas, independentemente do status delas no Slack

  • Um aviso de Conclusão da Migração será enviado a cada canal público e privado após a conclusão, aparecendo como "Mensagem é enviada do Aplicativo de Migração de chat, Dia Data Hora"

Excluindo o aplicativo de migração

O aplicativo de migração mantém mapeamentos 1:1 entre conversas do Slack e do Zoom após a migração.

Instalação

Para instalar o aplicativo:

  1. Iniciar sessão no Zoom App Marketplace.

  2. Pesquise por Migração do chat e clique Adicionar.

  3. Revise e aprove as permissões necessárias.

Consulte o artigo do Suporte do Zoom Usando o aplicativo Migração de chat (ferramenta de migração do Slack) para obter instruções de instalação mais detalhadas.

Os administradores devem conceder Permissão à conta do local de trabalho do Slack ou à Organização para instalar e autorizar o aplicativo privado, Recuperador de Mensagens. Um administrador deve aprovar, em geral, o uso de aplicativos em um local de trabalho do Slack e também conceder permissões para todos os membros usarem o aplicativo.

Os administradores devem conceder Permissão para instalar o aplicativo de Migração de chat na sua conta Zoom, juntamente com duas permissões de Gerenciamento de chat na Função de administrador.

A opção para Permitir apenas aplicativos do Diretório de aplicativos do Slack a configuração deve estar desativada.

O administrador que usa o aplicativo deve ter uma Função de administrador da conta para migrar conversas. Ele não pode ser um tipo de administrador personalizado. Saiba mais sobre identificação de tipos de conta, Funções e licenças e Gerenciamento de função na unidade do Suporte do Zoom.

Conecte o seu local de trabalho do Slack para trabalhos de Migração de API

Se você não estiver usando o método de Importação de Arquivo, estas instruções ajudarão você a conectar para migrações de API.

Para conectar um local de trabalho:

  1. Abra o aplicativo de Migração de chat no Zoom.

  2. Clique em Criar conexão > Iniciar sessão no Slack e autorize.

  3. Confirme a conexão do local de trabalho no Painel do Zoom.

Execute a tarefa Sincronizar usuário

A tarefa Sincronizar usuário obtém todos os membros completos e Ativo no seu local de trabalho do Slack e cria um mapeamento 1:1 para a sua conta Zoom correspondente usando o seu endereço de e-mail.

Se o endereço de e-mail de um usuário Slack Ativo não for encontrado no lado do Zoom, um novo usuário desativado será criado no Zoom para esse endereço de e-mail.

Se o endereço de e-mail de um usuário Slack Ativo for encontrado numa conta Zoom diferente, como uma conta pessoal, então o usuário será mapeado para um perfil de "usuário fictício". Na sua conta Zoom, este usuário será nomeado TeamChatMigration AppUser e irá apresentar-se para garantir que todos os dados das mensagens sejam migrados para o seu local de trabalho.

A executar tarefas de migração

A secção seguinte irá ajudá-lo a iniciar as tarefas necessárias para a migração.

Criando uma tarefa de migração de importação

Para criar uma nova tarefa de migração:

  1. Clique em Carregar ficheiros, Selecionar seu arquivo de exportação do Slack, depois clique Enviar.

  2. Aguarde até que seu arquivo seja enviado ao Zoom.

    1. Nota: Não saia nem atualize a página, pois isso interromperá o upload do arquivo e o trabalho ficará preso no estado "Uploading". Se isso acontecer, você poderá excluir o trabalho "Uploading" e reiniciar este processo

  3. Assim que o upload inicial do arquivo for concluído, uma Janela de detalhes da migração aparecerá enquanto o aplicativo de migração prepara o arquivo para a migração. Nesse momento, você pode fechar, sair ou atualizar a página enquanto espera até que o trabalho esteja pronto para ser executado.

  4. Depois que a ferramenta terminar de preparar o arquivo para a migração, você poderá Selecionar os tipos de conversa a migrar.

  5. Depois de ter Selecionado os tipos de conversa, clique Executar para iniciar o trabalho de migração.

Criando um trabalho de migração da API

Para criar uma nova tarefa de migração:

  1. Clique em Novo trabalho de migração e Selecionar o local de trabalho do Slack.

  2. Escolher o escopo de dados:

    • Canais públicos (migra automaticamente).

    • Canais privados e DMs (requer autorização do usuário).

    • Intervalo de datas específico para mensagens.

  3. Depois de Selecionar o escopo de dados e o intervalo e de obter a autorização dos seus usuários, selecione Executar para iniciar o trabalho de migração.

Executando e monitorando trabalhos de migração

Iniciando um novo trabalho de migração

Para iniciar um trabalho de migração, execute:

  1. Clique em Executar migração para iniciar o processo.

  2. Os tempos de migração variam (locais de trabalho grandes podem levar 12+ horas).

  3. Acompanhe o progresso no Painel de Migração.

Solução de problemas de trabalhos de migração

Às vezes, um trabalho de migração pode não retornar o resultado desejado. A tabela a seguir fornece soluções para possíveis problemas encontrados durante a migração:

Problema
Solução
  • Mensagens/canais privados ausentes

  • Verifique se o usuário autorizou a migração

  • Trabalho de migração travado

O aplicativo de migração tentará novamente automaticamente

  • Alguns usuários não mapeados no Zoom

Certifique-se de que eles existam no Zoom com o mesmo e-mail e execute novamente quaisquer migrações

Análise pós-migração

Após concluir uma migração, o Zoom recomenda realizar uma análise pós-migração completa e verificar se o conteúdo do Slack foi transferido para o chat conforme o esperado.

A tabela a seguir fornece tarefas recomendadas para validar suas migrações de chat:

Etapa
Ação

Verifique a migração

  • Inicie sessão no chat do Zoom e verifique se os canais, as mensagens e os arquivos aparecem corretamente.

  • Encerre sessão e inicie sessão novamente para atualizar o histórico do chat.

Corrija quaisquer dados ausentes

  • Reenvie solicitações de autorização aos usuários que não aprovaram o acesso a dados privados.

  • Revise os trabalhos de migração em busca de erros e tente novamente quaisquer trabalhos com falha.

(Opcional) Desative o Slack

  • Após confirmar que a migração de dados foi concluída, você pode arquivar ou remover o local de trabalho do Slack.

Solução de problemas gerais

  • Se houver mensagens ausentes, tente encerrar sessão e iniciar sessão novamente no Zoom.

  • Se os usuários não puderem ser encontrados, verifique se os endereços de e-mail correspondem entre o Slack e o Zoom.

  • Se a migração falhar, verifique os logs para obter detalhes do erro e tente o processo novamente.

Lista de verificação adicional para solução de problemas

Se você descobrir problemas adicionais após a migração, esta lista de verificação poderá fornecer etapas e ações adicionais a serem executadas para Verificação.

Antes de continuar, você deve obter o ID de rastreamento do Zoom da chamada pela web e recuperar ambos IDs da conta e IDs de usuário.

Categoria
Descrição do problema

Configurações da conta Zoom

  • Confirme se a funcionalidade de chat em equipe está ativada em todos os níveis

  • Verifique se todas as Configurações de compartilhamento de arquivos estão ativadas em todos os níveis e documente quaisquer restrições de arquivo

  • Verifique se "Permitir que os usuários criem canais públicos + privados" está ativado em todos os níveis

Problemas de usuário do Zoom

  • Verifique o status de administrador do usuário

  • Confirme se o e-mail do operador da ferramenta corresponde entre o Zoom e o Slack

  • Verifique os endereços de e-mail correspondentes dos usuários que estão sendo migrados tanto no Zoom quanto no Slack

Problemas de trabalho de migração

  • Verifique o status de conclusão do trabalho (aprovado/com falha)

  • Determine se o trabalho envolveu canais públicos ou canais/conversas privados

Se a migração foi aprovada, mas as mensagens/conversas não estão visíveis

  • Confirme se o intervalo de tempo GMT captura corretamente o intervalo de mensagens pretendido do Slack (as datas de migração começam/terminam às 12h GMT (PST +7))

  • Verifique a criação adequada do canal

  • Certifique-se de que o usuário tenha encerrado sessão e iniciado sessão novamente no cliente após a migração

  • Confirme a criação adequada dos usuários migrados no Zoom

  • Verifique a visibilidade de mensagens/conversas no portal de administração do Histórico de chat

Se a migração falhou

  • Documente a mensagem de erro específica

  • Para falhas na migração de arquivos, gravar o nome do arquivo problemático

  • Documente as ações do usuário realizadas após a falha (nova tentativa do trabalho, criação de novo trabalho etc.)

Última atualização

Isto foi útil?