> 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/it/zoom-workplace/zoom-chat/zoom-team-chat-migration-app-field-guide.md).

# Guida pratica all'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 le aree di lavoro Slack a Zoom chat. Copre i processi essenziali per eseguire la migrazione dei canali pubblici, dei canali privati e dei messaggi diretti, mantenendo l'integrità dei dati e la cronologia delle comunicazioni degli utenti.

Il [Zoom Chat Migration App](https://marketplace.zoom.us/apps/5ZXfqVPZSfqBYeCR9VLsBg) implementa un'architettura a doppio motore per trasferire i dati dell'area di lavoro Slack negli ambienti di 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 tuoi dati Slack utilizzando la Zoom Chat Migration App, a seconda delle dimensioni della tua organizzazione, del piano Slack e dei requisiti di sicurezza.

Inoltre, devi soddisfare determinati 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 in dettaglio gli approcci di migrazione più comuni:

| Metodo di migrazione                            | Descrizione                                                                                                                              | Ideale per                                                                                                      | Requisiti                                                                                                 | Vantaggio                                                                                                                                           |
| ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Migrazione API (basata sull'app)**            | Usa un'app di migrazione per connettersi direttamente alle API Slack e trasferire i dati. Supporta canali pubblici, canali privati e DM. | Organizzazioni più piccole o situazioni in cui ottenere l'autorizzazione dell'utente è fattibile                | 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 Import Tool (basata su file)** | Usa i file di esportazione 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 Slack dalla dashboard admin di Slack                                    | Non è necessaria l'autorizzazione dell'utente; ideale per la migrazione in blocco, soprattutto delle chat private                                   |
| **Approccio ibrido (API + Import)**             | Combina i metodi API e Import: canali pubblici tramite API; canali privati e DM tramite Import Tool                                      | Organizzazioni di medie o grandi dimensioni che vogliono evitare la complessità dell'autorizzazione dell'utente | Accesso admin sia per l'esportazione Slack sia per la configurazione della migrazione API basata sull'app | Evita l'attrito dell'autorizzazione dell'utente per le chat private, mantenendo al tempo stesso 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**: deve essere in esecuzione un solo job alla volta

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

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

#### <mark style="color:blu;">Prerequisiti di account e Autorizzazione</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 dei ruoli sul portale web. Deve assicurarsi che gli siano assegnate le corrette Autorizzazioni di gestione della chat: la **Modifica** casella di controllo deve essere selezionata per i Ruoli **Canali chat** e **Messaggi chat** . In caso contrario, non sarà in grado di 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 Slack relativi a utente, canale e messaggi. Questi tipi di dati hanno limiti di frequenza, consentendo solo un certo numero di richieste al minuto per un'area di lavoro Slack. Questo è un aspetto importante da considerare quando pianifichi la tempistica della migrazione.

**Parametri di riferimento 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 incidono sia sui metodi di migrazione tramite 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 processi di migrazione basati su API affrontano ulteriori restrizioni di prestazione a causa dei 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 la produttività 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 di elaborazione completi indicati sopra nei parametri di riferimento. Tuttavia, la maggior parte dei canali dell'area di lavoro in genere contiene un'attività minima, costituita da brevi conversazioni, annunci o discussioni archiviate che vengono migrate significativamente più velocemente rispetto alle stime di riferimento.

**Autorizzazioni admin e ambiti richiesti**

Zoom App Marketplace richiede le seguenti Autorizzazioni admin e i seguenti ambiti all'interno del tenant Zoom:

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

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

* `chat_messaggio:scrittura:admin`
* `imchat:bot`
* `chat_canale:scrittura:admin`
* `utente:scrittura:admin`

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

L'app di Slack creata da Zoom verrà installata automaticamente nel tenant di Slack quando un admin si connette a un'area di lavoro tramite lo strumento di migrazione. L'app di Slack usa[ 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 inoltre impostare l'opzione per **Consenti solo app dalla directory di Slack** a **DISATTIVATO**, il che consente all'app Slack di installarsi una volta creata la connessione con l'area di lavoro. Sono inoltre richiesti 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>

Considerare 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 Slack Workspace 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 un intervallo di tempo per la migrazione (fino a un massimo di un anno per lavoro)
5. Comunica con gli utenti in merito alle approvazioni dei messaggi privati

**Consolidamento delle aree di lavoro di Slack**

Per le organizzazioni che utilizzano più aree di lavoro di 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 che a quelli delle chat. Ad esempio:

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

Questa consolidazione garantisce che tutti i dati vengano migrati a un singolo account Zoom Chat, preservando il contesto originale dell'area di lavoro. Gli spazi condivisi possono fornire una struttura aggiuntiva per team o reparti specifici, rendendo più facile organizzare e accedere ai contenuti.

**Consolidamento dei dati della chat**

Le aree 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 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 come dati attivi in Zoom Chat e quali dati possono essere archiviati per eventuali futuri scopi legali, di conformità, di mitigazione del rischio, di risorse umane o altri scopi.

{% hint style="success" %}
Sebbene sia possibile replicare più dati di Slack in Zoom Chat, Zoom consiglia **solo replicando un (1) anno di dati attivi e archiviando il resto**. La maggior parte degli utenti raramente ha bisogno di cercare oltre un singolo 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 eseguire con successo le migrazioni dei dati.
{% endhint %}

Inoltre, è importante considerare se i dati si trovano 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 relative alla conservazione quando si migra 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 Archiviazione 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.
* [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 a livello di gruppo per gli utenti.
* Gli amministratori possono impostare tempi di conservazione specifici per singoli canali, secondo necessità.
* Gli amministratori 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.

Vedi 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 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 usare l'app Zoom Chat Migration per configurare i job di migrazione da eseguire e spostare i dati da Slack a Zoom Chat. Nota: questo processo richiede un minimo di 2 job perché almeno 1 job sposterà le conversazioni private e 1 job sposterà i canali pubblici.
* Gli amministratori dovrebbero archiviare o eliminare tutti i dati Slack non necessari che non desiderano migrare in Chat per aiutare a velocizzare le migrazioni.
* Se stai usando job di migrazione API per migrare dati privati, assicurati che gli utenti siano consapevoli di quando e come autorizzeranno Slack a spostare i loro dati in Chat.
* Se prevedi di usare job di migrazione Import, segui [le istruzioni di Slack per esportare i dati della chat della tua area di lavoro 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 i 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 i propri 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 usano 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 da un canale selezionando il tipo di conversazione Seleziona Canali Pubblici e scegliendo un canale specifico. Seleziona i dati di una settimana da alcuni dei tuoi canali più vecchi.
2. Crea job per trasferire tutti i canali pubblici di oltre 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-area-di-lavoro
* I messaggi inviati dagli utenti Slack con account Zoom attivi verranno mostrati normalmente come se fossero stati inviati da quegli utenti Zoom
* I messaggi inviati dagli utenti Slack senza account Zoom attivi verranno mostrati come inviati da un utente Zoom disattivato con il nome del mittente del messaggio Slack
* I messaggi di sistema verranno migrati (ad es., "@Un certo utente è entrato nel canale")
* Tutti i messaggi verranno migrati come letti, indipendentemente dal loro stato in Slack
* Al completamento verrà inviato un avviso di completamento della migrazione a ciascun canale pubblico e chat privata, visualizzato come "Il messaggio viene inviato da Chat Migration App, Giorno Data Ora"

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

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

{% hint style="warning" %}
La rimozione di questa app dal tuo account Zoom eliminerà queste mappature, causando canali e chat duplicati se reinstalli ed esegui di nuovo la migrazione. Elimina la 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 la app:

1. Accedi a Zoom App Marketplace.
2. Cerca Chat Migration e fai clic su **Aggiungi**.
3. Esamina e approva le Autorizzazioni necessarie.

Vedi l'articolo di Assistenza Zoom [Utilizzo della app Chat Migration (strumento di migrazione 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 o alla Organizzazione dell'area di lavoro 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 Slack e anche concedere le Autorizzazioni a tutti i membri per utilizzare la app.
{% endhint %}

Gli amministratori devono concedere l'Autorizzazione per installare la app Chat Migration nel loro account Zoom insieme a due Autorizzazioni di Gestione chat nel Ruolo di admin.

L'opzione per **Consentire solo app dalla Slack App Directory** Impostazioni deve essere **disabilitata**.

{% hint style="info" %}
L'amministratore che utilizza la app deve avere un [Ruolo di admin 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 admin 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 Assistenza Zoom.
{% endhint %}

#### <mark style="color:blu;">Collega la tua area di lavoro Slack per i processi di migrazione API</mark> <a href="#xjbm4ds0xh3" id="xjbm4ds0xh3"></a>

Se non utilizzi il metodo Importazione file, queste istruzioni ti aiuteranno a collegarti per le migrazioni API.

Per collegare un'area di lavoro:

1. Apri la app Chat Migration in Zoom.
2. Fai clic su **Crea connessione > Accedi a Slack** e autorizza.
3. Conferma la connessione dell'area di lavoro nel dashboard di Zoom.

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

L'attività Sincronizza utente recupera tutti i membri completi e attivi nella tua area di lavoro Slack e crea una mappatura 1:1 al corrispondente account Zoom utilizzando 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 account Zoom diverso, come un account personale, allora l'utente verrà associato a un profilo "utente fittizio". Nel tuo account Zoom, questo utente sarà denominato **TeamChatMigration AppUser** e sarà presente per garantire che tutti i dati dei messaggi vengano migrati per la tua area di lavoro.

{% hint style="warning" %}
Non eliminare l' **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. Fai clic su **Carica file**, seleziona il tuo file di esportazione 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ò bloccherà il caricamento del file e il processo rimarrà nello stato "Caricamento in corso". Se ciò accade, puoi eliminare il processo "Caricamento in corso" e riavviare questo processo
3. Una volta completato il caricamento iniziale del file, una **finestra Dettagli migrazione** apparirà mentre la app Migration prepara il file per la migrazione. A questo punto, puoi chiudere, uscire o aggiornare la pagina mentre attendi che il processo sia pronto per essere eseguito.
4. Dopo che lo strumento avrà terminato la preparazione del file per la migrazione, potrai selezionare i tipi di conversazione da migrare.
5. Dopo aver selezionato i tipi di conversazione, fai clic su **Esegui** per avviare il processo di migrazione.

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

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

Per creare un nuovo processo di migrazione:

1. Fai clic su **Nuovo processo di migrazione** e seleziona l'area di lavoro Slack.
2. Scegli **ambito dei dati**:
   * Canali pubblici (migra automaticamente).
   * Canali privati e messaggi diretti (richiede l'autorizzazione dell'utente).
   * Intervallo di date specifico per i messaggi.
3. Dopo aver selezionato l'ambito e l'intervallo dei dati e aver ottenuto l'autorizzazione dai tuoi utenti, seleziona **Esegui** per avviare il processo di migrazione.

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

* **I canali privati e i messaggi diretti richiedono l'approvazione dell'utente** prima della migrazione.
* Zoom invierà automaticamente richieste di approvazione via e-mail una volta creato il processo di migrazione.
* Gli admin possono monitorare quali utenti hanno/non hanno approvato. Per la migrazione della chat privata, è richiesta 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 processi di migrazione</mark> <a href="#nbokwove1l8n" id="nbokwove1l8n"></a>

**Avvio di un nuovo processo di migrazione**

Per avviare l'esecuzione di un processo di migrazione:

1. Fai clic su **Esegui migrazione** per iniziare il processo.
2. I tempi di migrazione variano (le aree di lavoro di grandi dimensioni possono richiedere **oltre 12 ore**).
3. Monitora l'avanzamento nel **Dashboard di migrazione**.

**Risoluzione dei problemi dei processi di migrazione**

Occasionalmente, un processo di migrazione potrebbe non restituire il risultato desiderato. La tabella seguente 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>Verifica se l'utente ha autorizzato la migrazione</li></ul>                                      |
| <ul><li>Processo di migrazione bloccato</li></ul>        | La app di migrazione riproverà automaticamente                                                           |
| <ul><li>Alcuni utenti non sono mappati in Zoom</li></ul> | Assicurati che esistano in Zoom con lo stesso indirizzo e-mail ed esegui nuovamente eventuali migrazioni |
| {% endtab %}                                             |                                                                                                          |
| {% endtabs %}                                            |                                                                                                          |

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

### Analisi post-migrazione <a href="#imyt8hpau63q" id="imyt8hpau63q"></a>

Dopo aver completato una migrazione, Zoom consiglia di eseguire un'analisi post-migrazione approfondita e di verificare che i contenuti di Slack siano stati trasferiti nella chat come previsto.

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

| Passaggio                             | Azione                                                                                                                                                                                                                                                                                                                  |
| ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Verifica la 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 della 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>Controlla i processi di migrazione per eventuali errori e riprova quelli 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 messaggi, prova a Disconnetti e ad Accedi di nuovo a Zoom.</li><li>Se gli utenti non possono essere trovati, verifica che gli indirizzi e-mail corrispondano tra Slack e Zoom.</li><li>Se la migrazione non riesce, controlla i registri 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 l' **ID di tracciamento Zoom dalla chiamata web** e recuperare entrambi gli **ID account** e **ID utente**.
{% endhint %}

| Categoria                                                                         | Descrizione del problema                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Impostazioni dell'account Zoom**                                                | <ul><li>Conferma che la funzionalità di 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 "Consenti agli utenti di creare canali pubblici + privati" sia abilitato a tutti i livelli</li></ul>                                                                                                                                                                                                     |
| **Problemi degli utenti 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 gli indirizzi e-mail corrispondenti per gli utenti in corso di migrazione sia in Zoom sia in Slack</li></ul>                                                                                                                                                                                                                                                                                     |
| **Problemi del processo di migrazione**                                           | <ul><li>Controlla lo stato di completamento del processo (riuscito/non riuscito)</li><li>Determina se il processo ha coinvolto canali pubblici o canali/conversazioni privati</li></ul>                                                                                                                                                                                                                                                                                                                                                                             |
| **Se la migrazione è riuscita, ma i messaggi/le conversazioni non sono visibili** | <ul><li>Conferma che l'intervallo di tempo GMT acquisisca correttamente l'intervallo dei messaggi Slack previsto (le date di migrazione iniziano/terminano alle 00:00 GMT (PST +7))</li><li>Verifica la corretta creazione del canale</li><li>Assicurati che l'utente abbia effettuato la disconnessione e abbia eseguito nuovamente l'accesso 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 intraprese dall'utente dopo il fallimento (nuovo tentativo del processo, creazione di un nuovo processo, ecc.)</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/it/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.
