# Feldleitfaden zur Zoom Chat Migrations App

### Einleitung <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 behandelt wesentliche Prozesse für die Migration öffentlicher Kanäle, privater Kanäle und Direktnachrichten, wobei die Datenintegrität und der Kommunikationsverlauf der Benutzer erhalten bleiben.

Der [Zoom Chat Migration App](https://marketplace.zoom.us/apps/5ZXfqVPZSfqBYeCR9VLsBg) implementiert eine Architektur mit zwei Engines für die Übertragung von Slack-Arbeitsplatz-Daten 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, Ihrem Slack-Plan und Ihren Sicherheitsanforderungen.

Zusätzlich 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 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 es machbar ist, eine Benutzerautorisierung zu erhalten   | 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                                                                         |
| **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 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 sowohl für den Slack-Export als auch für die Einrichtung der App-basierten API-Migration | Vermeidet Reibung durch Benutzerautorisierung bei privaten Chats und behält gleichzeitig die Automatisierung für die Migration öffentlicher Kanäle bei |

**Systemeinschränkungen**

Der Migrationsprozess unterliegt bestimmten Einschränkungen:

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

Diese technische Architektur ermöglicht die systematische Migration von Enterprise-Kommunikationsdaten 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  | Notizen                                                                                   |
| -------------------------- | ----------------------- | ----------------------------------------------------------------------------------------- |
| Ö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                | Gruppen-Chats           | Erfordert Benutzerfreigabe                                                                |
| Threads                    | Inline-Antworten        | Nicht vollständig in Threads wie bei Slack, 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) | Umfangreiche 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 sowohl Ihre Slack- als auch Ihre Zoom-Konto-Stufen und Administrator-Berechtigungen überprüfen, bevor Sie fortfahren.

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

{% hint style="info" %}
Der Administrator, der die Zoom Marketplace-App installiert, muss auf die Rollenverwaltung im Webportal zugreifen. Er muss sicherstellen, dass ihm die richtigen Berechtigungen für die Chat-Verwaltung 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 **Aufbewahrung von Nachrichten/Dateien**.

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

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

**Leistungsbenchmarks für Slack-Migrationsjobs**

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

{% tabs %}
{% tab title="Leistungsvergleichsanalyse nach Implementierungsmethode der Migration" %}

| 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 einem Jahr historischer 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 Dateitransferverarbeitung betreffen sowohl Import- als auch API-basierte Migrationsmethoden und erzeugen Leistungsgrenzen, die während der Bereitstellungsplanung eine angemessene Bandbreitenzuweisung und Strategien zur Transferoptimierung erfordern. API-basierte Migrationsjobs unterliegen aufgrund der nativen API-Ratenbegrenzungsmechanismen von Slack zusätzlichen Leistungseinschränkungen. Diese Einschränkungen betreffen Importmigrationen nicht, wirken sich jedoch erheblich auf API-basierte Implementierungen aus und erfordern längere Verarbeitungsfenster sowie eine sorgfältige Jobplanung, um den Durchsatz zu optimieren und gleichzeitig die Einhaltung der Plattformbeschränkungen aufrechtzuerhalten.

Während 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 den Bedarf an Ressourcenzuweisung auswirken. Kanäle mit hoher Aktivität und umfangreichen Nachrichtenverläufen, Dateianhängen und Benutzerinteraktionen erfordern die oben genannten vollständigen Benchmark-Verarbeitungszeiten. Die Mehrheit der Arbeitsplatz-Kanäle enthält jedoch in der Regel nur minimale Aktivität – bestehend aus kurzen Unterhaltungen, Ankündigungen oder archivierten Diskussionen, die deutlich schneller migriert werden als die Benchmark-Schätzungen.

**Erforderliche Administrator-Berechtigungen und Bereiche**

Der Zoom App Marketplace erfordert die folgenden Administrator-Berechtigungen und Bereiche innerhalb des Zoom-Mandanten:

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

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

* `Chat-Nachricht:schreiben:Administrator`
* `imchat:bot`
* `Chat_Kanal:schreiben: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 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 Autorisierungstoken für die Datenmigration bereitzustellen. Benutzer müssen die Migration privater Unterhaltungen autorisieren (DMs, Gruppenchats und private Kanäle).

Sie müssen auch die Option für festlegen **Nur Apps aus dem Slack-Verzeichnis zulassen** bis **AUS**, wodurch die Slack-App einmalig 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;">Überlegungen zur Migration</mark> <a href="#id-2upmrqx4xrqh" id="id-2upmrqx4xrqh"></a>

Eine Migrationsstrategie im Voraus zu berücksichtigen, spart Aufwand und sorgt für einen reibungslosen Übergang zwischen Plattformen. Als Beispiel auf hoher Ebene bietet Zoom die folgende Strategieübersicht:

1. Entscheiden Sie, welche Slack-Arbeitsbereiche migriert werden sollen (einer 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 die Autorisierung des Benutzers)
   3. Nachrichten von Bots und/oder Apps
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

**Slack Arbeitsplatz-Konsolidierung**

Für Organisationen, die mehrere Slack Arbeitsplätze verwenden, wie 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 den Kanal- als auch den Chatnamen hinzu. Zum Beispiel:

* Originaler Slack-Kanal:
  * **#engineering** (mit einem Arbeitsplatz von "US Team")
* Migrierter Zoom-Kanal:
  * **#engineering: US Team**

Diese Konsolidierung stellt sicher, dass alle Daten in ein einzelnes Zoom Chat-Konto migriert werden, während der ursprüngliche Arbeitsplatz-Kontext erhalten bleibt. Geteilte Bereiche können zusätzliche Struktur für bestimmte Teams oder Abteilungen bieten, wodurch es einfacher wird, Inhalte zu organisieren und darauf zuzugreifen.

**Konsolidierung von Chat-Daten**

Arbeitsplätze mit mehr als 100 Benutzern können Zehntausende privater Gruppen-Chats und Direktnachrichten 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, um sie automatisch zu löschen.

Zoom empfiehlt zu prüfen, welche Daten in Zoom Chat als aktive Daten verbleiben müssen und welche Daten für zukünftige rechtliche, Einhaltung-, 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 selten über ein einzelnes Jahr hinaus suchen, um ihre Rolle auszuüben und zu kommunizieren. 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 die Daten derzeit in Slack befinden oder mit Drittanbieterdiensten für DLP, eDiscovery oder Archivierung integriert sind.

**Aufbewahrung des Chat-Verlaufs**

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

* Zoom bietet sowohl lokalen Gerät-Speicher als auch Cloud-Speicher. [Lokaler Gerät-Speicher](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 bestimmte 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 einrichten.
* Für die Berichterstattung zum Chat-Verlauf empfiehlt Zoom, bearbeitete Nachrichtenrevisionen und Löschungen zu speichern.

Siehe den Artikel im Zoom-Support [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.

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

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

Befolgen Sie diese Empfehlungen für einen einfacheren Vormigrationsprozess:

* Stellen Sie sicher, dass Benutzer Konten in Zoom erstellt 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 zu Zoom Chat zu verschieben. Hinweis: Dieser Prozess erfordert mindestens 2 Aufträge, da mindestens 1 Auftrag private Unterhaltungen und 1 Auftrag öffentliche Kanäle verschiebt.
* Administratoren sollten alle unnötigen Slack-Daten archivieren oder löschen, die sie nicht zu Chat migrieren möchten, 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 zu Chat zu verschieben.
* Wenn Sie die Verwendung von Import-Migrationsaufträgen planen, befolgen Sie [die 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 gegenüber dem ursprünglichen von Slack exportierten Format geändert werden
    * 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 sich mit Zoom zu verbinden und eine OAuth-Authentifizierung durchzuführen.
5. Administratoren verwenden die Zoom Chat Migration App, um Migrationsaufträge für das Verschieben von Daten von Slack zu 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 Konversationstyp „Öffentliche Kanäle auswählen“ auswählen und einen bestimmten Kanal auswählen. Wählen Sie Daten 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 überprüfen 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 aus statt mehr Aufträge mit kleineren Zeitbereichen. Jeder Auftrag enthält die gleiche Anzahl von 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 ist dem Kanal beigetreten“)
* Alle Nachrichten werden unabhängig von ihrem Status in Slack als gelesen migriert
* Bei Abschluss wird an jeden öffentlichen und privaten Kanal eine Benachrichtigung über den Abschluss der Migration gesendet, die als "Nachricht wird von der Chat Migration App, Tag Datum Uhrzeit gesendet" erscheint

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

Die Migrations-App pflegt 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 bei einer erneuten Installation und Migration zu doppelten Kanälen und Chats führt. 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 Artikel im Zoom-Support [Verwenden der Chat Migration App (Slack Migration-Tool)](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0058132) für genauere Installationsanweisungen.

{% hint style="info" %}
Administratoren müssen dem Slack-Arbeitsplatz-Konto oder Unternehmen die Berechtigung erteilen, die private Anwendung zu installieren und zu autorisieren, **Message Retriever**. Ein Administrator muss die Verwendung von Apps im Allgemeinen in einem Slack-Arbeitsplatz genehmigen und außerdem die 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 sein**.

{% hint style="info" %}
Der Administrator, der die App verwendet, muss eine [Kontoadministrator-Rolle](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060684#h_01FCBKK69SJNA90M1J07SSJ1YB) haben, um Unterhaltungen zu migrieren. Er darf kein benutzerdefinierter Administrator-Typ sein. Mehr erfahren über [die Identifizierung 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 die Dateiimport-Methode 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 Sie auf **Verbindung erstellen > Bei Slack anmelden** und autorisieren.
3. Bestätigen Sie die Arbeitsplatzverbindung im Zoom-Dashboard.

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

Die Aufgabe 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 innerhalb von Zoom ein neuer, deaktivierter Benutzer erstellt.

Wenn die E-Mail-Adresse eines aktiven Slack-Benutzers unter einem anderen Zoom-Konto gefunden wird, z. B. unter einem persönlichen Konto, wird der Benutzer einem "Dummy-Benutzer"-Profil zugeordnet. In Ihrem Zoom-Konto wird dieser Benutzer genannt **TeamChatMigration AppUser** und wird vorhanden sein, 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 beim Starten der für die Migration erforderlichen Aufträge.

#### <mark style="color:blau;">Einen Import-Migrationsauftrag erstellen</mark> <a href="#c2p4z4dmsd2d" id="c2p4z4dmsd2d"></a>

So erstellen Sie einen neuen Migrationsauftrag:

1. Klicken Sie auf **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 oder aktualisieren Sie die Seite nicht, da sonst der Datei-Upload stoppt und der Auftrag im Status "Wird hochgeladen" hängen bleibt. Wenn dies geschieht, können Sie den Auftrag "Wird hochgeladen" löschen und diesen Vorgang neu starten
3. Sobald der anfängliche Datei-Upload abgeschlossen ist, wird ein **Fenster mit den Migrationsdetails** eingeblendet, 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 startbereit ist.
4. Nachdem das Tool die Datei für die Migration vorbereitet hat, 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;">Einen API-Migrationsauftrag erstellen</mark> <a href="#ad0zjh4rce2h" id="ad0zjh4rce2h"></a>

So erstellen Sie einen neuen Migrationsauftrag:

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

{% hint style="warning" %}
Verarbeitung von Autorisierungsanfragen für private Daten für private Kanäle 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 zugestimmt haben und welche nicht. Für die Migration von privatem Chat ist nur die Autorisierung eines Benutzers erforderlich, um den gesamten Konversationsverlauf zu migrieren.
* E-Mails mit Autorisierungsanfragen werden nur an Benutzer gesendet, die noch keine Genehmigung erteilt haben.
* Für einen optimalen Migrationserfolg sollten Sie versuchen, 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;">Migrationsaufträge ausführen und überwachen</mark> <a href="#nbokwove1l8n" id="nbokwove1l8n"></a>

**Einen neuen Migrationsauftrag starten**

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

1. Klicken Sie auf **Migration ausführen** um den Vorgang zu beginnen.
2. Die Migrationszeiten variieren (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 der Migration" %}

| 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 sind 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>" %}

### Postmortem der 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 Schritte zur Validierung Ihrer Chat-Migrationen:

| Schritt                                   | Aktion                                                                                                                                                                                                                                                                                                                                                                           |
| ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Die Migration überprüfen**              | <ul><li>Bei Zoom Chat anmelden und überprüfen, ob 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 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 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 abzumelden und wieder 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, überprüfen Sie die Protokolle auf Fehlerinformationen und versuchen Sie den Vorgang erneut.</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 zur Verifizierung bereitstellen.

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

| Kategorie                                                                                   | Problembeschreibung                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Zoom-Konto-Einstellungen**                                                                | <ul><li>Bestätigen Sie, dass die Team-Chat-Funktionalität auf allen Ebenen aktiviert ist</li><li>Überprüfen Sie, dass alle Dateifreigabe-Einstellungen auf allen Ebenen aktiviert sind, und Dokument etwaige Dateibeschränkungen</li><li>Überprüfen Sie, dass „Benutzern das Erstellen öffentlicher + privater Kanäle zulassen“ auf allen Ebenen aktiviert ist</li></ul>                                                                                                                                                                 |
| **Zoom-Benutzerprobleme**                                                                   | <ul><li>Überprüfen Sie den Administrator-Status des Benutzers</li><li>Bestätigen Sie, dass die E-Mail des Tool-Bedieners zwischen Zoom und Slack übereinstimmt</li><li>Überprüfen Sie übereinstimmende E-Mail-Adressen für Benutzer, die sowohl in Zoom als auch in Slack migriert werden</li></ul>                                                                                                                                                                                                                                      |
| **Probleme mit dem Migrationsauftrag**                                                      | <ul><li>Prüfen Sie den Abschlussstatus des Auftrags (bestanden/fehlgeschlagen)</li><li>Stellen Sie fest, ob der Auftrag öffentliche Kanäle oder private Kanäle/Unterhaltungen umfasste</li></ul>                                                                                                                                                                                                                                                                                                                                         |
| **Wenn die Migration erfolgreich war, aber Nachrichten/Unterhaltungen nicht sichtbar sind** | <ul><li>Bestätigen Sie, dass der GMT-Zeitraum den beabsichtigten Slack-Nachrichtenbereich korrekt erfasst (Migrationsdaten beginnen/enden um 0:00 Uhr GMT (PST +7))</li><li>Überprüfen Sie die korrekte Kanalerstellung</li><li>Stellen Sie sicher, dass der Benutzer sich 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 der Nachricht/des Chats im Chat-Verlauf im Admin-Portal</li></ul> |
| **Wenn die Migration fehlgeschlagen ist**                                                   | <ul><li>Dokumentieren Sie die spezifische Fehlermeldung</li><li>Bei Fehlern bei der Dateimigration zeichnen Sie den Namen der problematischen Datei auf</li><li>Dokumentieren Sie Benutzeraktionen, die nach einem Fehler durchgeführt wurden (erneuter Job-Versuch, Erstellen eines neuen Jobs usw.)</li></ul>                                                                                                                                                                                                                          |
