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

# Zoom Chat-Migrations-App-Leitfaden

### Einführung <a href="#ix9eykivgqnt" id="ix9eykivgqnt"></a>

Der Leitfaden zur Zoom Chat Migration App ist eine umfassende Ressource für IT-Administratoren und bietet Schritt-für-Schritt-Anweisungen für die Übertragung von Slack-Arbeitsplätzen zu Zoom Chat. Er deckt wesentliche Prozesse für die Migration öffentlicher Kanäle, privater Kanäle und Direktnachrichten ab und sorgt dabei für Datenintegrität und den Kommunikationsverlauf der Benutzer.

Die [Zoom Chat Migration App](https://marketplace.zoom.us/apps/5ZXfqVPZSfqBYeCR9VLsBg) implementiert eine Dual-Engine-Architektur für die Übertragung von Slack-Arbeitsplatzdaten in Zoom Chat-Umgebungen. Systemadministratoren haben Zugriff auf mehrere Migrationspfade.

### Migrationsübersicht <a href="#jemq5k6izt7b" id="jemq5k6izt7b"></a>

Es gibt mehrere Möglichkeiten, Ihre Slack-Daten mit der Zoom Chat Migration App zu migrieren, abhängig von der Größe Ihres Unternehmens, dem Slack-Tarif und den Sicherheitsanforderungen.

Außerdem müssen Sie bestimmte Slack- und Zoom-Voraussetzungen erfüllen, einen Migrationsplan erstellen und Ihre Slack-Arbeitsplätze konsolidieren. Dieser Abschnitt bietet einen Überblick über diese Voraussetzungen und Überlegungen.

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

#### <mark style="color:blau;">Migrationsoptionen</mark> <a href="#h29eaaqgvd9c" id="h29eaaqgvd9c"></a>

Die folgende Tabelle beschreibt die gängigsten Migrationsansätze:

| Migrationsmethode                        | Beschreibung                                                                                                                                                             | Am besten geeignet für                                                                             | Anforderungen                                                                                        | Vorteil                                                                                                                                                |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **API-Migration (App-basiert)**          | Verwendet eine Migrations-App, um direkt eine Verbindung zu den Slack-APIs herzustellen und Daten zu übertragen. Unterstützt öffentliche Kanäle, private Kanäle und DMs. | Kleinere Unternehmen oder Fälle, in denen das Einholen der Benutzerautorisierung möglich ist       | Benutzer müssen den Zugriff auf ihre Daten für private Chats und DMs autorisieren                    | Vollständig automatisierte und nahtlose Übertragung von Daten direkt aus Slack                                                                         |
| **Import-Tool-Migration (dateibasiert)** | Verwendet Slack-Exportdateien, um Daten über Zooms Import-Tool zu migrieren                                                                                              | Unternehmen mit Slack-Plus- oder Enterprise Grid-Tarifen                                           | Administratoren müssen Slack-Daten aus dem Slack-Administrator-Dashboard exportieren                 | Keine Benutzerautorisierung erforderlich; ideal für die Massenmigration, insbesondere privater Chats                                                   |
| **Hybrider Ansatz (API + Import)**       | Kombiniert API- und Import-Methoden: öffentliche Kanäle über API; private Kanäle und DMs über das Import-Tool                                                            | Mittelgroße bis große Unternehmen, die die Komplexität der Benutzerautorisierung vermeiden möchten | Administratorzugriff für sowohl den Slack-Export als auch die app-basierte API-Migrationseinrichtung | Vermeidet Reibungen bei der Benutzerautorisierung für private Chats, während die Automatisierung für die Migration öffentlicher Kanäle erhalten bleibt |

**Systembeschränkungen**

Der Migrationsprozess unterliegt bestimmten Beschränkungen:

* **Maximale Kapazität pro Einzelauftrag**: 12 Monate historische Daten
* **Gesamtes Migrationsfenster**: 60 Monate (5 Jahre)
* **Job-Parallelität**: Es darf jeweils nur ein Job ausgeführt werden

Diese technische Architektur ermöglicht die systematische Migration von Unternehmenskommunikationsdaten bei gleichzeitiger Einhaltung der Sicherheitsprotokolle und Datenintegrität.

#### <mark style="color:blau;">Slack-zu-Zoom-Datenzuordnung</mark> <a href="#z9gs91q4zgvi" id="z9gs91q4zgvi"></a>

Die folgende Tabelle mit Zuordnungsdetails kann Ihnen helfen, die Verbindung zwischen Slack und Zoom Chat vor der Migration zu verstehen:

| Slack-Funktion                  | Entsprechung in Zoom Chat       | Notizen                                                                                 |
| ------------------------------- | ------------------------------- | --------------------------------------------------------------------------------------- |
| Öffentliche Kanäle              | Öffentliche Kanäle              | Wird automatisch migriert                                                               |
| Private Kanäle                  | Private Kanäle                  | Erfordert die Zustimmung des Benutzers                                                  |
| Direktnachrichten (DMs)         | 1:1-Chats                       | Erfordert die Zustimmung des Benutzers                                                  |
| Gruppen-DMs                     | Gruppen-Chats                   | Erfordert die Zustimmung des Benutzers                                                  |
| Threads                         | Inline-Antworten                | Nicht vollständig als Threads wie in Slack, aber die Antwortreihenfolge bleibt erhalten |
| @-Erwähnungen                   | @-Erwähnungen                   | Gleiches Verhalten                                                                      |
| Reaktionen                      | Emoji-Reaktionen                | Gleiches Verhalten                                                                      |
| Dateien                         | Geteilte Dateien                | Erfordert aktivierten Cloud-Speicher                                                    |
| Angeheftete Nachrichten         | Mit Stern markierte Nachrichten | Angeheftete Nachrichten werden mit Stern markiert                                       |
| Nachrichten von Slack-Bots/Apps | Nur Text (keine Karten)         | Rich-App-Karten werden nicht migriert                                                   |

#### <mark style="color:blau;">Konto- und Berechtigungsvoraussetzungen</mark> <a href="#pppv0j3jhmh6" id="pppv0j3jhmh6"></a>

Sie müssen vor dem Fortfahren sowohl Ihre Slack- als auch Ihre Zoom-Kontoebenen und Administratorberechtigungen überprüfen.

* A **Pro, Business, Enterprise oder Bildung** Ein Zoom-Konto ist erforderlich.
* Slack und Zoom **Administratorberechtigungen** werden benötigt, um die Migration zu autorisieren.

{% hint style="info" %}
Der Administrator, der die Zoom Marketplace-App installiert, muss im Webportal auf die Rollenverwaltung zugreifen. Er muss sicherstellen, dass ihm die richtigen Chat-Verwaltungsberechtigungen zugewiesen sind – die **Bearbeiten** das Kontrollkästchen muss für **Chat-Kanäle** und **Chat-Nachrichten** Rollen. Andernfalls können sie die Zoom Slack Migration App aufgrund unzureichender Berechtigungen nicht autorisieren.
{% endhint %}

* Cloud-Speicher muss aktiviert sein für **Aufbewahrung von Nachrichten/Dateien**.

**Slack-APIs: Scopes, Berechtigungen und Rate Limits**

Slack-APIs werden verwendet, um Ihre Slack-Benutzer-, Kanal- und Nachrichtendaten abzurufen. Diese Datentypen haben Rate-Limits, sodass für einen Slack-Arbeitsplatz nur eine bestimmte Anzahl von Anfragen pro Minute zulässig ist. Dies ist ein wichtiger Aspekt bei der Planung Ihres Migrationszeitplans.

**Leistungsbenchmarks für Slack-Migrationsjobs**

Die folgenden Tabellen enthalten Schätzungen für Slack-Migrationen.

{% tabs %}
{% tab title="Leistungsvergleichsanalyse nach Migrationsimplementierungsmethode" %}

| Migrationsmethode      | Datenbereich | Verarbeitungszeit pro Kanal | Geschätzte Migrationszeit\*                  |
| ---------------------- | ------------ | --------------------------- | -------------------------------------------- |
| Import-Migration       | ca. 2 Wochen | 5–10 Sekunden               | 45 Sekunden – 1 Minute 15 Sekunden pro Kanal |
| API-basierte Migration | ca. 2 Wochen | 20–30 Sekunden              | 3–5 Minuten pro Kanal                        |

<sub>*\*Basierend auf einem mittelgroßen Slack-Arbeitsplatz mit einjährigem historischen Daten*</sub>
{% endtab %}
{% endtabs %}

Migrationsjobs stoßen auf zwei grundlegende Engpässe, die sich direkt auf Implementierungszeitpläne und die Ressourcenplanung auswirken. Einschränkungen bei der Verarbeitung der Dateiübertragung beeinträchtigen sowohl Import- als auch API-basierte Migrationsmethoden und führen zu Leistungsgrenzen, die während der Bereitstellungsplanung eine ausreichende Bandbreitenzuweisung und Strategien zur Übertragungsoptimierung erfordern. API-basierte Migrationsjobs unterliegen zusätzlichen Leistungsbeschränkungen aufgrund der nativen API-Rate-Limiting-Mechanismen von Slack. Diese Einschränkungen betreffen Import-Migrationen nicht, wirken sich jedoch erheblich auf API-basierte Implementierungen aus und erfordern längere Verarbeitungsfenster sowie eine sorgfältige Job-Planung, um den Durchsatz zu optimieren und gleichzeitig die Einhaltung der Plattformbeschränkungen sicherzustellen.

Auch wenn Ihr Slack-Arbeitsplatz Hunderte oder Tausende von Kanälen enthalten kann, folgt die Verteilung der Kanalaktivität vorhersehbaren Mustern, die sich direkt auf die Migrationsleistung und die Anforderungen an die Ressourcenverteilung auswirken. Kanäle mit hoher Aktivität und umfangreichen Nachrichtenverläufen, Dateianhängen und Benutzerinteraktionen benötigen die oben aufgeführten vollständigen Benchmark-Verarbeitungszeiten. Die meisten Arbeitsplatz-Kanäle enthalten jedoch typischerweise nur minimale Aktivität – bestehend aus kurzen Gesprächen, Ankündigungen oder archivierten Diskussionen, die deutlich schneller migriert werden als die Benchmark-Schätzungen.

**Erforderliche Administratorberechtigungen und Scopes**

Der Zoom App Marketplace erfordert innerhalb des Zoom-Tenants die folgenden Administratorberechtigungen und Scopes:

* **Chat-Verwaltung > Chat-Kanäle = Bearbeiten**
* **Chat-Nachrichten = Bearbeiten**

Das Zoom-Migrationstool verwendet interne APIs, die die folgenden Zoom-App-Scopes erfordern:

* `Chat_message:write:Administrator`
* `imchat:bot`
* `Chat_Kanal:write:Administrator`
* `Benutzer:write:Administrator`

Zoom XMPP enthält ein Feld mit der Slack-Nachrichten-ID zur Überprüfung der Authentizität und zur historischen Nachverfolgung.

Die von Zoom entwickelte Slack App wird automatisch im Slack-Mandanten installiert, wenn ein Administrator über das Migrationstool eine Verbindung zu einem Arbeitsplatz herstellt. Die Slack App verwendet[ OAuth2-Authentifizierung](https://api.slack.com/authentication/oauth-v2) um eine Verbindung mit Zoom herzustellen und das Autorisierungs-Token für die Datenmigration bereitzustellen. Benutzer müssen die Migration privater Unterhaltungen (Direktnachrichten (DMs), Gruppen-Chats und privater Kanäle) autorisieren.

Sie müssen außerdem die Option für **Nur Apps aus dem Slack-Verzeichnis zulassen** zu **AUS**, wodurch die Slack App installiert werden kann, sobald die Verbindung zum Arbeitsplatz hergestellt wurde. Die folgenden Slack-Berechtigungsbereiche sind ebenfalls erforderlich:

* `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:blau;">Überlegungen zur Migration</mark> <a href="#id-2upmrqx4xrqh" id="id-2upmrqx4xrqh"></a>

Die frühzeitige Planung einer Migrationsstrategie spart Aufwand und gewährleistet einen reibungslosen Übergang zwischen Plattformen. Als allgemeines Beispiel bietet Zoom die folgende Strategieübersicht:

1. Entscheiden Sie, welche Slack-Arbeitsplätze migriert werden sollen (einer oder mehrere)
2. Wählen Sie die zu migrierenden Daten:
   1. Öffentliche Kanäle (automatische Migration)
   2. Private Kanäle und Direktnachrichten (DMs) (erfordert Benutzerautorisierung)
   3. Bot- und/oder App-Nachrichten
3. Entscheiden Sie, welche Migrationsmethode Ihren Anforderungen am besten entspricht
4. Legen Sie einen Zeitrahmen für die Migration fest (bis zu maximal einem Jahr pro Auftrag)
5. Kommunizieren Sie mit Benutzern über Genehmigungen für private Nachrichten

**Konsolidierung von Slack-Arbeitsplätzen**

Für Organisationen, die mehrere Slack-Arbeitsplätze verwenden, beispielsweise Benutzer von Enterprise Grid, konsolidiert die Migration zu Zoom Chat alle Arbeitsplätze in einem einzigen Konto.

Um zwischen Arbeitsplätzen zu unterscheiden, fügt Zoom den ursprünglichen Arbeitsplatznamen sowohl an die Kanal- als auch an die Chat-Namen an. Zum Beispiel:

* Ursprünglicher Slack-Kanal:
  * **#engineering** (mit einem Arbeitsplatz von „US Team“)
* Migrierter Zoom-Kanal:
  * **#engineering: US Team**

Diese Konsolidierung stellt sicher, dass alle Daten in ein einziges Zoom Chat-Konto migriert werden, während der ursprüngliche Arbeitsplatzkontext erhalten bleibt. Gemeinsame Bereiche können zusätzliche Struktur für bestimmte Teams oder Abteilungen bieten und so die Organisation und den Zugriff auf Inhalte erleichtern.

**Konsolidierung von Chat-Daten**

Arbeitsplätze mit mehr als 100 Benutzern können Zehntausende private Gruppen-Chats und DMs enthalten, die nie archiviert oder gelöscht wurden, selbst nachdem Benutzer aus dem Unternehmen entfernt wurden. Dies führt dazu, dass private Migrationsaufträge deutlich länger dauern als öffentliche Aufträge.

Administratoren sollten alte Daten bereinigen, indem sie diese alten Unterhaltungen entweder manuell archivieren oder ihre Slack-Aufbewahrungsfrist aktualisieren, damit sie automatisch gelöscht werden.

Zoom empfiehlt, zu prüfen, welche Daten in Zoom Chat als aktiv Daten verbleiben müssen und welche Daten für zukünftige rechtliche Zwecke, Einhaltung, Risikominderung, Personalzwecke oder andere Zwecke archiviert werden können.

{% hint style="success" %}
Sie können zwar mehr Slack-Daten in Zoom Chat replizieren, Zoom empfiehlt jedoch **nur Daten aus einem (1) Jahr zu replizieren, die aktiv sind, und den Rest zu archivieren**. Die meisten Benutzer müssen selten über ein einzelnes Jahr hinaus suchen, um ihre Rolle auszuüben und zu kommunizieren. Zoom empfiehlt, Migrations-Jobs in kleineren Chargen von drei bis sechs Monaten zu erstellen, um erfolgreiche Datenmigrationen durchzuführen.
{% endhint %}

Außerdem ist es wichtig zu berücksichtigen, ob Daten derzeit in Slack gespeichert sind oder mit Diensten von Drittanbietern für DLP, E-Discovery oder Archivierung integriert sind.

**Aufbewahrung des Chat-Verlaufs**

Bei der Migration von Slack zu Zoom sind mehrere Überlegungen zur Aufbewahrung zu beachten, da Slack vollständig cloudbasiert ist, während Zoom detailliertere Aufbewahrungsoptionen bietet:

* Zoom bietet sowohl lokale Gerätespeicherung als auch Cloud-Speicher. [Lokale Gerätespeicherung](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063423) kann von einem (1) Tag bis zu sieben (7) Jahren reichen. [Cloud-Speicher](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0067567) kann deaktiviert oder für einen Aufbewahrungszeitraum von 7 Jahren eingerichtet werden.
* [Aufbewahrungsrichtlinien](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060329) können sowohl auf Konto- als auch auf Gruppenebene für Benutzer konfiguriert werden.
* Administratoren können bei Bedarf für einzelne Kanäle bestimmte Aufbewahrungszeiten festlegen.
* Administratoren können eine Aufbewahrungsrichtlinie für DMs oder Gruppenchats festlegen und eine andere Richtlinie für Chat-Kanäle festlegen.
* Für die Berichterstattung zum Chat-Verlauf empfiehlt Zoom, bearbeitete Nachrichtenrevisionen und Löschungen zu speichern.

Siehe den Zoom-Support-Artikel [Speichern des Zoom-Chat-Nachrichtenverlaufs](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060329) um mehr über die Aufbewahrung des Chat-Verlaufs zu erfahren.

### Bewährte Vorgehensweisen <a href="#ingmqmxix4r2" id="ingmqmxix4r2"></a>

#### <mark style="color:blau;">Bewährte Vorgehensweisen vor der Migration</mark> <a href="#est83jfa09dc" id="est83jfa09dc"></a>

Befolgen Sie diese Empfehlungen für einen einfacheren Vor-Migrationsprozess:

* Stellen Sie sicher, dass Benutzer in Zoom Konten erstellt haben und sich mindestens einmal authentifiziert haben.
* Administratoren haben die Slack-Migrations-App zu ihrem Zoom-Konto hinzugefügt.
* Administratoren, die die Migration durchführen, müssen über Berechtigungen für beide Plattformen (Slack und Zoom Chat) verfügen, und ihre E-Mail muss zwischen ihren Zoom- und Slack-Konten übereinstimmen.
* Administratoren müssen die Zoom Chat Migration App verwenden, um Migrations-Jobs zu konfigurieren, die ausgeführt werden und Daten von Slack zu Zoom Chat verschieben. Hinweis: Dieser Prozess erfordert mindestens 2 Jobs, da mindestens 1 Job private Unterhaltungen verschiebt und 1 Job öffentliche Kanäle verschiebt.
* Administratoren sollten alle unnötigen Slack-Daten, die nicht zu Chat migriert werden sollen, archivieren oder löschen, um die Migration zu beschleunigen.
* Wenn Sie API-Migrations-Jobs für die Migration privater Daten verwenden, stellen Sie sicher, dass den Benutzern bewusst ist, wann und wie sie Slack autorisieren werden, ihre Daten zu Chat zu verschieben.
* Wenn Sie planen, Import-Migrations-Jobs zu verwenden, befolgen Sie [Slacks Anweisungen zum Exportieren Ihrer Arbeitsplatz-Chatdaten als .zip-Datei](https://slack.com/help/articles/201658943-Export-your-workspace-data).
  * Dateianforderungen:
    * Der Name der .zip-Datei darf gegenüber ihrem ursprünglichen, von Slack exportierten Format nicht geändert werden
    * Die Größe der .zip-Datei darf 10 GB nicht überschreiten

#### <mark style="color:blau;">Bewährte Vorgehensweisen für die Migration</mark> <a href="#id-8soj3en5qd2g" id="id-8soj3en5qd2g"></a>

Der folgende Prozess bietet einen allgemeinen Überblick über die Migration:

1. Stellen Sie vor der Migration sicher, dass Benutzer in Zoom erstellt wurden und sich mindestens einmal authentifiziert haben.
2. Administratoren sollten die Slack-Migrations-App vorbereiten und ihrem Zoom-Konto hinzufügen.
3. Der Administrator, der die Migration durchführt, muss über die entsprechenden Berechtigungen für beide Plattformen verfügen und über übereinstimmende E-Mail-Adressen zwischen seinen Zoom- und Slack-Konten verfügen.
4. Administratoren müssen die private App in Slack installieren, um eine Verbindung zu Zoom herzustellen und die OAuth-Authentifizierung durchzuführen.
5. Administratoren verwenden die Zoom Chat Migration App, um Migrations-Jobs für die Verschiebung von Daten von Slack zu Zoom Chat zu konfigurieren. Dies erfordert mindestens 2 Jobs – einen für private Unterhaltungen und einen für öffentliche Kanäle.

Wenn Sie migrieren, befolgen Sie diese empfohlenen Schritte:

1. Migrieren Sie Daten aus einem Kanal, indem Sie den Konversationstyp Öffentliche Kanäle auswählen und einen bestimmten Kanal auswählen. Wählen Sie eine Woche an Daten aus einigen Ihrer ältesten Kanäle aus.
2. Erstellen Sie Jobs, um alle öffentlichen Kanäle von vor über einem Jahr zu übertragen, und überprüfen Sie dann, ob alle Kanäle mit Benutzern erstellt wurden.
3. Nachdem Sie überprüft haben, dass die App wie erwartet funktioniert, erstellen und führen Sie weniger Jobs mit größeren Zeiträumen statt mehr Jobs mit kleineren Zeiträumen aus. Jeder Job enthält dieselbe Anzahl an Schritten zur Migration.
4. (optional) Wiederholen Sie diese Schritte für private Job-Migrationen.

Nach der Datenmigration werden Ihre Daten wie folgt angezeigt:

* Namen öffentlicher/privater Kanäle und Gruppenchats werden angezeigt als: #Kanal-Name: Arbeitsplatz-Name
* Nachrichten, die von Slack-Benutzern mit aktiven Zoom-Konten gesendet werden, werden normal angezeigt, als wären sie von diesen Zoom-Benutzern gesendet worden
* Nachrichten, die von Slack-Benutzern ohne aktive Zoom-Konten gesendet werden, werden als von einem deaktivierten Zoom-Benutzer mit dem Namen des Slack-Nachrichtenabsenders gesendet angezeigt
* Systemnachrichten werden migriert (z. B. „@Ein Benutzer ist dem Kanal beigetreten“)
* Alle Nachrichten werden unabhängig von ihrem Status in Slack als gelesen migriert
* Bei Abschluss wird für jeden öffentlichen und privaten Kanal eine Benachrichtigung über den Abschluss der Migration gesendet, die als „Nachricht wird von der Chat-Migrations-App, Tag, Datum, Uhrzeit gesendet“ angezeigt wird

#### <mark style="color:blau;">Löschen der Migrations-App</mark> <a href="#id-35kihp9337s8" id="id-35kihp9337s8"></a>

Die Migrations-App behält nach der Migration 1:1-Zuordnungen zwischen Slack- und Zoom-Unterhaltungen bei.

{% hint style="warning" %}
Das Entfernen dieser App aus Ihrem Zoom-Konto löscht diese Zuordnungen, was zu doppelten Kanälen und Chats führt, wenn Sie sie neu installieren und erneut migrieren. Löschen Sie die Chat Migration-App nur, wenn Sie sicher sind, dass keine weiteren Migrationen erforderlich sein werden.
{% endhint %}

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

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

Um die App zu installieren:

1. Anmelden im Zoom App Marketplace.
2. Suchen Sie nach Chat Migration und klicken Sie auf **Hinzufügen**.
3. Überprüfen und genehmigen Sie die erforderlichen Berechtigungen.

Siehe den Zoom-Support-Artikel [Verwenden der Chat Migration-App (Slack-Migration-Tool)](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0058132) für detailliertere Installationsanweisungen.

{% hint style="info" %}
Administratoren müssen dem Slack-Arbeitsplatz-Konto oder -Unternehmen die Berechtigung erteilen, die private Anwendung zu installieren und zu autorisieren, **Nachrichtenabruf**. Ein Administrator muss die Verwendung von Apps generell in einem Slack-Arbeitsplatz genehmigen und außerdem allen Mitgliedern die Berechtigungen zur Nutzung der App erteilen.
{% endhint %}

Administratoren müssen die Berechtigung erteilen, die Chat Migration-App in ihrem Zoom-Konto zusammen mit zwei Chat-Management-Berechtigungen in der Administratorrolle zu installieren.

Die Option für **Nur Apps aus dem Slack App Directory zulassen** Einstellung muss **deaktiviert**.

{% hint style="info" %}
Der Administrator, der die App verwendet, muss über eine [Kontoadministrator-Rolle](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060684#h_01FCBKK69SJNA90M1J07SSJ1YB) haben, um Unterhaltungen zu migrieren. Sie dürfen kein benutzerdefinierter Administrator-Typ sein. Mehr erfahren über [das Identifizieren von Kontotypen, Rollen und Lizenzen](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060684) und [Rollenverwaltung](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064983) auf dem Zoom-Support-Standort.
{% endhint %}

#### <mark style="color:blau;">Verbinden Sie Ihren Slack-Arbeitsplatz für API-Migrationsaufträge</mark> <a href="#xjbm4ds0xh3" id="xjbm4ds0xh3"></a>

Wenn Sie die Methode des Dateiimports nicht verwenden, helfen Ihnen diese Anweisungen beim Verbinden für API-Migrationen.

So verbinden Sie einen Arbeitsplatz:

1. Öffnen Sie die Chat Migration-App in Zoom.
2. Klicken **Verbindung erstellen > Anmelden bei Slack** und autorisieren.
3. Bestätigen Sie die Arbeitsplatzverbindung im Zoom-Dashboard.

#### <mark style="color:blau;">Führen Sie die Aufgabe zur Benutzersynchronisierung aus</mark> <a href="#qo97g1d6dweq" id="qo97g1d6dweq"></a>

Die Aufgabe zur Benutzersynchronisierung ruft alle vollständigen, aktiven Mitglieder in Ihrem Slack-Arbeitsplatz ab und erstellt mithilfe ihrer E-Mail-Adresse eine 1:1-Zuordnung zu ihrem entsprechenden Zoom-Konto.

Wenn die E-Mail-Adresse eines aktiven Slack-Benutzers auf der Zoom-Seite nicht gefunden wird, wird für diese E-Mail-Adresse ein neuer, deaktivierter Benutzer in Zoom erstellt.

Wenn die E-Mail-Adresse eines aktiven Slack-Benutzers unter einem anderen Zoom-Konto gefunden wird, z. B. einem persönlichen Konto, wird der Benutzer einem „Dummy-Benutzer“-Profil zugeordnet. In Ihrem Zoom-Konto wird dieser Benutzer genannt **TeamChatMigration AppUser** und vorhanden sein, um sicherzustellen, dass alle Nachrichtendaten für Ihren Arbeitsplatz migriert werden.

{% hint style="warning" %}
Löschen Sie den nicht **TeamChatMigration AppUser** Benutzer.
{% endhint %}

### Ausführen von Migrationsaufträgen <a href="#jpygqaz4w6nu" id="jpygqaz4w6nu"></a>

Der folgende Abschnitt hilft Ihnen, die für die Migration erforderlichen Aufträge zu starten.

#### <mark style="color:blau;">Erstellen eines Import-Migrationsauftrags</mark> <a href="#c2p4z4dmsd2d" id="c2p4z4dmsd2d"></a>

So erstellen Sie einen neuen Migrationsauftrag:

1. Klicken **Dateien hochladen**, wählen Sie Ihre Slack-Exportdatei aus und klicken Sie dann auf **Hochladen**.
2. Warten Sie, bis Ihre Datei in Zoom hochgeladen wurde.
   1. Hinweis: Bitte verlassen Sie die Seite nicht und aktualisieren Sie sie nicht, da dies den Datei-Upload verzögert und der Auftrag im Status „Uploading“ hängen bleibt. Wenn dies geschieht, können Sie den „Uploading“-Auftrag löschen und diesen Vorgang neu starten
3. Sobald der anfängliche Datei-Upload abgeschlossen ist, wird ein **Fenster mit Migrationsdetails** angezeigt, während die Migrations-App die Datei für die Migration vorbereitet. An diesem Punkt können Sie die Seite schließen, verlassen oder aktualisieren, während Sie warten, bis der Auftrag ausgeführt werden kann.
4. Nachdem das Tool die Datei für die Migration vorbereitet hat, können Sie die zu migrierenden Unterhaltungstypen auswählen.
5. Nachdem Sie Ihre Unterhaltungstypen ausgewählt haben, klicken Sie auf **Ausführen** um den Migrationsauftrag zu starten.

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

#### <mark style="color:blau;">Erstellen eines API-Migrationsauftrags</mark> <a href="#ad0zjh4rce2h" id="ad0zjh4rce2h"></a>

So erstellen Sie einen neuen Migrationsauftrag:

1. Klicken **Neuer Migrationsauftrag** und den Slack-Arbeitsplatz auswählen.
2. Wählen Sie die **Datenumfang**:
   * Öffentliche Kanäle (werden automatisch migriert).
   * Private Kanäle und DMs (erfordert Benutzerautorisierung).
   * Spezifischer Datumsbereich für Nachrichten.
3. Nachdem Sie Ihren Datenumfang und -bereich ausgewählt und die Autorisierung von Ihren Benutzern erhalten haben, wählen Sie **Ausführen** um den Migrationsauftrag zu starten.

{% hint style="warning" %}
Umgang mit Anfragen zur Autorisierung privater Daten für private Kanäle und DMs:

* **Private Kanäle und DMs erfordern die Genehmigung durch den Benutzer** vor der Migration.
* Zoom sendet automatisch E-Mail-Anfragen zur Genehmigung, sobald der Migrationsauftrag erstellt wurde.
* Administratoren können nachverfolgen, welche Benutzer genehmigt haben und welche nicht. Für die Migration privater Chat-Inhalte ist nur die Autorisierung eines Benutzers erforderlich, um den gesamten Unterhaltungsverlauf zu migrieren.
* E-Mail-Anfragen zur Autorisierung werden nur an Benutzer gesendet, die noch keine Genehmigung erteilt haben.
* Für optimalen Migrationserfolg sollten Sie darauf abzielen, die Autorisierung von etwa 60–70 % Ihrer Benutzer zu erhalten.
  {% endhint %}

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

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

#### <mark style="color:blau;">Ausführen und Überwachen von Migrationsaufträgen</mark> <a href="#nbokwove1l8n" id="nbokwove1l8n"></a>

**Starten eines neuen Migrationsauftrags**

So starten Sie einen Migrationsauftrag:

1. Klicken **Migration ausführen** um den Vorgang zu beginnen.
2. Die Migrationsdauer variiert (große Arbeitsplätze können **12+ Stunden**).
3. Verfolgen Sie den Fortschritt im **Migrations-Dashboard**.

**Fehlerbehebung bei Migrationsaufträgen**

Gelegentlich liefert ein Migrationsauftrag möglicherweise nicht das gewünschte Ergebnis. Die folgende Tabelle bietet Lösungen für mögliche Probleme, die während der Migration auftreten können:

{% tabs %}
{% tab title="Fehlerbehebung bei Migrationsaufträgen" %}

| Problem                                                           | Lösung                                                                                                               |
| ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| <ul><li>Private Nachrichten/Kanäle fehlen</li></ul>               | <ul><li>Prüfen Sie, ob der Benutzer die Migration autorisiert hat</li></ul>                                          |
| <ul><li>Migrationsauftrag hängt fest</li></ul>                    | Die Migrations-App versucht es automatisch erneut                                                                    |
| <ul><li>Einige Benutzer wurden in Zoom nicht zugeordnet</li></ul> | Stellen Sie sicher, dass sie in Zoom mit derselben E-Mail vorhanden sind, und führen Sie alle Migrationen erneut aus |
| {% endtab %}                                                      |                                                                                                                      |
| {% endtabs %}                                                     |                                                                                                                      |

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

### Migrations-Nachbereitung <a href="#imyt8hpau63q" id="imyt8hpau63q"></a>

Nach Abschluss einer Migration empfiehlt Zoom eine gründliche Nachbereitung und die Überprüfung, ob Ihre Slack-Inhalte wie erwartet in Chat übernommen wurden.

Die folgende Tabelle enthält empfohlene Aufgaben zur Validierung Ihrer Chat-Migrationen:

| Schritt                                   | Aktion                                                                                                                                                                                                                                                                                                                                                            |
| ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Migration überprüfen**                  | <ul><li>Melden Sie sich bei Zoom Chat an und überprüfen Sie, ob Kanäle, Nachrichten und Dateien korrekt angezeigt werden.</li><li>Abmelden und erneut Anmelden, um den Chat-Verlauf zu aktualisieren.</li></ul>                                                                                                                                                   |
| **Fehlende Daten beheben**                | <ul><li>Senden Sie Autorisierungsanfragen erneut an Benutzer, die den Zugriff auf private Daten nicht genehmigt haben.</li><li>Überprüfen Sie Migrationsaufträge auf Fehler und versuchen Sie fehlgeschlagene Aufträge erneut.</li></ul>                                                                                                                          |
| **(optional) Slack außer Betrieb nehmen** | <ul><li>Nachdem bestätigt wurde, dass die Datenmigration abgeschlossen ist, können Sie den Slack-Arbeitsplatz archivieren oder entfernen.</li></ul>                                                                                                                                                                                                               |
| **Allgemeine Fehlerbehebung**             | <ul><li>Wenn Nachrichten fehlen, versuchen Sie, sich abzumelden und wieder bei Zoom anzumelden.</li><li>Wenn Benutzer nicht gefunden werden können, überprüfen Sie, ob die E-Mail-Adressen zwischen Slack und Zoom übereinstimmen.</li><li>Wenn die Migration fehlschlägt, prüfen Sie die Protokolle auf Fehlerdetails und wiederholen Sie den Vorgang.</li></ul> |

#### <mark style="color:blau;">Zusätzliche Checkliste zur Fehlerbehebung</mark> <a href="#id-4fni3sa5k3oh" id="id-4fni3sa5k3oh"></a>

Wenn Sie nach der Migration weitere Probleme entdecken, kann diese Checkliste zusätzliche Schritte und Maßnahmen für die Verifizierung bereitstellen.

{% hint style="info" %}
Bevor Sie fortfahren, müssen Sie die **Zoom-Tracking-ID aus dem Web-Anruf** und beides abrufen **Konto-IDs** und **Benutzer-IDs**.
{% endhint %}

| Kategorie                                                                                       | Problembeschreibung                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ----------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Zoom-Konto-Einstellungen**                                                                    | <ul><li>Bestätigen Sie, dass die Team-Chat-Funktion auf allen Ebenen aktiviert ist</li><li>Überprüfen Sie, dass alle Einstellungen für die Dateifreigabe auf allen Ebenen aktiviert sind, und halten Sie etwaige Dateibeschränkungen in einem Dokument fest</li><li>Stellen Sie sicher, dass „Benutzern das Erstellen öffentlicher + privater Kanäle zulassen“ auf allen Ebenen aktiviert ist</li></ul>                                                                                                                      |
| **Zoom-Benutzerprobleme**                                                                       | <ul><li>Administrator-Status des Benutzers überprüfen</li><li>Bestätigen, dass die E-Mail des Tool-Bedieners in Zoom und Slack übereinstimmt</li><li>Übereinstimmende E-Mail-Adressen für Benutzer, die in Zoom und Slack migriert werden, überprüfen</li></ul>                                                                                                                                                                                                                                                              |
| **Probleme mit dem Migrationsauftrag**                                                          | <ul><li>Job-Abschlussstatus prüfen (bestanden/fehlgeschlagen)</li><li>Feststellen, ob der Auftrag öffentliche Kanäle oder private Kanäle/Unterhaltungen umfasste</li></ul>                                                                                                                                                                                                                                                                                                                                                   |
| **Wenn die Migration erfolgreich war, die Nachrichten/Unterhaltungen aber nicht sichtbar sind** | <ul><li>Sicherstellen, dass der GMT-Zeitraum den vorgesehenen Slack-Nachrichtenbereich korrekt erfasst (Migrationsdaten beginnen/enden um 00:00 Uhr GMT (PST +7))</li><li>Korrekte Kanalerstellung überprüfen</li><li>Sicherstellen, dass sich der Benutzer nach der Migration vom Client abgemeldet und wieder angemeldet hat</li><li>Bestätigen Sie die ordnungsgemäße Erstellung migrierter Benutzer in Zoom</li><li>Überprüfen Sie die Sichtbarkeit von Nachrichten/Gesprächen im Chat-Verlauf im Admin-Portal</li></ul> |
| **Wenn die Migration fehlgeschlagen ist**                                                       | <ul><li>Dokumentieren Sie die spezifische Fehlermeldung</li><li>Bei fehlgeschlagenen Dateimigrationen den Namen der problematischen Datei aufzeichnen</li><li>Dokument Benutzeraktionen, die nach einem Fehler ausgeführt wurden (Job-Wiederholung, neue Job-Erstellung usw.)</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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
