> 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 per la migrazione dell'app 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, fornendo istruzioni passo passo per trasferire le aree di lavoro di Slack su 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 di 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 utilizzando 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 di 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 nel dettaglio gli approcci 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 canali pubblici, canali privati e DM. | Organizzazioni più piccole o casi in cui è fattibile 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 dalla Dashboard 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 medio-grandi che vogliono evitare la complessità dell'autorizzazione degli utenti | Accesso admin 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 al contempo 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 enterprise, 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 dei dettagli di 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 in thread come Slack, ma mantiene l'ordine delle risposte |
| @ Menzioni                   | @ Menzioni                  | Stesso comportamento                                                        |
| Reazioni                     | Reazioni Emoji              | Stesso comportamento                                                        |
| File                         | File condivisi              | Richiede che l'Archiviazione su cloud sia abilitata                         |
| Messaggi ancorati            | Messaggi con stella         | I messaggi ancorati diventano con 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 Autorizzazione</mark> <a href="#pppv0j3jhmh6" id="pppv0j3jhmh6"></a>

È necessario controllare sia i livelli del tuo account Slack e Zoom sia le Autorizzazione dell'admin prima di procedere.

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

{% hint style="info" %}
L'admin che installa l'app Zoom Marketplace deve accedere a Gestione ruoli nel portale web. Deve assicurarsi che gli siano assegnate le corrette Autorizzazione di gestione chat - la **Modifica** casella di controllo deve essere selezionata per **Canali chat** e **Messaggi in chat** ruoli. In caso contrario, non potranno autorizzare l'app Zoom Slack Migration a causa di Autorizzazione insufficiente.
{% endhint %}

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

**API di Slack: scope, Autorizzazione e limiti di frequenza**

Le API di Slack vengono utilizzate per recuperare i dati di utente, canale e messaggi di Slack. 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 si pianifica la tempistica della migrazione.

**Benchmark delle prestazioni dei job 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 job di migrazione incontrano due colli di bottiglia fondamentali che influiscono direttamente sulle tempistiche di implementazione e sulla pianificazione delle risorse. Le limitazioni di elaborazione del trasferimento file incidono sia sui metodi di migrazione tramite importazione sia su quelli basati su API, creando vincoli di prestazioni che richiedono un'adeguata assegnazione 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 prestazioni a causa dei meccanismi nativi di limitazione della frequenza delle API di Slack. Questi vincoli non influenzano le migrazioni tramite importazione, ma incidono in modo significativo sulle implementazioni basate su API, richiedendo finestre di elaborazione più ampie e un'attenta pianificazione dei job per ottimizzare il throughput mantenendo la conformità alle limitazioni della piattaforma.

Anche se la tua area di lavoro Slack può 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 ampi storici di messaggi, allegati file e interazioni degli utenti, richiederanno tutti i tempi di elaborazione di riferimento indicati sopra. 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 molto più rapidamente rispetto alle stime di riferimento.

**Autorizzazione e scope admin richiesti**

Zoom App Marketplace richiede le seguenti Autorizzazione admin e scope all'interno del tenant Zoom:

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

Lo strumento di migrazione di Zoom utilizza API interne che richiedono i seguenti scope 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 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 a 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).

È inoltre necessario impostare l'opzione per **Consentire solo le app dalla directory Slack** a **DISATTIVATO**, il che consente all'app Slack di installarsi una volta creata la connessione all'area di lavoro. 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.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 workspace di 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 dei bot e/o delle 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 job)
5. Comunica agli utenti le approvazioni dei messaggi privati

**Consolidamento dell'area di lavoro Slack**

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

Per distinguere tra le aree di lavoro, Zoom aggiunge il nome originale dell'area di lavoro sia al canale sia alla chat. Ad esempio:

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

Questa consolidazione garantisce che tutti i dati vengano migrati in un unico 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 a quelli pubblici.

Gli amministratori dovrebbero ripulire i vecchi dati 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 future finalità legali, di conformità, di mitigazione del rischio, delle risorse umane o altri scopi.

{% hint style="success" %}
Sebbene sia possibile replicare più dati di Slack in Zoom chat, Zoom consiglia **replicando solo un (1) anno di dati Attiva 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 processi di migrazione in lotti 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 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 l'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 disattivata o configurata per un periodo di conservazione di 7 anni.
* [Politiche 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, secondo necessità.
* Gli amministratori possono specificare una politica di conservazione per i DM o i chat di gruppo e impostare un'altra politica per i canali chat.
* Per la reportistica della cronologia delle 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 delle 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 queste raccomandazioni per un processo di pre-migrazione più semplice:

* Assicurati che gli utenti abbiano creato un account Zoom e si siano autenticati almeno una volta.
* Gli amministratori hanno aggiunto l'app Slack Migration al loro account Zoom.
* Gli amministratori che eseguono la migrazione devono avere le autorizzazioni per entrambe le piattaforme (Slack e Zoom Chat), e il loro e-mail deve corrispondere tra i loro account Zoom e Slack.
* Gli amministratori devono usare l'app Zoom Chat Migration per Configura 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 vogliono migrare in chat per aiutare ad accelerare le migrazioni.
* Se utilizzi job di migrazione API per la migrazione di 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 Import Migration, segui [le istruzioni di Slack per esportare i dati chat della tua 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 suo 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 abbiano effettuato l'autenticazione almeno una volta.
2. Gli amministratori dovrebbero preparare e Aggiungi l'app Slack Migration al loro 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 suoi 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 Configura 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 attività 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 attività con intervalli di tempo più ampi invece di più attività con intervalli di tempo più ridotti. Ogni attività contiene lo stesso numero di passaggi da migrare.
4. (Facoltativo) Ripeti questi passaggi per le migrazioni private delle attività.

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 Attiva verranno 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 saranno migrati (ad es. "@Qualche utente si è unito al canale")
* Tutti i messaggi saranno migrati come letti, indipendentemente dal loro stato in Slack
* Un avviso di completamento della migrazione verrà inviato a ogni canale pubblico e privato al termine, apparendo come "Il messaggio viene inviato da Chat Migration App, 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 corrispondenze 1:1 tra le conversazioni di Slack e Zoom dopo la migrazione.

{% hint style="warning" %}
Rimuovere questa app dal tuo account Zoom eliminerà queste corrispondenze, 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 a Zoom App Marketplace.
2. Cerca Chat Migration e fai clic su **Aggiungi**.
3. Rivedi e approva i permessi necessari.

Vedi l'articolo di Assistenza Zoom [Utilizzo dell'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 dell'area di lavoro Slack o all'Organizzazione per installare e autorizzare l'applicazione privata, **Message Retriever**. Un admin deve approvare in generale l'uso delle app in un'area di lavoro Slack e concedere inoltre le autorizzazioni a tutti i membri per utilizzare l'app.
{% endhint %}

Gli amministratori devono concedere l'Autorizzazione per installare l'app Chat Migration nel loro account Zoom insieme a due autorizzazioni di gestione chat nel ruolo di amministratore.

L'opzione per **Consenti solo app da Slack App Directory** l'impostazione deve essere **disabilitata**.

{% hint style="info" %}
L'amministratore che utilizza l'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 possono essere un tipo di admin personalizzato. Scopri di più su [l'identificazione di tipi di account, ruoli e 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) sul sito di Assistenza Zoom.
{% endhint %}

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

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

Per connettere un'area di lavoro:

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

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

Il task Sincronizza utenti recupera tutti i membri completi e attivi della tua area di lavoro Slack e crea una corrispondenza 1:1 con il 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 in Zoom un nuovo utente disattivato 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à quindi associato 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 la tua area di lavoro.

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

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

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

#### <mark style="color:blu;">Creazione di un job di migrazione di 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 Slack Export, 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 job resterà 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 dei dettagli della 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 aspetti che il job sia pronto per essere eseguito.
4. Dopo che lo strumento avrà finito di preparare il 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 l'area di lavoro 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 selezionati l'ambito dei dati e l'intervallo e ottenuta l'autorizzazione dai tuoi utenti, seleziona **Esegui** per avviare il job di migrazione.

{% hint style="warning" %}
Gestione delle richieste di autorizzazione dei 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 tenere traccia di quali utenti hanno/non hanno approvato. Per la migrazione della chat privata, è necessaria l'autorizzazione di un solo utente per migrare l'intera cronologia delle conversazioni.
* 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, mira 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 un job di migrazione, esegui:

1. Fai clic su **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 nella **Dashboard di migrazione**.

**Risoluzione dei problemi dei job di migrazione**

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

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

| Problema                                            | Soluzione                                                                               |
| --------------------------------------------------- | --------------------------------------------------------------------------------------- |
| <ul><li>Mancano messaggi/canali privati</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 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 le 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 verificare che i contenuti di Slack siano stati trasferiti in Chat come previsto.

La tabella seguente fornisce le 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 nuovamente per aggiornare la cronologia della chat.</li></ul>                                                                                                                          |
| **Risolvi 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 individuare errori e riprova eventuali 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 di Slack.</li></ul>                                                                                                                                                                                      |
| **Risoluzione generale dei problemi** | <ul><li>Se mancano messaggi, prova a disconnetterti e a eseguire di nuovo l'accesso 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 ulteriori problemi dopo la migrazione, questa checklist può fornire ulteriori passaggi e azioni da eseguire per 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 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 "Consentire 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 che gli indirizzi e-mail corrispondano per gli utenti in fase di migrazione 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/conversazioni privati</li></ul>                                                                                                                                                                                                                                                                                                                                                                                       |
| **Se la migrazione è riuscita, ma messaggi/conversazioni non sono visibili** | <ul><li>Conferma che l'intervallo di tempo GMT acquisisca correttamente l'intervallo di messaggi Slack previsto (le date di inizio/fine della migrazione iniziano 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 abbia eseguito 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à di messaggio/conversazione nel portale amministratori 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 (nuovo tentativo del job, creazione di un nuovo job, 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.
