# Guida sul campo dell’app di migrazione di Zoom Chat

### Introduzione <a href="#ix9eykivgqnt" id="ix9eykivgqnt"></a>

La Zoom Chat Migration App Field Guide è una risorsa completa per gli amministratori IT, che fornisce istruzioni passo passo per trasferire i workspace Slack a Zoom Chat. Copre i processi essenziali per la migrazione di canali pubblici, canali privati e messaggi diretti, mantenendo l'integrità dei dati e la cronologia delle comunicazioni degli utenti.

La [Zoom Chat Migration App](https://marketplace.zoom.us/apps/5ZXfqVPZSfqBYeCR9VLsBg) implementa un'architettura a doppio motore per trasferire i dati dei workspace Slack negli ambienti Zoom Chat. Gli amministratori di sistema hanno accesso a diversi percorsi di migrazione.

### Panoramica della migrazione <a href="#jemq5k6izt7b" id="jemq5k6izt7b"></a>

Esistono diversi modi per migrare i dati di Slack utilizzando la Zoom Chat Migration App, a seconda delle dimensioni dell'organizzazione, del piano Slack e dei requisiti di sicurezza.

Inoltre, devi soddisfare alcuni prerequisiti di Slack e Zoom, creare un piano di migrazione e unificare i tuoi workspace Slack. Questa sezione fornisce una panoramica di questi prerequisiti e considerazioni.

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

#### <mark style="color:blu;">Opzioni di migrazione</mark> <a href="#h29eaaqgvd9c" id="h29eaaqgvd9c"></a>

La seguente tabella descrive gli approcci di migrazione più comuni:

| Metodo di migrazione                                          | Descrizione                                                                                                                                      | Ideale per                                                                                       | Requisiti                                                                                                           | Vantaggio                                                                                                                           |
| ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| **Migrazione API (basata su app)**                            | Utilizza un'app di migrazione per connettersi direttamente alle API di Slack e trasferire i dati. Supporta canali pubblici, canali privati e DM. | Organizzazioni più piccole o casi in cui è fattibile ottenere l'autorizzazione degli utenti      | Gli utenti devono autorizzare l'accesso ai propri dati per le chat private e i DM                                   | Trasferimento dei dati completamente automatizzato e senza interruzioni direttamente da Slack                                       |
| **Migrazione con strumento di importazione (basata su file)** | Utilizza i file di esportazione di Slack per migrare i dati tramite lo strumento di importazione di Zoom                                         | Organizzazioni con piani Slack Plus o Enterprise Grid                                            | Gli amministratori devono esportare i dati di Slack dalla dashboard amministratore di Slack                         | Nessuna autorizzazione utente necessaria; ideale per migrazioni di grandi volumi, soprattutto chat private                          |
| **Approccio ibrido (API + importazione)**                     | Combina i metodi API e importazione: canali pubblici tramite API; canali privati e DM tramite lo strumento di importazione                       | Organizzazioni medio-grandi che vogliono evitare la complessità dell'autorizzazione degli utenti | Accesso amministrativo sia per l'esportazione di Slack sia per la configurazione della migrazione API basata su app | Evita l'attrito dell'autorizzazione degli utenti per le chat private mantenendo l'automazione per la migrazione dei canali pubblici |

**Vincoli di sistema**

Il processo di migrazione è soggetto a vincoli specifici:

* **Capacità massima di un singolo job**: 12 mesi di dati storici
* **Finestra totale di migrazione**: 60 mesi (5 anni)
* **Concorrenza dei job**: può essere in esecuzione un solo job alla volta

Questa architettura tecnica consente la migrazione sistematica dei dati di comunicazione aziendali mantenendo i protocolli di sicurezza e l'integrità dei dati.

#### <mark style="color:blu;">Mappatura dei dati da Slack a Zoom</mark> <a href="#z9gs91q4zgvi" id="z9gs91q4zgvi"></a>

La seguente tabella di mappatura può aiutarti a comprendere la connessione tra Slack e Zoom Chat prima della migrazione:

| Funzionalità di Slack     | Corrispondente in Zoom Chat | Note                                                                          |
| ------------------------- | --------------------------- | ----------------------------------------------------------------------------- |
| Canali pubblici           | Canali pubblici             | Migrati automaticamente                                                       |
| Canali privati            | Canali privati              | Richiede l'approvazione dell'utente                                           |
| Messaggi diretti (DM)     | Chat 1:1                    | Richiede l'approvazione dell'utente                                           |
| DM di gruppo              | Chat di gruppo              | Richiede l'approvazione dell'utente                                           |
| Thread                    | Risposte in linea           | Non completamente a thread come in Slack, ma mantiene l'ordine delle risposte |
| @ Menzioni                | @ Menzioni                  | Stesso comportamento                                                          |
| Reazioni                  | Reazioni con emoji          | Stesso comportamento                                                          |
| File                      | File condivisi              | Richiede l'abilitazione dell'archiviazione su cloud                           |
| Messaggi pinnati          | Messaggi con stella         | I messaggi pinnati diventano con stella                                       |
| Messaggi di bot/app Slack | Solo testo (nessuna scheda) | Le schede ricche delle app non verranno migrate                               |

#### <mark style="color:blu;">Prerequisiti di account e autorizzazioni</mark> <a href="#pppv0j3jhmh6" id="pppv0j3jhmh6"></a>

Devi controllare sia il livello del tuo account Slack sia quello di Zoom e le autorizzazioni amministrative prima di procedere.

* Un **account Zoom** Pro, Business, Enterprise o Education
* Slack e Zoom **autorizzazioni amministrative** sono necessari per autorizzare la migrazione.

{% hint style="info" %}
L'amministratore che installa l'app Zoom Marketplace deve accedere alla gestione dei ruoli nel portale web. Deve assicurarsi di avere assegnate le corrette autorizzazioni di gestione chat - la casella **Modifica** deve essere selezionata per i ruoli **Canali chat** e **Messaggi chat** . In caso contrario, non sarà in grado di autorizzare la Zoom Slack Migration app a causa di autorizzazioni insufficienti.
{% endhint %}

* L'archiviazione su cloud deve essere abilitata per la **conservazione di messaggi/file**.

**API di Slack: ambiti, autorizzazioni e limiti di velocità**

Le API di Slack vengono utilizzate per recuperare i dati di utenti, canali e messaggi di Slack. Questi tipi di dati hanno limiti di velocità, consentendo solo un certo numero di richieste al minuto per uno workspace Slack. Si tratta di un aspetto importante da considerare quando pianifichi la tempistica della migrazione.

**Parametri di prestazione dei job di migrazione Slack**

Le seguenti tabelle forniscono stime per le migrazioni Slack.

{% tabs %}
{% tab title="Analisi comparativa delle prestazioni per metodo di implementazione della migrazione" %}

| Metodo di migrazione        | Intervallo di dati | Tempo di elaborazione per canale | Tempo stimato di migrazione\*                 |
| --------------------------- | ------------------ | -------------------------------- | --------------------------------------------- |
| Migrazione con importazione | \~2 settimane      | 5-10 secondi                     | 45 secondi - 1 minuto e 15 secondi per canale |
| Migrazione basata su API    | \~2 settimane      | 20-30 secondi                    | 3-5 minuti per canale                         |

<sub>*\*Basato su uno workspace Slack di medie dimensioni con un anno di dati storici*</sub>
{% endtab %}
{% endtabs %}

I job di migrazione incontrano due colli di bottiglia fondamentali che influiscono direttamente sulle tempistiche di implementazione e sulla pianificazione delle risorse. I limiti di elaborazione del trasferimento file influiscono sia sui metodi di migrazione basati su importazione sia su quelli basati su API, creando vincoli di prestazione che richiedono un'adeguata allocazione della larghezza di banda e strategie di ottimizzazione del trasferimento durante la pianificazione della distribuzione. I job di migrazione basati su API affrontano ulteriori restrizioni di prestazione dovute ai meccanismi nativi di limitazione della velocità delle API di Slack. Questi vincoli non influiscono sulle migrazioni di importazione, ma incidono in modo significativo sulle implementazioni basate su API, richiedendo finestre di elaborazione più ampie e una pianificazione attenta dei job per ottimizzare il throughput mantenendo la conformità ai limiti della piattaforma.

Sebbene il tuo workspace Slack possa contenere centinaia o migliaia di canali, la distribuzione dell'attività dei canali segue schemi prevedibili che influiscono direttamente sulle prestazioni di migrazione e sui requisiti di allocazione delle risorse. I canali ad alta attività con estesi storici di messaggi, allegati e interazioni degli utenti richiederanno tutti i tempi di elaborazione di riferimento indicati sopra. Tuttavia, la maggior parte dei canali di un workspace in genere contiene un'attività minima — composta da brevi conversazioni, annunci o discussioni archiviate — che viene migrata molto più velocemente delle stime di riferimento.

**Autorizzazioni e ambiti amministrativi richiesti**

Lo Zoom App Marketplace richiede le seguenti autorizzazioni amministrative e ambiti all'interno del tenant Zoom:

* **Gestione chat > Canali chat = Modifica**
* **Messaggi chat = Modifica**

Lo strumento di migrazione Zoom utilizza API interne che richiedono i seguenti ambiti dell'app Zoom:

* `chat_message:write:admin`
* `imchat:bot`
* `chat_channel:write:admin`
* `user:write:admin`

Zoom XMPP include un campo contenente l'ID messaggio Slack per autenticità e tracciamento storico.

L'app Slack creata da Zoom verrà installata automaticamente nel tenant Slack quando un amministratore si connette a un Workspace tramite lo strumento di migrazione. L'app Slack utilizza[ autenticazione OAuth2](https://api.slack.com/authentication/oauth-v2) per connettersi con Zoom, fornendo il token di autorizzazione per la migrazione dei dati. Gli utenti devono autorizzare la migrazione delle conversazioni private (DM, chat di gruppo e canali privati).

Devi anche impostare l'opzione **Consenti solo app provenienti dalla directory slack** su **OFF**, che consente all'app Slack di installarsi una volta creata la connessione del Workspace. Sono inoltre richiesti i seguenti ambiti 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.email`

#### <mark style="color:blu;">Considerazioni sulla migrazione</mark> <a href="#id-2upmrqx4xrqh" id="id-2upmrqx4xrqh"></a>

Pianificare in anticipo una strategia di migrazione ti farà risparmiare tempo e garantirà una transizione fluida tra le piattaforme. Come esempio generale, Zoom offre la seguente strategia:

1. Decidi quali workspace Slack migrare (uno o più)
2. Scegli quali dati migrare:
   1. Canali pubblici (migrazione automatica)
   2. Canali privati e messaggi diretti (DM) (richiede l'autorizzazione dell'utente)
   3. Messaggi di bot e/o app
3. Decidi quale metodo di migrazione si adatta meglio alle tue esigenze
4. Imposta una tempistica per la migrazione (fino a un massimo di un anno per job)
5. Comunica agli utenti le approvazioni dei messaggi privati

**Consolidamento del workspace Slack**

Per le organizzazioni che utilizzano più workspace Slack, come gli utenti Enterprise Grid, la migrazione a Zoom Chat consolida tutti i workspace in un unico account.

Per differenziare i workspace, Zoom aggiunge il nome originale del Workspace sia ai nomi dei canali sia a quelli delle chat. Ad esempio:

* Canale Slack originale:
  * **#engineering** (con un Workspace di "US Team")
* Canale Zoom migrato:
  * **#engineering: US Team**

Questo consolidamento assicura che tutti i dati vengano migrati in un unico account Zoom Chat, preservando al contempo il contesto originale del Workspace. Gli spazi condivisi possono fornire una struttura aggiuntiva per team o reparti specifici, facilitando l'organizzazione e l'accesso ai contenuti.

**Consolidamento dei dati della chat**

I workspace con più di 100 utenti possono avere decine di migliaia di chat di gruppo private e DM che non sono mai stati archiviati o eliminati, anche dopo che gli utenti sono stati rimossi dall'azienda. Questo fa sì che i job di migrazione privati richiedano molto più tempo di quelli pubblici.

Gli amministratori dovrebbero ripulire i dati obsoleti archiviando manualmente queste vecchie conversazioni oppure aggiornando il periodo di conservazione di Slack per eliminarle automaticamente.

Zoom consiglia di verificare quali dati devono rimanere attivi in Zoom Chat e quali possono essere archiviati per eventuali futuri scopi legali, di conformità, mitigazione del rischio, risorse umane o altri scopi.

{% hint style="success" %}
Sebbene tu possa replicare più dati Slack in Zoom Chat, Zoom consiglia **di replicare solo un (1) anno di dati attivi e archiviare il resto**. La maggior parte degli utenti raramente ha bisogno di cercare oltre un solo anno per svolgere il proprio ruolo e comunicare. Zoom consiglia di creare job di migrazione in batch più piccoli da tre a sei mesi per ottenere migrazioni di dati riuscite.
{% endhint %}

Inoltre, è importante considerare se i dati risiedono attualmente in Slack o se sono integrati con servizi di terze parti per DLP, e-Discovery o archiviazione.

**Conservazione della cronologia chat**

Esistono diverse considerazioni sulla conservazione durante la migrazione da Slack a Zoom, poiché Slack è interamente basato su cloud mentre Zoom offre opzioni di conservazione più granulari:

* Zoom offre sia l'archiviazione locale sul dispositivo sia quella su cloud. [Archiviazione locale sul dispositivo](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063423) può variare da un (1) giorno a sette (7) anni. [Archiviazione su cloud](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0067567) può essere disabilitata o configurata per un periodo di conservazione di 7 anni.
* [Le policy di conservazione](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060329) possono essere configurate sia a livello di account sia di gruppo per gli utenti.
* Gli amministratori possono impostare tempi di conservazione specifici per singoli canali, se necessario.
* Gli amministratori possono specificare una policy di conservazione per i DM o le chat di gruppo e impostarne un'altra per i canali chat.
* Per la reportistica della cronologia chat, Zoom consiglia di archiviare le revisioni e le eliminazioni dei messaggi modificati.

Consulta l'articolo di Zoom Support [Archiviazione della cronologia dei messaggi di Zoom Chat](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060329) per saperne di più sulla conservazione della cronologia chat.

### Best practice <a href="#ingmqmxix4r2" id="ingmqmxix4r2"></a>

#### <mark style="color:blu;">Best practice per la pre-migrazione</mark> <a href="#est83jfa09dc" id="est83jfa09dc"></a>

Segui questi consigli per un processo di pre-migrazione più semplice:

* Assicurati che gli utenti abbiano creato account su Zoom e si siano autenticati almeno una volta.
* Gli amministratori hanno aggiunto l'app Slack Migration al proprio account Zoom.
* Gli amministratori che eseguono la migrazione devono disporre delle autorizzazioni per entrambe le piattaforme (Slack e Zoom Chat) e la loro e-mail deve corrispondere tra gli account Zoom e Slack.
* Gli amministratori devono utilizzare l'app Zoom Chat Migration per configurare i job di migrazione per trasferire i dati da Slack a Zoom Chat. Nota: questo processo richiede un minimo di 2 job perché almeno 1 job trasferirà le conversazioni private e 1 job trasferirà i canali pubblici.
* Gli amministratori dovrebbero archiviare o eliminare i dati Slack non necessari che non desiderano migrare in Chat per contribuire ad ускорare le migrazioni.
* Se utilizzi job di API Migration per migrare dati privati, assicurati che gli utenti sappiano quando e come autorizzeranno Slack a trasferire i propri dati in Chat.
* Se prevedi di usare job di Import Migration, segui [le istruzioni di Slack per esportare i dati della tua workspace come file .zip](https://slack.com/help/articles/201658943-Export-your-workspace-data).
  * Requisiti del file:
    * Il nome del file .zip non deve essere modificato rispetto al formato originale esportato da Slack
    * La dimensione del file .zip non deve superare 10 GB

#### <mark style="color:blu;">Best practice per la migrazione</mark> <a href="#id-8soj3en5qd2g" id="id-8soj3en5qd2g"></a>

Il seguente processo fornisce una panoramica generale della migrazione:

1. Prima della migrazione, assicurati che gli utenti siano creati in Zoom e si siano autenticati almeno una volta.
2. Gli amministratori dovrebbero preparare e aggiungere l'app Slack Migration al proprio account Zoom.
3. L'amministratore che esegue la migrazione deve avere le autorizzazioni appropriate per entrambe le piattaforme e indirizzi e-mail corrispondenti tra gli account Zoom e Slack.
4. Gli amministratori devono installare l'app privata in Slack per connettersi a Zoom ed eseguire l'autenticazione OAuth.
5. Gli amministratori utilizzano l'app Zoom Chat Migration per configurare i job di migrazione per spostare i dati da Slack a Zoom Chat. Questo richiede un minimo di 2 job - uno per le conversazioni private e uno per i canali pubblici.

Durante la migrazione, segui questi passaggi consigliati:

1. Migra i dati di un canale selezionando il tipo di conversazione Seleziona canali pubblici e scegliendo un canale specifico. Seleziona una settimana di dati da alcuni dei tuoi canali più vecchi.
2. Crea job per trasferire tutti i canali pubblici risalenti a più di un anno fa, quindi verifica che tutti i canali siano stati creati con gli utenti.
3. Dopo aver verificato che l'app funzioni come previsto, crea ed esegui meno job con intervalli di tempo più ampi invece di più job con intervalli di tempo più piccoli. Ogni job contiene lo stesso numero di passaggi di migrazione.
4. (Facoltativo) Ripeti questi passaggi per le migrazioni dei job privati.

Dopo la migrazione dei dati, i tuoi dati appariranno come segue:

* I nomi dei canali pubblici/privati e delle chat di gruppo appariranno come: #nome-canale: nome-workspace
* I messaggi inviati dagli utenti Slack con account Zoom attivi appariranno normalmente come se fossero stati inviati da quegli utenti Zoom
* I messaggi inviati da utenti Slack senza account Zoom attivi appariranno come inviati da un utente Zoom disattivato con il nome del mittente del messaggio Slack
* I messaggi di sistema verranno migrati (ad es. "@Some User has joined the channel")
* Tutti i messaggi verranno migrati come letti, indipendentemente dal loro stato in Slack
* Un avviso di completamento della migrazione verrà inviato a ciascun canale pubblico e privato al termine, apparendo come "Message is sent from Chat Migration App, Day Date Time"

#### <mark style="color:blu;">Eliminazione dell'app di migrazione</mark> <a href="#id-35kihp9337s8" id="id-35kihp9337s8"></a>

L'app di migrazione mantiene mappature 1:1 tra le conversazioni Slack e Zoom dopo la migrazione.

{% hint style="warning" %}
Rimuovere questa app dal tuo account Zoom eliminerà queste mappature, causando canali e chat duplicati se la reinstalli e migri di nuovo. Elimina l'app Chat Migration solo se sei certo che non saranno necessarie ulteriori migrazioni.
{% endhint %}

### Installazione <a href="#vfotb6a19pij" id="vfotb6a19pij"></a>

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

Per installare l'app:

1. Accedi al Zoom App Marketplace.
2. Cerca Chat Migration e fai clic su **Aggiungi**.
3. Rivedi e approva le autorizzazioni necessarie.

Consulta l'articolo di Zoom Support [Utilizzo dell'app Chat Migration (strumento Slack Migration)](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0058132) per istruzioni di installazione più dettagliate.

{% hint style="info" %}
Gli amministratori devono concedere l'autorizzazione all'account workspace o all'organizzazione Slack per installare e autorizzare l'applicazione privata, **Message Retriever**. In generale, un amministratore deve approvare l'uso delle app in uno workspace Slack e concedere anche le autorizzazioni a tutti i membri per usare l'app.
{% endhint %}

Gli amministratori devono concedere l'autorizzazione a installare l'app Chat Migration nel proprio account Zoom insieme a due autorizzazioni di Chat Management nel ruolo di amministratore.

L'opzione **Consenti solo app dalla Slack App Directory** deve essere **disabilitata**.

{% hint style="info" %}
L'amministratore che usa l'app deve avere un [ruolo di amministratore dell'account](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060684#h_01FCBKK69SJNA90M1J07SSJ1YB) per migrare le conversazioni. Non può essere un tipo di amministratore personalizzato. Scopri di più su [identificazione dei tipi di account, ruoli e licenze](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060684) e [gestione dei ruoli](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064983) sul sito Zoom Support.
{% endhint %}

#### <mark style="color:blu;">Collega il tuo workspace Slack per i job di API Migration</mark> <a href="#xjbm4ds0xh3" id="xjbm4ds0xh3"></a>

Se non stai usando il metodo di importazione file, queste istruzioni ti aiuteranno a connetterti per le migrazioni API.

Per connettere un workspace:

1. Apri l'app Chat Migration in Zoom.
2. Fai clic su **Crea connessione > Accedi a Slack** e autorizza.
3. Conferma la connessione del workspace nella dashboard di Zoom.

#### <mark style="color:blu;">Esegui l'attività di sincronizzazione utenti</mark> <a href="#qo97g1d6dweq" id="qo97g1d6dweq"></a>

L'attività di sincronizzazione utenti recupera tutti i membri completi e attivi del tuo workspace Slack e crea una mappatura 1:1 al loro account Zoom corrispondente utilizzando il loro indirizzo e-mail.

Se l'indirizzo e-mail di un utente Slack attivo non viene trovato sul lato Zoom, verrà creato un nuovo utente disattivato all'interno di Zoom per quell'indirizzo e-mail.

Se l'indirizzo e-mail di un utente Slack attivo viene trovato sotto un account Zoom diverso, ad esempio un account personale, l'utente verrà mappato a un profilo di "utente fittizio". Nel tuo account Zoom, questo utente si chiamerà **TeamChatMigration AppUser** e sarà presente per garantire che tutti i dati dei messaggi vengano migrati per il tuo workspace.

{% hint style="warning" %}
Non eliminare l' **TeamChatMigration AppUser** utente.
{% endhint %}

### Esecuzione dei job di migrazione <a href="#jpygqaz4w6nu" id="jpygqaz4w6nu"></a>

La seguente sezione ti aiuterà ad avviare i job necessari per la migrazione.

#### <mark style="color:blu;">Creazione di un job di migrazione con importazione</mark> <a href="#c2p4z4dmsd2d" id="c2p4z4dmsd2d"></a>

Per creare un nuovo job di migrazione:

1. Fai clic su **Carica file**, seleziona il tuo file di esportazione Slack, quindi fai clic su **Carica**.
2. Attendi che il file venga caricato su Zoom.
   1. Nota: non uscire dalla pagina né aggiornarla, poiché ciò interromperà il caricamento del file e il job rimarrà bloccato nello stato "Caricamento". Se ciò accade, puoi eliminare il job "Caricamento" e riavviare il processo
3. Una volta completato il caricamento iniziale del file, una **finestra Dettagli migrazione** si aprirà mentre l'app di migrazione prepara il file per la migrazione. A questo punto, puoi chiudere, uscire o aggiornare la pagina mentre attendi che il job sia pronto per l'esecuzione.
4. Dopo che lo strumento avrà terminato la preparazione del file per la migrazione, potrai selezionare i tipi di conversazione da migrare.
5. Una volta selezionati i tipi di conversazione, fai clic su **Esegui** per avviare il job di migrazione.

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

#### <mark style="color:blu;">Creazione di un job di migrazione API</mark> <a href="#ad0zjh4rce2h" id="ad0zjh4rce2h"></a>

Per creare un nuovo job di migrazione:

1. Fai clic su **Nuovo job di migrazione** e seleziona il workspace Slack.
2. Scegli il **ambito dei dati**:
   * Canali pubblici (vengono migrati automaticamente).
   * Canali privati e DM (richiedono l'autorizzazione dell'utente).
   * Intervallo di date specifico per i messaggi.
3. Una volta selezionato l'ambito e l'intervallo dei dati e ottenuta l'autorizzazione dagli utenti, seleziona **Esegui** per avviare il job di migrazione.

{% hint style="warning" %}
Gestione delle richieste di autorizzazione per dati privati per canali privati e DM:

* **I canali privati e i DM richiedono l'approvazione dell'utente** prima della migrazione.
* Zoom invierà automaticamente richieste di approvazione via e-mail una volta creato il job di migrazione.
* Gli admin possono tracciare quali utenti hanno/non hanno approvato. Per la migrazione delle chat private, è necessaria l'autorizzazione di un solo utente per migrare l'intera cronologia della conversazione.
* Le e-mail di richiesta di autorizzazione vengono inviate solo agli utenti che non hanno ancora fornito l'approvazione.
* Per ottenere il miglior successo di migrazione, punta a ottenere l'autorizzazione da circa il 60-70% dei tuoi utenti.
  {% endhint %}

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

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

#### <mark style="color:blu;">Esecuzione e monitoraggio dei job di migrazione</mark> <a href="#nbokwove1l8n" id="nbokwove1l8n"></a>

**Avvio di un nuovo job di migrazione**

Per avviare l'esecuzione di un job di migrazione:

1. Fai clic su **Esegui migrazione** per iniziare il processo.
2. I tempi di migrazione variano (i workspace grandi possono richiedere **12+ ore**).
3. Monitora l'avanzamento nella **Dashboard migrazione**.

**Risoluzione dei problemi dei job di migrazione**

Occasionalmente, un job di migrazione potrebbe non restituire il risultato desiderato. La seguente tabella fornisce soluzioni per i possibili problemi riscontrati durante la migrazione:

{% tabs %}
{% tab title="Risoluzione dei problemi di migrazione" %}

| Problema                                            | Soluzione                                                                            |
| --------------------------------------------------- | ------------------------------------------------------------------------------------ |
| <ul><li>Messaggi/canali privati mancanti</li></ul>  | <ul><li>Controlla se l'utente ha autorizzato la migrazione</li></ul>                 |
| <ul><li>Job di migrazione bloccato</li></ul>        | L'app di migrazione ritenterà automaticamente                                        |
| <ul><li>Alcuni utenti non mappati in Zoom</li></ul> | Assicurati che esistano in Zoom con la stessa e-mail e riesegui eventuali migrazioni |
| {% endtab %}                                        |                                                                                      |
| {% endtabs %}                                       |                                                                                      |

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

### Postmortem della migrazione <a href="#imyt8hpau63q" id="imyt8hpau63q"></a>

Dopo aver completato una migrazione, Zoom consiglia di eseguire un postmortem approfondito e verificare che i tuoi contenuti Slack siano stati trasferiti in Chat come previsto.

La seguente tabella fornisce le attività consigliate per convalidare le migrazioni chat:

| Passaggio                             | Azione                                                                                                                                                                                                                                                                                       |
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Verifica la migrazione**            | <ul><li>Accedi a Zoom Chat e verifica che canali, messaggi e file vengano visualizzati correttamente.</li><li>Esci e accedi di nuovo per aggiornare la cronologia chat.</li></ul>                                                                                                            |
| **Correggi eventuali dati mancanti**  | <ul><li>Invia nuovamente le richieste di autorizzazione agli utenti che non hanno approvato l'accesso ai dati privati.</li><li>Rivedi i job di migrazione per eventuali errori e riprova i job non riusciti.</li></ul>                                                                       |
| **(Facoltativo) Dismettere Slack**    | <ul><li>Dopo aver confermato che la migrazione dei dati è completa, puoi archiviare o rimuovere il workspace Slack.</li></ul>                                                                                                                                                                |
| **Risoluzione generale dei problemi** | <ul><li>Se mancano messaggi, prova a uscire e rientrare in Zoom.</li><li>Se gli utenti non vengono trovati, verifica che gli indirizzi e-mail corrispondano tra Slack e Zoom.</li><li>Se la migrazione fallisce, controlla i log per i dettagli dell'errore e riprova il processo.</li></ul> |

#### <mark style="color:blu;">Checklist aggiuntiva per la risoluzione dei problemi</mark> <a href="#id-4fni3sa5k3oh" id="id-4fni3sa5k3oh"></a>

Se scopri ulteriori problemi dopo la migrazione, questa checklist può fornire ulteriori passaggi e azioni da eseguire per la verifica.

{% hint style="info" %}
Prima di continuare, devi ottenere il **tracking ID Zoom dalla chiamata web** e recuperare entrambi **ID account** e **ID utente**.
{% endhint %}

| Categoria                                                                              | Descrizione del problema                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Impostazioni dell'account Zoom**                                                     | <ul><li>Conferma che la funzionalità di chat del team sia abilitata a tutti i livelli</li><li>Verifica che tutte le impostazioni di condivisione file siano abilitate a tutti i livelli e documenta eventuali restrizioni sui file</li><li>Verifica che "Consenti agli utenti di creare canali pubblici + privati" sia abilitato a tutti i livelli</li></ul>                                                                                                                                                              |
| **Problemi utente Zoom**                                                               | <ul><li>Verifica lo stato di amministratore dell'utente</li><li>Conferma che l'e-mail dell'operatore dello strumento corrisponda tra Zoom e Slack</li><li>Verifica che gli indirizzi e-mail degli utenti da migrare corrispondano sia in Zoom sia in Slack</li></ul>                                                                                                                                                                                                                                                      |
| **Problemi del job di migrazione**                                                     | <ul><li>Controlla lo stato di completamento del job (superato/non riuscito)</li><li>Determina se il job ha coinvolto canali pubblici o canali/conversazioni private</li></ul>                                                                                                                                                                                                                                                                                                                                             |
| **Se la migrazione è andata a buon fine, ma messaggi/conversazioni non sono visibili** | <ul><li>Conferma che l'intervallo di tempo GMT catturi correttamente l'intervallo di messaggi Slack previsto (le date di migrazione iniziano/terminano alle 12:00 GMT (PST +7))</li><li>Verifica la corretta creazione del canale</li><li>Assicurati che l'utente abbia effettuato il logout e poi di nuovo l'accesso al client dopo la migrazione</li><li>Conferma la corretta creazione degli utenti migrati in Zoom</li><li>Verifica la visibilità dei messaggi/conversazioni nel portale Chat History Admin</li></ul> |
| **Se la migrazione è fallita**                                                         | <ul><li>Documenta il messaggio di errore specifico</li><li>Per i fallimenti della migrazione dei file, registra il nome del file problematico</li><li>Documenta le azioni dell'utente intraprese dopo il fallimento (ritentativo del job, creazione di un nuovo job, ecc.)</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/it/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.
