Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
In diesem Artikel wird beschrieben, wie Sie Nachrichten während einer Migrationssitzung mithilfe von Microsoft Graph in einen vorhandenen Microsoft Teams-Chat oder -Kanal importieren. Der Nachrichtenimport ist für Migrationsszenarien vorgesehen und erfordert, dass der Zielchat oder Kanal in den Migrationsmodus versetzt wird, bevor Sie Inhalte importieren können.
Wann sollte der Nachrichtenimport verwendet werden?
Verwenden Sie den Nachrichtenimport, wenn Sie Folgendes benötigen:
- Migrieren Sie verlaufsbezogene Nachrichten in einen vorhandenen Teams-Chat oder -Kanal.
- Behalten Sie die ursprüngliche Autorenzuordnung bei (von wem die Nachricht stammt).
- Optional können Sie einen historischen Zeitstempel für jede Nachricht beibehalten (oder festlegen).
Anforderungen
Um die Teams-Messaging-API zum Importieren von Nachrichten zu verwenden, müssen die folgenden Bedingungen erfüllt sein:
- Nur App-Kontext (Anwendung): Die Anforderung muss mithilfe von Anwendungsberechtigungen erfolgen.
- Erforderliche Berechtigung: Der aufrufenden App muss die
Teamwork.Migrate.AllAnwendungsberechtigung erteilt werden. - Der Migrationsmodus muss für das Ziel aktiviert sein:
- Um den Migrationsmodus für einen Kanal zu aktivieren, rufen Sie kanal auf: startMigration.
- Um den Migrationsmodus in einem Chat zu aktivieren, rufen Sie den Chat an: startMigration.
- Zuordnung des Autors erforderlich: Legen Sie die from-Eigenschaft fest, um die importierte Nachricht einem Benutzer zuzuordnen, der zu demselben Mandanten gehört wie die authentifizierte Anwendung.
- Optionale Zeitstempelregeln (wenn Sie createdDateTime angeben): Sie können einen benutzerdefinierten Zeitstempel für die importierte Nachricht festlegen, müssen jedoch die folgenden Einschränkungen erfüllen:
- Der Wert muss später alscreatedDateTime des Zielchats oder -kanals sein.
- Der Wert darf nicht in der Zukunft sein.
- Der Wert muss innerhalb des Zielchats oder -kanals bis zur Millisekunde eindeutig sein. Wenn eine Nachricht mit demselben createdDateTime vorhanden ist, schlägt die Anforderung mit
409 Conflictfehl. Passen Sie den Wert an, und wiederholen Sie den Vorgang.
Hinweis
- Nur die Anwendung, die startMigration im Zielkanal oder startMigration im Zielchat aufgerufen hat, kann Nachrichten importieren. Keine andere Anwendung kann diese API im Kanal oder Chat anfordern, bis die besitzende Anwendung die Migration durch Aufrufen des Kanals abgeschlossen hat: completeMigration oder chat: completeMigration.
- Einige importierte Nachrichten sind im Teams-Client möglicherweise erst sichtbar, wenn die Migration durch Aufrufen von completeMigration im Zielkanal oder completeMigration im Zielchat abgeschlossen ist.
Problembehandlung
409 Konflikt beim Importieren einer Nachricht
CreatedDateTime muss innerhalb des Zielchats oder -kanals bis zur Millisekunde eindeutig sein. Wenn eine Nachricht mit demselben createdDateTime vorhanden ist, schlägt die Anforderung mit 409 Conflictfehl. Passen Sie createdDateTime an, und wiederholen Sie die Anforderung.