# Zoom Chat-Migrations-App-Feldhandbuch

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

Der Feldleitfaden für die Zoom Chat Migration App ist eine umfassende Ressource für IT-Administratoren und bietet Schritt-für-Schritt-Anweisungen zum Übertragen von Slack-Arbeitsplätzen zu Zoom Chat. Er behandelt wesentliche Prozesse für die Migration öffentlicher Kanäle, privater Kanäle und Direktnachrichten bei gleichzeitiger Wahrung der Datenintegrität und des Kommunikationsverlaufs der Benutzer.

Die [Zoom Chat Migration App](https://marketplace.zoom.us/apps/5ZXfqVPZSfqBYeCR9VLsBg) implementiert eine Architektur mit zwei Engines für die Übertragung von Slack-Arbeitsplatzdaten in Zoom Chat-Umgebungen. Systemadministratoren haben Access zu mehreren Migrationspfaden.

### 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, Ihrem Slack-Plan und Ihren Sicherheitsanforderungen.

Außerdem müssen Sie bestimmte Voraussetzungen von Slack und Zoom 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 sich direkt mit Slack-APIs zu verbinden und Daten zu übertragen. Unterstützt öffentliche Kanäle, private Kanäle und DMs. | Kleinere Unternehmen oder Fälle, in denen die Einholung der Benutzerautorisierung machbar ist   | Benutzer müssen den Access auf ihre Daten für private Chats und DMs autorisieren                              | Vollständig automatisierte und nahtlose Übertragung von Daten direkt aus Slack                                                                                        |
| **Migration mit Import-Tool (dateibasiert)** | Verwendet Slack-Exportdateien, um Daten über Zooms Import-Tool zu migrieren                                                                                | Unternehmen mit Slack Plus- oder Enterprise Grid-Plänen                                         | Administratoren müssen Slack-Daten aus dem Slack-Administrator-Dashboard exportieren                          | Keine Benutzerautorisierung erforderlich; ideal für Massenmigration, insbesondere private Chats                                                                       |
| **Hybrider Ansatz (API + Import)**           | Kombiniert API- und Import-Methoden: öffentliche Kanäle über API; private Kanäle und DMs über das Import-Tool                                              | Mittlere bis große Unternehmen, die die Komplexität der Benutzerautorisierung vermeiden möchten | Administratorzugriff sowohl für den Slack-Export als auch für die Einrichtung der App-basierten API-Migration | Vermeidet Reibungsverluste bei der Benutzerautorisierung für private Chats und erhält gleichzeitig die Automatisierung für die Migration öffentlicher Kanäle aufrecht |

**Systemeinschränkungen**

Der Migrationsprozess unterliegt bestimmten Einschränkungen:

* **Maximale Kapazität eines einzelnen Jobs**: 12 Monate historischer Daten
* **Gesamtes Migrationsfenster**: 60 Monate (5 Jahre)
* **Job-Gleichzeitigkeit**: Es darf jeweils nur ein Job ausgeführt werden

Diese technische Architektur ermöglicht die systematische Migration von Kommunikationsdaten auf Unternehmensebene unter Einhaltung von Sicherheitsprotokollen 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             | Zoom Chat-Entsprechung  | Hinweise                                                                                          |
| -------------------------- | ----------------------- | ------------------------------------------------------------------------------------------------- |
| Öffentliche Kanäle         | Öffentliche Kanäle      | Automatisch migriert                                                                              |
| Private Kanäle             | Private Kanäle          | Erfordert Benutzerfreigabe                                                                        |
| Direktnachrichten (DMs)    | 1:1-Chats               | Erfordert Benutzerfreigabe                                                                        |
| Gruppen-DMs                | Gruppenchats            | Erfordert Benutzerfreigabe                                                                        |
| Threads                    | Inline-Antworten        | Nicht vollständig wie Slack in Threads organisiert, behält aber die Reihenfolge der Antworten bei |
| @-Erwähnungen              | @-Erwähnungen           | Gleiches Verhalten                                                                                |
| Reaktionen                 | Emoji-Reaktionen        | Gleiches Verhalten                                                                                |
| Dateien                    | Geteilte Dateien        | Erfordert aktivierten Cloud-Speicher                                                              |
| Angeheftete Nachrichten    | Markierte Nachrichten   | Angeheftete Nachrichten werden markiert                                                           |
| Slack Bots/App-Nachrichten | Nur Text (keine Karten) | Rich-App-Karten werden nicht migriert                                                             |

#### <mark style="color:blau;">Voraussetzungen für Konto und Berechtigung</mark> <a href="#pppv0j3jhmh6" id="pppv0j3jhmh6"></a>

Sie müssen vor dem Fortfahren sowohl Ihre Slack- als auch Ihre Zoom-Kontoebene sowie Ihre Administratorberechtigungen prüfen.

* Ein **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 - das **Bearbeiten** Kontrollkästchen muss ausgewählt sein für **Chat-Kanäle** und **Chat-Nachrichten** Rollen. Andernfalls kann er die Zoom Slack Migration-App aufgrund unzureichender Berechtigungen nicht autorisieren.
{% endhint %}

* Cloud-Speicher muss aktiviert sein für **Nachrichten-/Dateiaufbewahrung**.

**Slack-APIs: Scopes, Berechtigungen und Ratenlimits**

Slack-APIs werden verwendet, um Ihre Slack-Benutzer-, Kanal- und Nachrichtendaten abzurufen. Diese Datentypen unterliegen Ratenlimits, die für einen Slack-Arbeitsplatz nur eine bestimmte Anzahl von Anfragen pro Minute zulassen. Dies ist ein wichtiger Aspekt bei der Planung Ihres Migrationszeitplans.

**Leistungs-Benchmarks für Slack-Migrationsjobs**

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

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

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

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

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

Obwohl Ihr Slack-Arbeitsplatz Hunderte oder Tausende von Kanälen enthalten kann, folgt die Aktivitätsverteilung in Kanälen vorhersehbaren Mustern, die sich direkt auf die Migrationsleistung und den Ressourcenbedarf auswirken. Kanäle mit hoher Aktivität und umfangreichen Nachrichtenverläufen, Dateianhängen und Benutzerinteraktionen erfordern die oben beschriebenen vollständigen Benchmark-Verarbeitungszeiten. Die Mehrheit der Kanäle im Arbeitsplatz enthält jedoch typischerweise nur geringe Aktivität - bestehend aus kurzen Gesprächen, Ankündigungen oder archivierten Diskussionen, die deutlich schneller migrieren 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-Bereiche 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 Authentizität und historischen Nachverfolgung.

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

Sie müssen auch die Option für **Nur Apps aus dem Slack-Verzeichnis zulassen** auf **AUS**setzen, wodurch die Slack-App installiert werden kann, sobald die Verbindung zum Arbeitsplatz hergestellt wurde. Die folgenden Slack-Berechtigungen 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;">Migrationsüberlegungen</mark> <a href="#id-2upmrqx4xrqh" id="id-2upmrqx4xrqh"></a>

Wenn Sie frühzeitig eine Migrationsstrategie in Betracht ziehen, sparen Sie Aufwand und sorgen für einen reibungslosen Übergang zwischen den Plattformen. Als grobes Beispiel bietet Zoom den folgenden Strategierahmen:

1. Wählen Sie aus, welche Slack Arbeitsplätze migriert werden sollen (einen oder mehrere)
2. Wählen Sie aus, welche Daten migriert werden sollen:
   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 Zeitraum für die Migration fest (bis zu maximal einem Jahr pro Auftrag)
5. Kommunizieren Sie mit Benutzern über Freigaben für private Nachrichten

**Konsolidierung des Slack Arbeitsplatze**

Für Organisationen, die mehrere Slack Arbeitsplätze verwenden, wie z. B. Enterprise Grid-Benutzer, 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 Kanal- als auch Chatnamen 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. Geteilte Bereiche können zusätzliche Struktur für bestimmte Teams oder Abteilungen bieten und so das Organisieren und Zugreifen auf Inhalte erleichtern.

**Konsolidierung von Chat-Daten**

Arbeitsplätze mit mehr als 100 Benutzern können Zehntausende privater Gruppen-Chats und DMs haben, die nie archiviert oder gelöscht wurden, selbst nachdem Benutzer aus dem Unternehmen entfernt wurden. Dadurch dauern private Migrationsaufträge erheblich länger als öffentliche Aufträge.

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

Zoom empfiehlt zu prüfen, welche Daten als aktive Daten in Zoom Chat verbleiben müssen und welche Daten für zukünftige rechtliche, Einhaltungs-, Risikominderungs-, Personal- oder andere Zwecke archiviert werden können.

{% hint style="success" %}
Während Sie mehr Slack-Daten in Zoom Chat replizieren können, empfiehlt Zoom, **nur ein (1) Jahr aktiver Daten zu replizieren und den Rest zu archivieren**. Die meisten Benutzer müssen für die Ausübung ihrer Rolle und die Kommunikation selten länger als ein einzelnes Jahr zurücksuchen. Zoom empfiehlt, Migrationsaufträge in kleineren Stapeln von drei bis sechs Monaten zu erstellen, um erfolgreiche Datenmigrationen zu gewährleisten.
{% endhint %}

Außerdem ist es wichtig zu berücksichtigen, ob sich Daten derzeit in Slack befinden oder mit Drittanbieterdiensten für DLP, eDiscovery oder Archivierung integriert sind.

**Aufbewahrung des Chatverlaufs**

Beim Wechsel von Slack zu Zoom gibt es mehrere aufbewahrungsbezogene Überlegungen, da Slack vollständig Cloud-basiert ist, während Zoom granularere Aufbewahrungsoptionen bietet:

* Zoom bietet sowohl lokalen Gerätespeicher als auch Cloud-Speicher. [Lokaler Gerätespeicher](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 für Benutzer sowohl auf Konto- als auch auf Gruppenebene konfiguriert werden.
* Administratoren können bei Bedarf spezifische Aufbewahrungszeiten für einzelne Kanäle festlegen.
* Administratoren können eine Aufbewahrungsrichtlinie für Direktnachrichten oder Gruppen-Chats festlegen und eine andere Richtlinie für Chat-Kanäle einstellen.
* Für die Berichterstattung zum Chatverlauf empfiehlt Zoom, Bearbeitungen und Löschungen von Nachrichten 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 Chatverlaufs zu erfahren.

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

#### <mark style="color:blau;">Best Practices für die Vorbereitung der Migration</mark> <a href="#est83jfa09dc" id="est83jfa09dc"></a>

Befolgen Sie diese Empfehlungen für einen einfacheren Vorbereitungsprozess der Migration:

* Stellen Sie sicher, dass Benutzer Konten auf Zoom erstellt haben und sich mindestens einmal authentifiziert haben.
* Administratoren haben die Slack Migration 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 Migrationsaufträge zu Konfigurieren, auszuführen und Daten von Slack nach Zoom Chat zu verschieben. Hinweis: Dieser Prozess erfordert mindestens 2 Aufträge, da mindestens 1 Auftrag private Unterhaltungen verschiebt und 1 Auftrag öffentliche Kanäle verschiebt.
* Administratoren sollten alle unnötigen Slack-Daten, die sie nicht nach Chat migrieren möchten, archivieren oder löschen, um die Migrationen zu beschleunigen.
* Wenn Sie API-Migrationsaufträge für die Migration privater Daten verwenden, stellen Sie sicher, dass Benutzer wissen, wann und wie sie Slack autorisieren werden, ihre Daten nach Chat zu verschieben.
* Wenn Sie die Verwendung von Import-Migrationsaufträgen planen, folgen Sie [den Anweisungen von Slack zum Exportieren Ihrer Arbeitsplatz-Chat-Daten als .zip-Datei](https://slack.com/help/articles/201658943-Export-your-workspace-data).
  * Dateianforderungen:
    * Der Name der .zip-Datei darf nicht vom ursprünglichen exportierten Slack-Format abweichen
    * Die Größe der .zip-Datei darf 10 GB nicht überschreiten

#### <mark style="color:blau;">Best Practices 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 Migration App vorbereiten und zu ihrem Zoom-Konto hinzufügen.
3. Der Administrator, der die Migration durchführt, muss über geeignete Berechtigungen für beide Plattformen und ü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 Migrationsaufträge für das Verschieben von Daten von Slack nach Zoom Chat zu Konfigurieren. Dies erfordert mindestens 2 Aufträge – einen für private Unterhaltungen und einen für öffentliche Kanäle.

Befolgen Sie bei der Migration diese empfohlenen Schritte:

1. Migrieren Sie Daten aus einem Kanal, indem Sie den UnterhaltungsTyp „Öffentliche Kanäle auswählen“ auswählen und einen bestimmten Kanal wählen. Wählen Sie Daten im Umfang einer Woche aus einigen Ihrer ältesten Kanäle aus.
2. Erstellen Sie Aufträge, um alle öffentlichen Kanäle von vor mehr als einem Jahr zu übertragen, und verifizieren Sie dann, dass 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 Aufträge mit größeren Zeitbereichen statt mehr Aufträge mit kleineren Zeitbereichen aus. Jeder Auftrag enthält die gleiche Anzahl an Schritten für die Migration.
4. (optional) Wiederholen Sie diese Schritte für Migrationen privater Aufträge.

Nach der Datenmigration werden Ihre Daten wie folgt angezeigt:

* Namen von öffentlichen/privaten Kanälen und Gruppen-Chats werden wie folgt angezeigt: #kanal-name: arbeitsplatz-name
* Von Slack-Benutzern mit aktiven Zoom-Konten gesendete Nachrichten werden normal angezeigt, als wären sie von diesen Zoom-Benutzern gesendet worden
* Von Slack-Benutzern ohne aktive Zoom-Konten gesendete Nachrichten werden als von einem deaktivierten Zoom-Benutzer mit dem Namen des Slack-Nachrichtenabsenders gesendet angezeigt
* Systemnachrichten werden migriert (z. B. „@Ein Benutzer hat den 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 Mitteilung zum Abschluss der Migration gesendet, die als „Nachricht wird von der Chat Migration App, Tag Datum Uhrzeit gesendet“ angezeigt wird

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

Die Migrations-App verwaltet nach der Migration 1:1-Zuordnungen zwischen Slack- und Zoom-Unterhaltungen.

{% hint style="warning" %}
Wenn Sie diese App aus Ihrem Zoom-Konto entfernen, werden diese Zuordnungen gelöscht, 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>" %}

So installieren Sie die App:

1. Melden Sie sich beim Zoom App Marketplace an.
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-Migrationstool)](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-Arbeitsplatzkonto oder Unternehmen die Berechtigung erteilen, die private Anwendung zu installieren und zu autorisieren, **Message Retriever**. Ein Administrator muss allgemein die Verwendung von Apps in einem Slack-Arbeitsplatz genehmigen und außerdem Berechtigungen für alle Mitglieder erteilen, die App zu verwenden.
{% endhint %}

Administratoren müssen die Berechtigung erteilen, die Chat Migration app in ihrem Zoom-Konto zusammen mit zwei Chat Management-Berechtigungen in der Rollenverwaltung 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 eine [Konto-Administratorrolle](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060684#h_01FCBKK69SJNA90M1J07SSJ1YB) haben, um Unterhaltungen zu migrieren. Es kann sich nicht um einen benutzerdefinierten Administratortyp handeln. 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 der Zoom-Support-Website.
{% endhint %}

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

Wenn Sie nicht die Datei-Import-Methode verwenden, helfen Ihnen diese Anweisungen, die Verbindung für API-Migrationen herzustellen.

So verbinden Sie einen Arbeitsplatz:

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

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

Die Aufgabe Benutzer-Synchronisierung ruft alle vollständigen, aktiven Mitglieder in Ihrem Slack-Arbeitsplatz ab und erstellt anhand 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, z. B. einem persönlichen Konto, gefunden wird, wird der Benutzer einem „Dummy-Benutzer“-Profil zugeordnet. In Ihrem Zoom-Konto wird dieser Benutzer genannt **TeamChatMigration AppUser** und ist vorhanden, um sicherzustellen, dass alle Nachrichtendaten für Ihren Arbeitsplatz migriert werden.

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

### Migrationsaufträge ausführen <a href="#jpygqaz4w6nu" id="jpygqaz4w6nu"></a>

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

#### <mark style="color:blau;">Einen Import-Migrationsauftrag erstellen</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 auf Zoom hochgeladen wurde.
   1. Hinweis: Bitte verlassen oder aktualisieren Sie die Seite nicht, da dies den Datei-Upload anhalten und der Auftrag im Status „Uploading“ hängen bleiben würde. Wenn dies passiert, können Sie den Auftrag „Uploading“ löschen und diesen Vorgang neu starten
3. Sobald der erste Datei-Upload abgeschlossen ist, wird ein **Fenster mit Migrationsdetails** eingeblendet, während die Migration App die Datei für die Migration vorbereitet. Zu diesem Zeitpunkt können Sie die Seite schließen, verlassen oder aktualisieren, während Sie warten, bis der Auftrag bereit zum Ausführen ist.
4. Nachdem das Tool mit der Vorbereitung der Datei für die Migration fertig ist, können Sie die zu migrierenden Konversationstypen auswählen.
5. Sobald Sie Ihre Konversationstypen 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 auswählen Sie den Slack-Arbeitsplatz.
2. Wählen Sie den **Datenumfang**:
   * Öffentliche Kanäle (werden automatisch migriert).
   * Private Kanäle & DMs (erfordert die Autorisierung des Benutzers).
   * Spezifischer Datumsbereich für Nachrichten.
3. Sobald Sie Ihren Datenumfang und -bereich ausgewählt haben und die Autorisierung Ihrer Benutzer eingeholt haben, auswählen Sie **Ausführen** um den Migrationsauftrag zu starten.

{% hint style="warning" %}
Umgang mit Autorisierungsanfragen für private Daten bei privaten Kanälen und DMs:

* **Private Kanäle und DMs erfordern die Zustimmung des Benutzers** vor der Migration.
* Zoom sendet automatisch E-Mail-Anfragen zur Genehmigung, sobald der Migrationsauftrag erstellt wurde.
* Administratoren können nachverfolgen, welche Benutzer genehmigt haben bzw. nicht. Für die Migration des privaten Chats ist nur die Autorisierung eines Benutzers erforderlich, um den gesamten Gesprächsverlauf zu migrieren.
* E-Mail-Anfragen zur Autorisierung werden nur an Benutzer gesendet, die noch keine Genehmigung erteilt haben.
* Für einen optimalen Migrationserfolg sollten Sie die Autorisierung von etwa 60–70 % Ihrer Benutzer anstreben.
  {% 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**

Um einen Migrationsauftrag zu starten, führen Sie Folgendes aus:

1. Klicken **Migration ausführen** um den Prozess zu beginnen.
2. Die Migrationszeiten variieren (große Arbeitsplätze können **12+ Stunden**).
3. Verfolgen Sie den Fortschritt im **Migration 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 während der Migration aufgetretene Probleme:

{% tabs %}
{% tab title="Fehlerbehebung bei der Migration" %}

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

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

### Postmortem zur Migration <a href="#imyt8hpau63q" id="imyt8hpau63q"></a>

Nach Abschluss einer Migration empfiehlt Zoom, eine gründliche Nachbesprechung durchzuführen und zu überprüfen, ob Ihre Slack-Inhalte wie erwartet in Chat übernommen wurden.

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

| Schritt                                   | Aktion                                                                                                                                                                                                                                                                                                                                                         |
| ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Die Migration verifizieren**            | <ul><li>Melden Sie sich bei Zoom Chat an und verifizieren Sie, dass Kanäle, Nachrichten und Dateien korrekt angezeigt werden.</li><li>Melden Sie sich ab und wieder an, um den Chat-Verlauf zu aktualisieren.</li></ul>                                                                                                                                        |
| **Fehlende Daten beheben**                | <ul><li>Senden Sie Autorisierungsanfragen erneut an Benutzer, die keinen Zugriff auf private Daten 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 Sie bestätigt haben, 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 bei Zoom ab- und wieder anzumelden.</li><li>Wenn Benutzer nicht gefunden werden können, verifizieren Sie, dass 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 Prozess.</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 Aktionen zur Verifizierung bereitstellen.

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

| Kategorie                                                                                 | Problembeschreibung                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ----------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Zoom-Kontoeinstellungen**                                                               | <ul><li>Bestätigen Sie, dass die Team-Chat-Funktionalität auf allen Ebenen aktiviert ist</li><li>Verifizieren Sie, dass alle Einstellungen für die Dateifreigabe auf allen Ebenen aktiviert sind, und dokumentieren Sie etwaige Dateibeschränkungen</li><li>Verifizieren Sie, dass "Benutzern das Erstellen öffentlicher + privater Kanäle erlauben" auf allen Ebenen aktiviert ist</li></ul>                                                                                                                                                               |
| **Zoom-Benutzerprobleme**                                                                 | <ul><li>Verifizieren Sie den Administratorstatus des Benutzers</li><li>Bestätigen Sie, dass die E-Mail des Tool-Bedieners zwischen Zoom und Slack übereinstimmt</li><li>Verifizieren Sie die übereinstimmenden E-Mail-Adressen der zu migrierenden Benutzer in Zoom und Slack</li></ul>                                                                                                                                                                                                                                                                     |
| **Probleme mit dem Migrationsauftrag**                                                    | <ul><li>Prüfen Sie den Abschlussstatus des Auftrags (bestanden/nicht bestanden)</li><li>Stellen Sie fest, ob der Auftrag öffentliche Kanäle oder private Kanäle/Unterhaltungen umfasste</li></ul>                                                                                                                                                                                                                                                                                                                                                           |
| **Wenn die Migration bestanden hat, aber Nachrichten/Unterhaltungen nicht sichtbar sind** | <ul><li>Bestätigen Sie, dass der GMT-Zeitraum den vorgesehenen Slack-Nachrichtenbereich korrekt erfasst (Migrationsdaten beginnen/enden um 12 Uhr morgens GMT (PST +7))</li><li>Die ordnungsgemäße Kanalerstellung verifizieren</li><li>Stellen Sie sicher, dass der Benutzer sich nach der Migration vom Client ab- und wieder angemeldet hat</li><li>Bestätigen Sie die ordnungsgemäße Erstellung der migrierten Benutzer in Zoom</li><li>Verifizieren Sie die Sichtbarkeit von Nachrichten/Unterhaltungen im Chat-Verlauf-Administrator-Portal</li></ul> |
| **Wenn die Migration fehlgeschlagen ist**                                                 | <ul><li>Dokumentieren Sie die spezifische Fehlermeldung</li><li>Bei fehlgeschlagenen Dateimigrationen zeichnen Sie den Namen der problematischen Datei auf</li><li>Dokumentieren Sie die vom Benutzer nach dem Fehler vorgenommenen Aktionen (erneuter Auftragsversuch, Erstellung eines neuen Auftrags usw.)</li></ul>                                                                                                                                                                                                                                     |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

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

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
