# Guida pratica dell'app per la migrazione di Zoom chat

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

La guida del campo dell'app Zoom Chat Migration è una risorsa completa per gli amministratori IT, che fornisce istruzioni passo passo per trasferire le aree di lavoro Slack a Zoom Chat. Copre i processi essenziali per migrare i canali pubblici, i canali privati e i messaggi diretti, mantenendo l'integrità dei dati e la cronologia delle comunicazioni degli utenti.

Il [app Zoom Chat Migration](https://marketplace.zoom.us/apps/5ZXfqVPZSfqBYeCR9VLsBg) implementa un'architettura a doppio motore per trasferire i dati dell'area di lavoro Slack agli 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 usando l'app Zoom Chat Migration, a seconda delle dimensioni della tua 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 le tue aree di lavoro 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 i metodi di migrazione più comuni:

| Metodo di migrazione                                          | Descrizione                                                                                                                                       | Ideale per                                                                                                      | Requisiti                                                                                                        | Vantaggio                                                                                                                                     |
| ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| **Migrazione API (basata su app)**                            | Usa un'app di migrazione per connettersi direttamente alle API di Slack e trasferire i dati. Supporta i canali pubblici, i canali privati e i DM. | Organizzazioni più piccole o casi in cui è possibile ottenere l'autorizzazione dell'utente                      | 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)** | Usa 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 admin devono esportare i dati di Slack dal dashboard di admin di Slack                                       | Non è necessaria l'autorizzazione dell'utente; ideale per la migrazione in blocco, soprattutto delle 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 di medie e grandi dimensioni che vogliono evitare la complessità dell'autorizzazione dell'utente | Accesso admin sia per l'esportazione dei dati Slack sia per la configurazione della migrazione API basata su app | Evita le difficoltà legate all'autorizzazione dell'utente 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 eseguito solo un job alla volta

Questa architettura tecnica consente una migrazione sistematica dei dati di comunicazione dell'Enterprise, mantenendo al contempo 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 dettaglio della mappatura può aiutarti a comprendere la connessione tra Slack e Zoom Chat prima della migrazione:

| Funzionalità di Slack        | Equivalente 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 organizzato in thread come Slack, ma mantiene l'ordine delle risposte |
| @ Menzioni                   | @ Menzioni                             | Stesso comportamento                                                                    |
| Reazioni                     | Reazioni con Emoji                     | Stesso comportamento                                                                    |
| File                         | File condivisi                         | Richiede che l'archiviazione su cloud sia abilitata                                     |
| Messaggi ancorati            | Messaggi contrassegnati con una stella | I messaggi ancorati diventano contrassegnati con una stella                             |
| Messaggi di bot/app di Slack | Solo testo (nessuna scheda)            | Le schede avanzate dell'app non verranno migrate                                        |

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

Devi controllare sia i livelli del tuo account Slack sia quelli del tuo account Zoom e le autorizzazioni admin prima di procedere.

* Un **Pro, Business, Enterprise o Istruzione** È richiesto un account Zoom.
* Slack e Zoom **autorizzazioni admin** sono necessarie per autorizzare la migrazione.

{% hint style="info" %}
L'admin che installa l'app Zoom Marketplace deve accedere alla gestione ruoli sul portale web. Deve assicurarsi che gli siano assegnate le autorizzazioni corrette per la gestione della chat: la casella di controllo **Modifica** deve essere selezionata per i Ruolo di **Canali chat** e **Messaggi chat** Altrimenti, non potrà autorizzare l'app Zoom Slack Migration 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 frequenza**

Le API di Slack vengono utilizzate per recuperare i dati di utente, canale e messaggio di Slack. Questi tipi di dati hanno limiti di frequenza, che consentono solo un determinato numero di richieste al minuto per un'area di lavoro Slack. Questa è una considerazione importante quando pianifichi la tempistica della migrazione.

**Benchmark delle prestazioni dei processi di migrazione Slack**

Le tabelle seguenti 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 di migrazione stimato\*                 |
| ------------------------------- | ------------------ | -------------------------------- | --------------------------------------------- |
| Migrazione tramite 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 un'area di lavoro Slack di medie dimensioni con un anno di dati storici*</sub>
{% endtab %}
{% endtabs %}

I processi di migrazione incontrano due colli di bottiglia fondamentali che influiscono direttamente sulle tempistiche di implementazione e sulla pianificazione delle risorse. Le limitazioni nell'elaborazione del trasferimento dei file influiscono sia sui metodi di migrazione tramite importazione sia su quelli basati su API, creando vincoli di prestazione che richiedono un'allocazione adeguata della larghezza di banda e strategie di ottimizzazione del trasferimento durante la pianificazione dell'implementazione. I processi di migrazione basati su API affrontano ulteriori restrizioni di prestazione dovute ai meccanismi nativi di limitazione della frequenza delle API di Slack. Questi vincoli non influiscono sulle migrazioni tramite importazione, ma incidono significativamente sulle implementazioni basate su API, richiedendo finestre di elaborazione più estese e un'attenta pianificazione dei processi per ottimizzare il throughput mantenendo la conformità con le limitazioni della piattaforma.

Sebbene la tua area di lavoro Slack possa contenere centinaia o migliaia di canali, la distribuzione dell'attività dei canali segue schemi prevedibili che influiscono direttamente sulle prestazioni della migrazione e sui requisiti di allocazione delle risorse. I canali ad alta attività con cronologie dei messaggi estese, allegati di file e interazioni degli utenti richiederanno i tempi completi di elaborazione di benchmark indicati sopra. Tuttavia, la maggior parte dei canali dell'area di lavoro in genere contiene attività minima, costituita da brevi conversazioni, annunci o discussioni archiviate che migrano significativamente più velocemente rispetto alle stime di benchmark.

**Permessi e ambiti admin richiesti**

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

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

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

* `chat_message:write:admin`
* `imchat:bot`
* `chat_canale:write:admin`
* `utente:scrivi:admin`

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

L'app Slack creata da Zoom verrà installata automaticamente nel tenant Slack quando un admin si connette a un'area di lavoro 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 (messaggi diretti, chat di gruppo e canali privati).

Devi anche impostare l'opzione **Consentire solo app dalla directory slack** su **OFF**, che consente l'installazione dell'app Slack una volta creata la connessione all'area di lavoro. Sono inoltre necessari i seguenti scope di 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:blu;">Considerazioni sulla migrazione</mark> <a href="#id-2upmrqx4xrqh" id="id-2upmrqx4xrqh"></a>

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

1. Decidi quali aree di lavoro Slack migrare (una 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 dei bot e/o dell'app
3. Decidi quale metodo di migrazione si adatta meglio alle tue esigenze
4. Imposta un intervallo di tempo per la migrazione (fino a un massimo di un anno per lavoro)
5. Comunicare con gli utenti in merito alle approvazioni dei messaggi privati

**Consolidamento dell’area di lavoro Slack**

Per le organizzazioni che utilizzano più aree di lavoro Slack, come gli utenti di Enterprise Grid, la migrazione a Zoom chat consolida tutte le aree di lavoro in un unico account.

Per differenziare tra le aree di lavoro, Zoom aggiunge il nome originale dell’area di lavoro sia ai nomi dei canali sia ai nomi delle chat. Ad esempio:

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

Questo consolidamento garantisce che tutti i dati vengano migrati in un unico account Zoom chat, preservando al contempo il contesto originale dell’area di lavoro. Gli spazi condivisi possono fornire una struttura aggiuntiva per team o reparti specifici, rendendo più সহজ semplice organizzare e accedere ai contenuti.

**Consolidamento dei dati della chat**

Gli area di lavoro con più di 100 utenti possono avere decine di migliaia di chat di gruppo private e DM che non sono mai state archiviate o eliminate, anche dopo che gli utenti sono stati rimossi dall'azienda. Questo fa sì che i processi di migrazione privati richiedano molto più tempo rispetto ai processi pubblici.

Gli amministratore dovrebbero pulire i dati vecchi archiviando manualmente queste vecchie conversazioni oppure aggiornando il loro periodo di conservazione di Slack per eliminarle automaticamente.

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

{% hint style="success" %}
Sebbene sia possibile replicare più dati di 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 processi di migrazione in batch più piccoli da tre a sei mesi per migrazioni dei dati riuscite.
{% endhint %}

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

**Conservazione della cronologia chat**

Esistono diverse considerazioni relative alla conservazione quando si esegue 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 su dispositivo locale sia Archiviazione su cloud. [Archiviazione su dispositivo locale](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063423) può variare da uno (1) giorno a sette (7) anni. [Archiviazione su cloud](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0067567) può essere disattivata 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 Configura a livello di account e di gruppo per gli utenti.
* Gli amministratore possono impostare tempi di conservazione specifici per i singoli canali, secondo necessità.
* Gli amministratore possono specificare una policy di conservazione per i DM o le chat di gruppo e impostare un'altra policy per i canali della chat.
* Per la reportistica della cronologia chat, Zoom consiglia di archiviare le revisioni dei messaggi modificati e le eliminazioni.

Consulta l'articolo di Assistenza Zoom [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 amministratore hanno aggiunto l'app Slack Migration al proprio account Zoom.
* Gli amministratore che eseguono la migrazione devono avere autorizzazioni per entrambe le piattaforme (Slack e Zoom Chat) e la loro e-mail deve coincidere tra i loro account Zoom e Slack.
* Gli amministratore devono usare l'app Zoom Chat Migration per Configura i processi di migrazione da eseguire e per spostare i dati da Slack a Zoom Chat. Nota: questo processo richiede un minimo di 2 processi perché almeno 1 processo sposterà le conversazioni private e 1 processo sposterà i canali pubblici.
* Gli amministratore dovrebbero archiviare o eliminare tutti i dati Slack non necessari che non vogliono migrare in Chat per contribuire ad accelerare le migrazioni.
* Se utilizzi processi di migrazione API per migrare dati privati, assicurati che gli utenti sappiano quando e come autorizzeranno Slack a spostare i loro dati in Chat.
* Se prevedi di usare processi di migrazione Import, segui [le istruzioni di Slack per esportare i dati della chat del tuo area di lavoro come file .zip](https://slack.com/help/articles/201658943-Export-your-workspace-data).
  * Requisiti dei 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 di alto livello della migrazione:

1. Prima della migrazione, assicurati che gli utenti siano creati in Zoom e si siano autenticati almeno una volta.
2. Gli amministratore 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 i propri account Zoom e Slack.
4. Gli amministratore devono installare l'app privata in Slack per connettersi a Zoom ed eseguire l'autenticazione OAuth.
5. Gli amministratore usano l'app Zoom Chat Migration per Configura i processi di migrazione per spostare i dati da Slack a Zoom Chat. Ciò richiede un minimo di 2 processi: uno per le conversazioni private e uno per i canali pubblici.

Durante la migrazione, segui questi passaggi consigliati:

1. Migra i dati da 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 processi 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 processi con intervalli di tempo più ampi invece di più processi con intervalli di tempo più piccoli. Ogni processo contiene lo stesso numero di passaggi di migrazione.
4. (Facoltativo) Ripeti questi passaggi per le migrazioni dei processi privati.

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

* I nomi del canale pubblico/privato e del gruppo chat appariranno come: #nome-canale: nome-area di lavoro
* I messaggi inviati dagli utenti Slack con account Zoom Attiva saranno Mostra normalmente come se fossero stati inviati da quegli utenti Zoom
* I messaggi inviati dagli utenti Slack senza account Zoom Attiva verranno Mostra come inviati da un utente Zoom disattivato con il nome del mittente del messaggio Slack
* I messaggi di sistema verranno migrati (ad es., "@Some utente si è unito al canale")
* Tutti i messaggi verranno migrati come letti, indipendentemente dal loro stato in Slack
* Al termine verrà inviata una notifica di completamento della migrazione a ciascun canale pubblico e privato, visualizzata come "Messaggio inviato dall'app Chat Migration, Giorno Data Ora"

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

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

{% hint style="warning" %}
Rimuovere questa app dal tuo account Zoom eliminerà queste mappature, con conseguenti canali e chat duplicati se 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 a Zoom App Marketplace.
2. Cerca Chat Migration e fai clic su **Aggiungi**.
3. Esamina e approva le Autorizzazioni necessarie.

Consulta l'articolo di Assistenza Zoom [Utilizzando l'app Chat Migration (strumento di migrazione di Slack)](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 dell'area di lavoro o all'Organizzazione di Slack per installare e autorizzare l'applicazione privata, **Message Retriever**. Un admin deve approvare l'uso delle app, in generale, in un'area di lavoro di Slack e concedere inoltre le Autorizzazioni affinché tutti i membri possano usare l'app.
{% endhint %}

Gli amministratori devono concedere Autorizzazione per installare l'app Chat Migration nel proprio account Zoom insieme a due autorizzazioni di Gestione chat nel ruolo admin.

L'opzione per **Consentire solo app dallo Slack App Directory** l'impostazione deve essere **disattivata**.

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

#### <mark style="color:blu;">Collega la tua area di lavoro Slack per i lavori di migrazione API</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'area di lavoro:

1. Apri l'app di migrazione chat in Zoom.
2. Premi **Crea connessione > Accedi a Slack** e autorizza.
3. Conferma la connessione dell'area di lavoro nel Dashboard di Zoom.

#### <mark style="color:blu;">Esegui il task Sincronizza utente</mark> <a href="#qo97g1d6dweq" id="qo97g1d6dweq"></a>

Il task Sincronizza utente recupera tutti i membri completi e attivi nella tua area di lavoro Slack e crea una mappatura 1:1 al loro corrispondente account Zoom usando il loro indirizzo e-mail.

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

Se l'indirizzo e-mail di un utente Slack attivo viene trovato in un diverso account Zoom, ad esempio un account personale, allora l'utente verrà associato a un profilo "utente fittizio". Nel tuo account Zoom, questo utente si chiamerà **TeamChatMigration AppUser** e sarà presentare per garantire che tutti i dati dei messaggi vengano migrati per la tua area di lavoro.

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

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

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

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

Per creare un nuovo processo di migrazione:

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

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

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

Per creare un nuovo processo di migrazione:

1. Premi **Nuovo lavoro di migrazione** e seleziona l'area di lavoro di Slack.
2. Scegli **l'ambito dei dati**:
   * Canali pubblici (migrati automaticamente).
   * Canali privati e DM (richiede 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 dai tuoi utenti, Seleziona **Esegui** per avviare il lavoro di migrazione.

{% hint style="warning" %}
Gestione delle richieste di autorizzazione per i 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 lavoro di migrazione.
* Gli amministratori possono tenere traccia di 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 un successo ottimale della 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 lavori di migrazione</mark> <a href="#nbokwove1l8n" id="nbokwove1l8n"></a>

**Avvio di un nuovo lavoro di migrazione**

Per avviare un lavoro di migrazione esegui:

1. Premi **Esegui migrazione** per iniziare il processo.
2. I tempi di migrazione variano (le aree di lavoro grandi possono richiedere **12+ ore**).
3. Tieni traccia dell'avanzamento nel **Dashboard di migrazione**.

**Risoluzione dei problemi dei lavori di migrazione**

Occasionalmente, un lavoro 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 della migrazione" %}

| Problema                                            | Soluzione                                                                                      |
| --------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| <ul><li>Messaggi/canali privati mancanti</li></ul>  | <ul><li>Verifica se l'utente ha autorizzato la migrazione</li></ul>                            |
| <ul><li>Lavoro di migrazione bloccato</li></ul>     | L'app di migrazione riproverà automaticamente                                                  |
| <ul><li>Alcuni utenti non mappati in Zoom</li></ul> | Assicurati che esistano in Zoom con la stessa e-mail ed esegui nuovamente 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 di verificare che i contenuti di Slack siano stati trasferiti in chat come previsto.

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

| Passaggio                             | Azione                                                                                                                                                                                                                                                                                                               |
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Verifica della migrazione**         | <ul><li>Accedi a Zoom Chat e verifica che canali, messaggi e file vengano visualizzati correttamente.</li><li>Disconnetti e accedi di nuovo per aggiornare la cronologia chat.</li></ul>                                                                                                                             |
| **Risolvi eventuali dati mancanti**   | <ul><li>Reinvio delle richieste di autorizzazione agli utenti che non hanno approvato l'accesso ai dati privati.</li><li>Esamina i job di migrazione per individuare eventuali errori e riprova i job non riusciti.</li></ul>                                                                                        |
| **(Facoltativo) Disattiva Slack**     | <ul><li>Dopo aver confermato che la migrazione dei dati è completa, puoi archiviare o rimuovere l'area di lavoro Slack.</li></ul>                                                                                                                                                                                    |
| **Risoluzione generale dei problemi** | <ul><li>Se mancano dei messaggi, prova a disconnetterti e ad accedere di nuovo a 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 non riesce, 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 problemi aggiuntivi 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 **ID di tracciamento 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à chat per il 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 "Consentire agli utenti di creare canali pubblici + privati" sia abilitato a tutti i livelli</li></ul>                                                                                                                                                                                        |
| **Problemi dell'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 (riuscito/non riuscito)</li><li>Determina se il job ha coinvolto canali pubblici o canali privati/conversazioni</li></ul>                                                                                                                                                                                                                                                                                                                                                                         |
| **Se la migrazione è riuscita, 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 inizio/fine della migrazione partono alle 12:00 GMT (PST +7))</li><li>Verifica la corretta creazione del canale</li><li>Assicurati che l'utente abbia effettuato la disconnessione e l'accesso di nuovo al client dopo la migrazione</li><li>Conferma la corretta creazione degli utenti migrati in Zoom</li><li>Verifica la visibilità di messaggi/conversazioni nel portale amministratori della cronologia chat</li></ul> |
| **Se la migrazione non è riuscita**                                          | <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.
