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

### Introdução <a href="#ix9eykivgqnt" id="ix9eykivgqnt"></a>

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 abrange 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](https://marketplace.zoom.us/apps/5ZXfqVPZSfqBYeCR9VLsBg) implementa uma arquitetura de mecanismo duplo 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 <a href="#jemq5k6izt7b" id="jemq5k6izt7b"></a>

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.

{% embed url="<https://zoom.us/clips/share/vyPfmHWOR6aWxPeWe_m-1A>" %}

#### <mark style="color:azul;">Opções de migração</mark> <a href="#h29eaaqgvd9c" id="h29eaaqgvd9c"></a>

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

| Método de migração                                             | Descrição                                                                                                                                       | Ideal 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 é viável                     | Os usuários devem autorizar o acesso aos seus dados para chats privados e DMs                                      | Transferência de dados totalmente automatizada e contínua diretamente do Slack                                      |
| **Migração com ferramenta de importação (baseada em arquivo)** | 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 empresarial Grid                                           | 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 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 desejam evitar a complexidade da autorização do usuário | Acesso de administrador para a exportação do Slack e 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 canal público |

**Restrições do sistema**

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

* **capacidade máxima de um único trabalho**: 12 meses de dados históricos
* **Janela total de migração**: 60 meses (5 anos)
* **Concorrência de trabalhos**: apenas um trabalho deve estar em execução por vez

Esta 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.

#### <mark style="color:azul;">Mapeamento de dados do Slack para o Zoom</mark> <a href="#z9gs91q4zgvi" id="z9gs91q4zgvi"></a>

A tabela de detalhes de mapeamento a seguir 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             | Migrado 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 de grupo              | Requer aprovação do usuário                                             |
| Threads                                | Respostas em linha          | Não totalmente em thread como o Slack, mas mantém a ordem das respostas |
| @ Menções                              | @ Menções                   | Mesmo comportamento                                                     |
| Reações                                | Reações de emoji            | Mesmo comportamento                                                     |
| Arquivos                               | Arquivos compartilhados     | Requer que o Armazenamento em nuvem esteja ativado                      |
| Mensagens fixadas                      | Mensagens com estrela       | Mensagens fixadas tornam-se com estrela                                 |
| Mensagens de bots/aplicativos do Slack | Somente texto (sem cartões) | Os cartões avançados do aplicativo não serão migrados                   |

#### <mark style="color:azul;">Pré-requisitos de conta e permissão</mark> <a href="#pppv0j3jhmh6" id="pppv0j3jhmh6"></a>

Você deve verificar os níveis da sua conta Slack e conta Zoom, bem como as Permissão 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.

{% hint style="info" %}
O administrador que instalar o aplicativo Zoom Marketplace deve acessar o Gerenciamento de função no portal da web. Ele deve garantir que lhe sejam atribuídas as permissões corretas de gerenciamento de chat - a **Editar** caixa de seleção deve ser marcada para as Função de **Canais de chat** e **Mensagens de chat** . Caso contrário, ele não poderá autorizar o aplicativo Zoom Slack Migration devido a permissões insuficientes.
{% endhint %}

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

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

As APIs do Slack são usadas para obter 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 solicitações por minuto para um local de trabalho do Slack. Isso é uma consideração importante ao planejar seu cronograma de migração.

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

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

{% tabs %}
{% tab title="Análise de comparação de desempenho por método de implementação de migração" %}

| Método de migração      | Intervalo de dados | Tempo de processamento por canal | Tempo estimado de migração\*                   |
| ----------------------- | ------------------ | -------------------------------- | ---------------------------------------------- |
| Migração de 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                          |

<sub>*\*Baseado em um local de trabalho do Slack de porte médio com um ano de dados históricos*</sub>
{% endtab %}
{% endtabs %}

Os trabalhos de migração encontram dois gargalos fundamentais que afetam diretamente os prazos de implementação e o planejamento de recursos. As limitações de processamento na transferência de arquivos impactam tanto os métodos de migração por importação quanto os baseados em API, criando restrições de desempenho que exigem alocação adequada de largura de banda e estratégias de otimização de transferência durante o planejamento da implantaçã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. Essas restrições não afetam as migrações por importação, mas impactam significativamente as implementações baseadas em API, exigindo janelas de processamento estendidas e agendando cuidadoso dos trabalhos para otimizar o throughput enquanto mantém a conformidade com as limitações da plataforma.

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

**Permissões e escopos de administrador necessários**

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

* **Gestão de chat > Canais de chat = Editar**
* **Mensagens de chat = Editar**

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

* `chat_message:write:administrador`
* `imchat:bot`
* `chat_canal:write: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 do Slack criado pela Zoom será instalado automaticamente no tenant do Slack quando um administrador se conectar a um local de trabalho por meio da ferramenta de migração. O aplicativo do Slack usa[ autenticação OAuth2](https://api.slack.com/authentication/oauth-v2) para se conectar com a 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 **DESLIGADO**, o que permite que o aplicativo Slack seja instalado assim que a conexão com o local de trabalho tiver sido criada. Também são necessários os seguintes escopos do Slack:

* `files:read`
* `channels:history`
* `channels:read`
* `groups:history`
* `groups:read`
* `im:history`
* `im:read`
* `mpim:history`
* `mpim:read`
* `pins:read`
* `stars:read`
* `users:read`
* `users:read.e-mail`

#### <mark style="color:azul;">Considerações sobre migração</mark> <a href="#id-2upmrqx4xrqh" id="id-2upmrqx4xrqh"></a>

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, Zoom oferece o seguinte resumo da estratégia:

1. Decida quais espaços de trabalho do Slack migrar (um ou mais)
2. Escolher o que 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 do aplicativo
3. Decida qual método de migração melhor se adapta às suas necessidades
4. Defina um período para a migração (até um máximo de um ano por tarefa)
5. Comunique-se com os usuários sobre aprovações de mensagens privadas

**Consolidação do 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 acrescenta o nome original do local de trabalho aos nomes do canal e do chat. Por exemplo:

* Canal original do Slack:
  * **#engineering** (com um local de trabalho de "US Team")
* Canal do Zoom migrado:
  * **#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. Espaços compartilhados podem fornecer estrutura adicional para equipes ou departamentos específicos, facilitando a organização e o acesso ao conteúdo.

**Consolidação de dados de chat**

Locais de trabalho com mais de 100 usuários podem ter dezenas de milhares de chats privados em grupo e DMs que nunca foram arquivados ou excluídos, mesmo após os usuários terem sido removidos da empresa. Isso faz com que os trabalhos de migração privada demorem significativamente mais do que os trabalhos públicos.

Os administradores devem limpar os dados antigos arquivando manualmente essas conversas antigas ou atualizando o período de retenção do Slack para excluí-las automaticamente.

O Zoom recomenda validar quais dados precisam permanecer como dados ativos 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.

{% hint style="success" %}
Embora seja possível replicar mais dados do Slack para o Zoom Chat, o Zoom recomenda **replicar apenas um (1) ano de dados ativos e arquivar o restante**. A maioria dos usuários raramente precisa pesquisar além de um único ano para desempenhar sua Função e comunicar. A Zoom recomenda criar trabalhos de migração em lotes menores de três a seis meses para migrações de dados bem-sucedidas.
{% endhint %}

Além disso, é importante considerar se os dados atualmente estão 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 na nuvem, enquanto o Zoom oferece opções de retenção mais granulares:

* Zoom oferece tanto armazenamento local no Dispositivo quanto Armazenamento em nuvem. [Armazenamento local do Dispositivo](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063423) pode variar de um (1) dia a sete (7) anos. [Armazenamento em nuvem](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0067567) pode ser desativado ou configurado para um período de retenção de 7 anos.
* [Políticas de retenção](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060329) pode ser configurado tanto ao nível da conta como do grupo para os 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 grupos de chat 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 de Suporte do Zoom [Armazenamento do histórico de mensagens do Zoom Chat](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060329) para saber mais sobre a retenção do histórico de chat.

### Melhores práticas <a href="#ingmqmxix4r2" id="ingmqmxix4r2"></a>

#### <mark style="color:azul;">Melhores práticas para a pré-migração</mark> <a href="#est83jfa09dc" id="est83jfa09dc"></a>

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

* Garanta que os usuários tenham criado contas no Zoom e tenham se autenticado pelo menos uma vez.
* Os administradores adicionaram o aplicativo Slack Migration à sua conta Zoom.
* Os administradores que realizam a migração devem ter permissões para ambas as plataformas (Slack e Zoom Chat), e seu e-mail deve corresponder entre suas contas Zoom e Slack.
* Os administradores devem usar o aplicativo Zoom Chat Migration para Configurar trabalhos de migração para serem executados 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 desejam migrar para o chat para ajudar a acelerar as migrações.
* Se você estiver usando trabalhos de migração da API para migrar dados privados, certifique-se de que os usuários estejam cientes de quando e como 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](https://slack.com/help/articles/201658943-Export-your-workspace-data).
  * Requisitos do arquivo:
    * O nome do arquivo .zip não deve ser alterado em relação ao formato original exportado do Slack
    * O tamanho do arquivo .zip não deve exceder 10 GB

#### <mark style="color:azul;">Melhores práticas para a migração</mark> <a href="#id-8soj3en5qd2g" id="id-8soj3en5qd2g"></a>

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 de Migração do Slack à sua conta Zoom.
3. O administrador que estiver realizando a migração deve ter permissões adequadas para ambas as plataformas e endereços de e-mail correspondentes entre suas contas Zoom e Slack.
4. Os administradores devem instalar o aplicativo privado no Slack para se conectar ao Zoom e realizar a autenticação OAuth.
5. Os administradores usam o aplicativo de Migração do Zoom Chat 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 selecionando o tipo de conversa Selecionar Canais Públicos e escolhendo um canal específico. Selecione uma semana de dados de alguns dos seus canais mais antigos.
2. Crie tarefas para transferir todos os canais públicos de há mais de um ano 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 tarefas com intervalos de tempo maiores, em vez de mais tarefas com intervalos de tempo menores. Cada tarefa contém o mesmo número de etapas de migração.
4. (Opcional) Repita estas etapas para migrações de tarefas privadas.

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

* Os nomes dos canais públicos/privados e dos grupos de chat aparecerão como: #nome-do-canal: nome-do-local de trabalho
* As mensagens enviadas por usuários do Slack com contas Zoom Ativo aparecerão normalmente, como se tivessem sido enviadas por esses usuários Zoom
* As mensagens enviadas por usuários do Slack sem contas Zoom Ativo aparecerão como enviadas por um usuário Zoom desativado com o nome do remetente da mensagem do Slack
* As 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 "A mensagem é enviada do aplicativo Migração de Chat, Dia Data Hora"

#### <mark style="color:azul;">Excluindo o aplicativo de migração</mark> <a href="#id-35kihp9337s8" id="id-35kihp9337s8"></a>

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

{% hint style="warning" %}
Remover este aplicativo da sua conta Zoom excluirá esses mapeamentos, resultando em canais e chats duplicados se você reinstalar e migrar novamente. Exclua o aplicativo Chat Migration somente se tiver certeza de que nenhuma outra migração será necessária.
{% endhint %}

### Instalação <a href="#vfotb6a19pij" id="vfotb6a19pij"></a>

{% embed url="<https://zoom.us/clips/share/c2-2HL8tTNKDzXbKjrKkkg>" %}

Para instalar o aplicativo:

1. Iniciar sessão no Zoom App Marketplace.
2. Procure por Migração de chat e clique **Adicionar**.
3. Revise e aprove as permissões necessárias.

Consulte o artigo de Suporte do Zoom [Usando o aplicativo Chat Migration (ferramenta de migração do Slack)](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0058132) para instruções de instalação mais detalhadas.

{% hint style="info" %}
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 a utilização de aplicativos, em geral, num local de trabalho do Slack e também conceder permissões para que todos os membros possam utilizar o aplicativo.
{% endhint %}

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

A opção para **Permitir apenas aplicativos do Diretório de Aplicativos do Slack** definição deve estar **desativada**.

{% hint style="info" %}
O administrador que utiliza o aplicativo deve ter uma [Função de administrador da conta](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060684#h_01FCBKK69SJNA90M1J07SSJ1YB) para migrar conversas. Eles não podem ser um tipo de administrador personalizado. Saiba mais sobre [identificando tipos de conta, funções e licenças](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060684) e [Gerenciamento de função](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064983) na unidade de Suporte do Zoom.
{% endhint %}

#### <mark style="color:azul;">Conecte seu local de trabalho do Slack para trabalhos de migração de API</mark> <a href="#xjbm4ds0xh3" id="xjbm4ds0xh3"></a>

Se você não estiver usando o método de Importação de arquivo, estas instruções ajudarão você a se 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 **Criar conexão > Iniciar sessão no Slack** e autorize.
3. Confirme a conexão do local de trabalho no Painel do Zoom.

#### <mark style="color:azul;">Execute a tarefa de Sincronizar usuários</mark> <a href="#qo97g1d6dweq" id="qo97g1d6dweq"></a>

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

Se o endereço de e-mail de um usuário Ativo do Slack 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 Ativo do Slack for encontrado sob outra conta Zoom, como uma conta pessoal, então o usuário será mapeado para um perfil de "usuário fictício". Na sua conta Zoom, esse usuário será chamado **TeamChatMigration AppUser** e estará presente para garantir que todos os dados das mensagens sejam migrados para o seu local de trabalho.

{% hint style="warning" %}
Não exclua o **TeamChatMigration AppUser** usuário.
{% endhint %}

### Executando trabalhos de migração <a href="#jpygqaz4w6nu" id="jpygqaz4w6nu"></a>

A seção a seguir ajudará você a iniciar os trabalhos necessários para a migração.

#### <mark style="color:azul;">Criando um trabalho de migração de importação</mark> <a href="#c2p4z4dmsd2d" id="c2p4z4dmsd2d"></a>

Para criar um novo trabalho de migração:

1. Clique **Carregar arquivos**, selecione o seu arquivo de exportação do Slack e, em seguida, clique em **Carregar**.
2. Aguarde o upload do seu arquivo para o Zoom.
   1. Observação: não saia nem atualize a página, pois isso interromperá o upload do arquivo e o trabalho ficará preso no estado "Carregando". Se isso acontecer, você pode excluir o trabalho "Carregando" e reiniciar este processo
3. Assim que o upload inicial do arquivo for concluído, uma **janela de detalhes da migração** será exibida 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 serem migrados.
5. Depois de selecionar seus tipos de conversa, clique em **Executar** para iniciar o trabalho de migração.

{% embed url="<https://zoom.us/clips/share/Z2cQfrUfQhGnOLrs1pazxg>" %}

#### <mark style="color:azul;">Criando um trabalho de migração de API</mark> <a href="#ad0zjh4rce2h" id="ad0zjh4rce2h"></a>

Para criar um novo trabalho de migração:

1. Clique **Novo trabalho de migração** e selecione o local de trabalho do Slack.
2. Escolher o **escopo dos 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 e o intervalo dos seus dados e de obter a autorização dos seus usuários, selecione **Executar** para iniciar o trabalho de migração.

{% hint style="warning" %}
Tratamento de solicitações de autorização de dados privados para canais privados e DMs:

* **Canais privados e DMs exigem aprovação do usuário** antes da migração.
* O Zoom enviará automaticamente solicitações de aprovação por e-mail assim que o trabalho de migração for criado.
* Os administradores podem acompanhar quais usuários aprovaram ou não. Para a migração de chat privado, basta a autorização de apenas um usuário para migrar todo o histórico da conversa.
* Os e-mails de solicitação de autorização são enviados apenas aos usuários que ainda não forneceram aprovação.
* Para obter o melhor sucesso na migração, procure obter autorização de aproximadamente 60-70% dos seus usuários.
  {% endhint %}

{% embed url="<https://zoom.us/clips/share/SRH881CTT7moCbRn311B1w>" %}

{% embed url="<https://zoom.us/clips/share/_DUwlAP6RiCFABnlknQ43Q>" %}

#### <mark style="color:azul;">Executando e monitorando trabalhos de migração</mark> <a href="#nbokwove1l8n" id="nbokwove1l8n"></a>

**Iniciando um novo trabalho de migração**

Para iniciar uma execução de trabalho de migração:

1. Clique **Executar migração** para iniciar o processo.
2. Os tempos de migração variam (local de trabalho grandes podem levar **mais de 12 horas**).
3. Acompanhe o progresso no **Painel de Migração**.

**Solucionando problemas de trabalhos de migração**

Ocasionalmente, 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:

{% tabs %}
{% tab title="Solução de problemas de migração" %}

| Problema                                               | Solução                                                                                         |
| ------------------------------------------------------ | ----------------------------------------------------------------------------------------------- |
| <ul><li>Mensagens/canais privados ausentes</li></ul>   | <ul><li>Verifique se o usuário autorizou a migração</li></ul>                                   |
| <ul><li>Trabalho de migração preso</li></ul>           | O aplicativo de migração tentará novamente automaticamente                                      |
| <ul><li>Alguns usuários não mapeados no Zoom</li></ul> | Certifique-se de que existam no Zoom com o mesmo e-mail e execute novamente quaisquer migrações |
| {% endtab %}                                           |                                                                                                 |
| {% endtabs %}                                          |                                                                                                 |

{% embed url="<https://zoom.us/clips/share/6BSj6RGPRLGKdWrxoJgFzQ>" %}

### Análise pós-morte da migração <a href="#imyt8hpau63q" id="imyt8hpau63q"></a>

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

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

| Etapa                                 | Ação                                                                                                                                                                                                                                                                                                                                                  |
| ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Verificar a Migração**              | <ul><li>Inicie sessão no Zoom Chat e verifique se os canais, mensagens e arquivos aparecem corretamente.</li><li>Encerrar sessão e iniciar sessão novamente para atualizar o histórico do chat.</li></ul>                                                                                                                                             |
| **Corrigir quaisquer dados ausentes** | <ul><li>Reenvie as solicitações de autorização aos usuários que não aprovaram o acesso aos dados privados.</li><li>Revise os trabalhos de migração em busca de erros e tente novamente quaisquer trabalhos com falha.</li></ul>                                                                                                                       |
| **(Opcional) Desativar o Slack**      | <ul><li>Após confirmar que a migração de dados foi concluída, você pode arquivar ou remover o local de trabalho do Slack.</li></ul>                                                                                                                                                                                                                   |
| **Solução de problemas geral**        | <ul><li>Se mensagens estiverem ausentes, tente encerrar a sessão e iniciar sessão novamente no Zoom.</li><li>Se os usuários não puderem ser encontrados, verifique se os endereços de e-mail correspondem entre o Slack e o Zoom.</li><li>Se a migração falhar, verifique os logs para obter detalhes do erro e tente novamente o processo.</li></ul> |

#### <mark style="color:azul;">Lista de verificação adicional de solução de problemas</mark> <a href="#id-4fni3sa5k3oh" id="id-4fni3sa5k3oh"></a>

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

{% hint style="info" %}
Antes de continuar, você deve obter o **ID de rastreamento do Zoom da chamada web** e recuperar ambos **IDs da conta** e **IDs do usuário**.
{% endhint %}

| Categoria                                                                  | Descrição do problema                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Configurações da conta Zoom**                                            | <ul><li>Confirme que a funcionalidade de chat em equipe está ativada em todos os níveis</li><li>Verifique se todas as configurações de compartilhamento de arquivos estão ativadas em todos os níveis e documente quaisquer restrições de arquivos</li><li>Verifique se "Permitir que os usuários criem canais públicos + privados" está ativado em todos os níveis</li></ul>                                                                                                                                           |
| **Problemas de usuário do Zoom**                                           | <ul><li>Verifique o status de administrador do usuário</li><li>Confirme se o e-mail do operador da ferramenta corresponde entre o Zoom e o Slack</li><li>Verifique os endereços de e-mail correspondentes dos usuários que estão sendo migrados tanto no Zoom quanto no Slack</li></ul>                                                                                                                                                                                                                                 |
| **Problemas no trabalho de migração**                                      | <ul><li>Verifique o status de conclusão do trabalho (aprovado/falhado)</li><li>Determine se o trabalho envolveu canais públicos ou canais/conversas privados</li></ul>                                                                                                                                                                                                                                                                                                                                                  |
| **Se a migração foi aprovada, mas mensagens/conversas não estão visíveis** | <ul><li>Confirme se o intervalo de tempo GMT captura corretamente o intervalo de mensagens do Slack pretendido (as datas de início/fim da migração começam às 00:00 GMT (PST +7))</li><li>Verifique a criação adequada do canal</li><li>Certifique-se de que o usuário encerrou a sessão e voltou a entrar no cliente após a migração</li><li>Confirme a criação adequada dos usuários migrados no Zoom</li><li>Verifique a visibilidade da mensagem/conversa no portal de administração do histórico do chat</li></ul> |
| **Se a migração falhou**                                                   | <ul><li>Documente a mensagem de erro específica</li><li>Para falhas na migração de arquivos, registre o nome do arquivo problemático</li><li>Documente as ações do usuário tomadas após a falha (nova tentativa do trabalho, criação de novo trabalho etc.)</li></ul>                                                                                                                                                                                                                                                   |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://library.zoom.com/technical-library/pt/zoom-workplace/zoom-chat/zoom-team-chat-migration-app-field-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
