> 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-Feldleitfaden

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

Der Zoom Chat-Migration-App-Feldleitfaden 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 bei gleichzeitiger Wahrung der Datenintegrität und des Kommunikationsverlaufs der Benutzer.

Der [Zoom Chat-Migration-App](https://marketplace.zoom.us/apps/5ZXfqVPZSfqBYeCR9VLsBg) implementiert eine Architektur mit zwei Engines zur Ü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 für 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 Autorisierung der Benutzer 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 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 | Administrator-Access 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 für einen einzelnen Auftrag**: 12 Monate historischer Daten
* **Gesamtes Migrationsfenster**: 60 Monate (5 Jahre)
* **Gleichzeitigkeit von Aufträgen**: Es darf jeweils nur ein Auftrag ausgeführt werden

Diese technische Architektur ermöglicht die systematische Migration von Kommunikationsdaten auf Enterprise-Ebene bei gleichzeitiger 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-Äquivalent    | Hinweise                                                                                 |
| -------------------------- | ----------------------- | ---------------------------------------------------------------------------------------- |
| Öffentliche Kanäle         | Öffentliche Kanäle      | Automatisch migriert                                                                     |
| Private Kanäle             | Private Kanäle          | Erfordert Benutzergenehmigung                                                            |
| Direktnachrichten (DMs)    | 1:1-Chats               | Erfordert Benutzergenehmigung                                                            |
| Gruppen-DMs                | Gruppen-Chats           | Erfordert Benutzergenehmigung                                                            |
| Threads                    | Inline-Antworten        | Nicht vollständig wie in Slack als Thread, aber behält 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 sowohl Ihre Slack- als auch Ihre Zoom-Kontoebenen und Administratorberechtigungen überprüfen, bevor Sie fortfahren.

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

{% hint style="info" %}
Der Administrator, der die Zoom Marketplace App installiert, muss auf dem Webportal die Rollenverwaltung aufrufen. 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 haben 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ätzungen für Slack-Migrationen.

{% tabs %}
{% tab title="Leistungsvergleichsanalyse nach Migrations-Implementierungsmethode" %}

| 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 an historischen Daten*</sub>
{% endtab %}
{% endtabs %}

Migrationsjobs stoßen auf zwei grundlegende Engpässe, die sich direkt auf die Implementierungszeitpläne und die Ressourcenplanung auswirken. Einschränkungen bei der Verarbeitung der Dateiübertragung beeinflussen sowohl Import- als auch API-basierte Migrationsmethoden und führen zu Leistungsengpässen, die während der Bereitstellungsplanung eine angemessene Bandbreitenzuweisung und Strategien zur Übertragungsoptimierung erfordern. API-basierte Migrationsjobs sehen sich aufgrund der nativen API-Ratenbegrenzungsmechanismen von Slack zusätzlichen Leistungsbeschränkungen gegenüber. Diese Einschränkungen wirken sich nicht auf Importmigrationen aus, beeinträchtigen jedoch API-basierte Implementierungen erheblich und erfordern längere Verarbeitungsfenster sowie eine sorgfältige Job-Planung, um den Durchsatz zu optimieren und gleichzeitig die Einhaltung der Plattformgrenzen zu gewährleisten.

Während Ihr Slack-Arbeitsplatz Hunderte oder Tausende von Kanälen enthalten kann, folgt die Aktivitätsverteilung in den Kanälen vorhersehbaren Mustern, die sich direkt auf die Migrationsleistung und die Anforderungen an die Ressourcenzuweisung auswirken. Kanäle mit hoher Aktivität und umfangreichen Nachrichtenverläufen, Dateianhängen und Benutzerinteraktionen erfordern die oben aufgeführten vollständigen Benchmark-Verarbeitungszeiten. Die Mehrheit der Arbeitsplatzkanäle enthält jedoch in der Regel nur geringe 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**

Das Zoom App Marketplace erfordert die folgenden Administratorberechtigungen und Berechtigungsbereiche innerhalb des Zoom-Tenants:

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

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

* `Chat_Nachricht:write:Administrator`
* `imchat:bot`
* `Chat_Kanal:schreiben:Administrator`
* `Benutzer:schreiben:Administrator`

Zoom XMPP enthält ein Feld, das die Slack-Nachrichten-ID für Authentizität und historische Nachverfolgung enthält.

Die von Zoom erstellte 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 eine Verbindung mit Zoom herzustellen und den Autorisierungs-Token für die Datenmigration bereitzustellen. Benutzer müssen die Migration privater Unterhaltungen autorisieren (DMs, Gruppenchats und private Kanäle).

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

* `files:read`
* `channels:history`
* `channels:read`
* `Gruppen:Verlauf`
* `Gruppen:lesen`
* `Direktnachrichten:Verlauf`
* `Direktnachrichten:lesen`
* `Mehrpersonen-Direktnachrichten:Verlauf`
* `Mehrpersonen-Direktnachrichten:lesen`
* `Pins:lesen`
* `Sterne:lesen`
* `Benutzer:lesen`
* `Benutzer:lesen.E-Mail`

#### <mark style="color:blau;">Migrationsüberlegungen</mark> <a href="#id-2upmrqx4xrqh" id="id-2upmrqx4xrqh"></a>

Wenn Sie im Voraus eine Migrationsstrategie in Betracht ziehen, sparen Sie Aufwand und stellen einen reibungslosen Übergang zwischen Plattformen sicher. Als grobes Beispiel bietet Zoom die folgende Strategieübersicht an:

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 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 einem Maximum von 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, 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 an Kanal- als auch an Chatnamen an. Zum Beispiel:

* Ursprünglicher Slack-Kanal:
  * **#engineering** (mit einem Arbeitsplatz „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 es einfacher machen, Inhalte zu organisieren und darauf zuzugreifen.

**Konsolidierung von Chat-Daten**

Arbeitsbereiche mit mehr als 100 Benutzern können Zehntausende private 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 ihre Slack-Aufbewahrungsfrist so aktualisieren, dass 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 kü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 aktive Daten zu replizieren und den Rest zu archivieren**. Die meisten Benutzer müssen selten über ein einziges Jahr hinaus suchen, um ihre Rolle auszuüben und zu kommunizieren. Zoom empfiehlt, Migrationsaufträge für erfolgreiche Datenmigrationen in kleineren Chargen von drei bis sechs Monaten zu erstellen.
{% endhint %}

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

**Aufbewahrung des Chat-Verlaufs**

Beim Migrieren von Slack zu Zoom gibt es mehrere auf die Aufbewahrung bezogene Überlegungen, da Slack vollständig cloud-basiert ist, während Zoom granularere Aufbewahrungsoptionen bietet:

* Zoom bietet sowohl lokale Gerät- als auch Cloud-Speicher. [Lokaler Geräte-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 eine Aufbewahrungsfrist 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 DMs oder Gruppen-Chats festlegen und eine weitere 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 Chatverlaufs zu erfahren.

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

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

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

* Stellen Sie sicher, dass Benutzer Konten bei 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 Berechtigungen für beide Plattformen (Slack und Zoom Chat) haben, 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, damit Daten von Slack nach Zoom Chat ausgeführt und verschoben werden. Hinweis: Dieser Prozess erfordert mindestens 2 Aufträge, da mindestens 1 Auftrag private Unterhaltungen und 1 Auftrag öffentliche Kanäle verschiebt.
* Administratoren sollten nicht benötigte Slack-Daten, die sie nicht nach Chat migrieren möchten, archivieren oder löschen, um Migrationen zu beschleunigen.
* Wenn Sie API-Migrationsaufträge zur Migration privater Daten verwenden, stellen Sie sicher, dass den Benutzern bewusst ist, wann und wie sie Slack autorisieren, ihre Daten in den Chat zu verschieben.
* Wenn Sie planen, Import-Migrationsaufträge zu verwenden, 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 gegenüber dem 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-Migration-App vorbereiten und zu ihrem Zoom-Konto hinzufügen.
3. Der Administrator, der die Migration durchführt, muss über die entsprechenden Berechtigungen für beide Plattformen sowie ü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 OAuth Authentifizierung durchzuführen.
5. Administratoren verwenden die Zoom Chat-Migrations-App, um Migrationsaufträge zu Konfigurieren, um Daten von Slack zu Zoom Chat zu verschieben. Dies erfordert mindestens 2 Aufträge – einen für private Unterhaltungen und einen für öffentliche Kanäle.

Beim Migrieren befolgen Sie diese empfohlenen Schritte:

1. Daten von einem Kanal migrieren, indem du den Select Public Channels Conversation Type auswählst und einen bestimmten Kanal auswählst. Wähle eine Woche an Daten aus einigen deiner ä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, 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 Jobs mit größeren Zeiträumen aus, anstatt mehr Jobs mit kleineren Zeiträumen. Jeder Job enthält dieselbe Anzahl an zu migrierenden Schritten.
4. (optional) Wiederholen Sie diese Schritte für private Job-Migrationen.

Nach der Datenmigration werden Ihre Daten wie folgt angezeigt:

* Öffentliche/private Kanal- und Gruppen-Chatnamen 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-Nachrichtensenders gesendet angezeigt
* Systemnachrichten werden migriert (z. B. „@Einige Benutzer hat den Kanal beigetreten“)
* Alle Nachrichten werden unabhängig von ihrem Status in Slack als gelesen migriert
* Nach Abschluss wird für jeden öffentlichen und privaten Kanal eine Mitteilung zur Abschluss der Migration gesendet, die als „Nachricht wird von Chat Migration App gesendet, Tag Datum Uhrzeit“ erscheint

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

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

{% 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 sind.
{% endhint %}

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

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

Um die App zu installieren:

1. Melden Sie sich im 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" %}
Kontoadministratoren müssen dem Slack-Arbeitsplatzkonto 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 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 Administrator-Rolle 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 verfügen [um Unterhaltungen zu migrieren. Er kann kein benutzerdefinierter Administratortyp sein. Mehr erfahren über](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060684#h_01FCBKK69SJNA90M1J07SSJ1YB) das Identifizieren von Kontotypen, Rollen und Lizenzen [Rollenverwaltung](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060684) und [auf der Zoom-Support-Website.](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064983) Verbinden Sie Ihren Slack-Arbeitsplatz für API-Migrationsaufträge
{% endhint %}

#### <mark style="color:blau;">Wenn Sie die File-Import-Methode nicht verwenden, helfen Ihnen diese Anweisungen beim Verbinden für API-Migrationen.</mark> <a href="#xjbm4ds0xh3" id="xjbm4ds0xh3"></a>

Um einen Arbeitsplatz zu verbinden:

Öffnen Sie die Chat Migration App in Zoom.

1. Verbindung erstellen > Bei Slack anmelden
2. Klicken Sie auf **und autorisieren.** Bestätigen Sie die Arbeitsplatzverbindung im Zoom Dashboard.
3. Führen Sie die Aufgabe zur Benutzersynchronisierung aus

#### <mark style="color:blau;">Die Benutzersynchronisierungsaufgabe ruft alle vollständigen, aktiven Mitglieder in Ihrem Slack-Arbeitsplatz ab und erstellt eine 1:1-Zuordnung zu ihrem entsprechenden Zoom-Konto mithilfe ihrer E-Mail-Adresse.</mark> <a href="#qo97g1d6dweq" id="qo97g1d6dweq"></a>

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, z. B. einem persönlichen Konto, gefunden wird, wird der Benutzer einem „Dummy-Benutzer“-Profil zugeordnet. In Ihrem Zoom-Konto wird dieser Benutzer als

TeamChatMigration AppUser **benannt und wird präsent sein, um sicherzustellen, dass alle Nachrichten-Daten für Ihren Arbeitsplatz migriert werden.** Löschen Sie den

{% hint style="warning" %}
Benutzer. **benannt und wird präsent sein, um sicherzustellen, dass alle Nachrichten-Daten für Ihren Arbeitsplatz migriert werden.** Ausführen von Migrationsaufträgen
{% endhint %}

### Der folgende Abschnitt hilft Ihnen dabei, die für die Migration erforderlichen Aufträge zu starten. <a href="#jpygqaz4w6nu" id="jpygqaz4w6nu"></a>

Erstellen eines Import-Migrationsauftrags

#### <mark style="color:blau;">So erstellen Sie einen neuen Migrationsauftrag:</mark> <a href="#c2p4z4dmsd2d" id="c2p4z4dmsd2d"></a>

Dateien hochladen

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 zu Zoom hochgeladen wurde.
   1. Hinweis: Bitte verlassen Sie die Seite nicht und aktualisieren Sie sie nicht, da dies den Datei-Upload unterbrechen und der Auftrag im Status „Uploading“ hängen bleiben würde. Falls dies passiert, können Sie den Auftrag „Uploading“ löschen und diesen Vorgang neu starten
3. Sobald der anfängliche Datei-Upload abgeschlossen ist, wird ein **Fenster mit Migrationsdetails** eingeblendet, während die Migration 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 bereit ist, ausgeführt zu werden.
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>

Dateien hochladen

1. Klicken Sie auf **Neuer Migrationsauftrag** und wählen Sie den Slack-Arbeitsplatz aus.
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. Sobald Sie Ihren Datenumfang und den Zeitraum ausgewählt haben und die Autorisierung von Ihren Benutzern eingeholt haben, auswählen Sie **Ausführen** um den Migrationsauftrag zu starten.

{% hint style="warning" %}
Umgang mit 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.
* Admins können nachverfolgen, welche Benutzer genehmigt haben bzw. nicht genehmigt haben. Für die Migration privater 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 eine optimale Migration empfiehlt es sich, die Autorisierung von etwa 60-70 % Ihrer Benutzer einzuholen.
  {% 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 Folgendes 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 **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 Probleme, die während der Migration auftreten können:

{% tabs %}
{% tab title="Migration-Fehlerbehebung" %}

| 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 Migration App wird automatisch erneut versuchen                                                                  |
| <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>" %}

### Migration-Postmortem <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>Bei Zoom Chat anmelden und überprüfen, 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>Autorisierungsanfragen erneut an Benutzer senden, die den Zugriff auf private Daten nicht genehmigt haben.</li><li>Migrationsaufträge auf Fehler überprüfen und fehlgeschlagene Aufträge erneut versuchen.</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 von Zoom abzumelden und erneut 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 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 zusätzliche 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 Webanruf** abrufen und beide **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>Überprüfen Sie, ob alle Einstellungen für die Dateifreigabe auf allen Ebenen aktiviert sind, und dokumentieren Sie alle Dateieinschränkungen</li><li>Überprüfen Sie, dass "Benutzern erlauben, öffentliche + private Kanäle zu erstellen" auf allen Ebenen aktiviert ist</li></ul>                                                                                                                                                                  |
| **Zoom-Benutzerprobleme**                                                                   | <ul><li>Überprüfen Sie den Administratorstatus des Benutzers</li><li>Bestätigen Sie, dass die E-Mail des Tool-Bedieners zwischen Zoom und Slack übereinstimmt</li><li>Überprüfen Sie die übereinstimmenden E-Mail-Adressen für die zu migrierenden Benutzer in Zoom und Slack</li></ul>                                                                                                                                                                                                                                                              |
| **Probleme mit dem Migrationsauftrag**                                                      | <ul><li>Prüfen Sie den Status des Auftragsabschlusses (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 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 12:00 Uhr GMT (PST +7))</li><li>Überprüfen Sie die korrekte Kanal-Erstellung</li><li>Stellen Sie sicher, dass sich der Benutzer nach der Migration vom Client abgemeldet und wieder angemeldet hat</li><li>Bestätigen Sie die korrekte Erstellung der migrierten Benutzer in Zoom</li><li>Überprüfen Sie die Sichtbarkeit von Nachrichten/Unterhaltungen im Chat-Verlauf-Administrator-Portal</li></ul> |
| **Wenn die Migration fehlgeschlagen ist**                                                   | <ul><li>Dokumentieren Sie die genaue Fehlermeldung</li><li>Bei Fehlern bei der Dateimigration zeichnen Sie den Namen der problematischen Datei auf</li><li>Dokumentieren Sie die vom Benutzer nach dem Fehler durchgeführten Aktionen (erneuter Auftragsversuch, Erstellung eines neuen Auftrags 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 dynamically by asking a question.

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

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

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