> For the complete documentation index, see [llms.txt](https://library.zoom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://library.zoom.com/technical-library/pt/zoom-workplace/zoom-chat/zoom-team-chat-migration-app-field-guide.md).

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

### 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 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](https://marketplace.zoom.us/apps/5ZXfqVPZSfqBYeCR9VLsBg) 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 <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                                                                                                                                       | 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.

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

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                    |

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

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.

{% hint style="info" %}
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.
{% endhint %}

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

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

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

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

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](https://api.slack.com/authentication/oauth-v2) 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`

#### <mark style="color:azul;">Considerações sobre a 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, 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.

{% hint style="success" %}
Embora você possa replicar mais dados do Slack para o Zoom Chat, a Zoom recomenda **apenas replicando um (1) ano de dados Ativo e arquivando o restante**. A maioria dos usuários raramente precisa pesquisar além de um único ano para desempenhar sua Função e comunicar. 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 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](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) 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](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:

* 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](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 pelo 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 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"

#### <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 de Migração de chat 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. 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)](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0058132) para obter 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, 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.
{% endhint %}

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

{% hint style="info" %}
O administrador que usa 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. Ele não pode ser um tipo de administrador personalizado. Saiba mais sobre [identificação de 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 do Suporte do Zoom.
{% endhint %}

#### <mark style="color:azul;">Conecte o 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 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.

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

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.

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

### A executar tarefas de migração <a href="#jpygqaz4w6nu" id="jpygqaz4w6nu"></a>

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

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

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.

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

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

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.

{% hint style="warning" %}
Tratando 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 por e-mail para aprovação assim que o trabalho de migração for criado.
* Os administradores podem acompanhar quais usuários aprovaram e quais não aprovaram. Para a migração de chat privado, basta a autorização de um único 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 um sucesso ideal na migração, busque 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 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:

{% 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 travado</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 eles 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-migração <a href="#imyt8hpau63q" id="imyt8hpau63q"></a>

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**             | <ul><li>Inicie sessão no chat do Zoom e verifique se os canais, as mensagens e os arquivos aparecem corretamente.</li><li>Encerre sessão e inicie sessão novamente para atualizar o histórico do chat.</li></ul>                                                                                                                                 |
| **Corrija quaisquer dados ausentes** | <ul><li>Reenvie solicitações de autorização aos usuários que não aprovaram o acesso a dados privados.</li><li>Revise os trabalhos de migração em busca de erros e tente novamente quaisquer trabalhos com falha.</li></ul>                                                                                                                       |
| **(Opcional) Desative 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 gerais**      | <ul><li>Se houver mensagens ausentes, tente encerrar 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 o processo novamente.</li></ul> |

#### <mark style="color:azul;">Lista de verificação adicional para 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 poderá 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 pela web** e recuperar ambos **IDs da conta** e **IDs de usuário**.
{% endhint %}

| Categoria                                                                     | Descrição do problema                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ----------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Configurações da conta Zoom**                                               | <ul><li>Confirme se 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 arquivo</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 de trabalho de migração**                                         | <ul><li>Verifique o status de conclusão do trabalho (aprovado/com falha)</li><li>Determine se o trabalho envolveu canais públicos ou canais/conversas privados</li></ul>                                                                                                                                                                                                                                                                                                                                                          |
| **Se a migração foi aprovada, mas as mensagens/conversas não estão visíveis** | <ul><li>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))</li><li>Verifique a criação adequada do canal</li><li>Certifique-se de que o usuário tenha encerrado sessão e iniciado sessão novamente 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 de mensagens/conversas no portal de administração do Histórico de 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, gravar o nome do arquivo problemático</li><li>Documente as ações do usuário realizadas após a falha (nova tentativa do trabalho, criação de novo trabalho etc.)</li></ul>                                                                                                                                                                                                                                                            |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
