Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
En este artículo se describe cómo importar mensajes en un chat o canal de Microsoft Teams existente durante una sesión de migración mediante Microsoft Graph. La importación de mensajes está pensada para escenarios de migración y requiere que el chat o canal de destino se coloque en modo de migración antes de poder importar contenido.
Cuándo usar la importación de mensajes
Use la importación de mensajes cuando necesite:
- Migrar mensajes históricos a un canal o chat de Teams existente.
- Conservar la atribución del autor original (de quién es el mensaje).
- Opcionalmente, conserve (o establezca) una marca de tiempo histórica para cada mensaje.
Requisitos
Para usar la API de mensajería de Teams para importar mensajes, deben cumplirse las condiciones siguientes:
- Contexto de solo aplicación (aplicación): la solicitud debe realizarse mediante permisos de aplicación.
- Permiso necesario: se debe conceder el permiso de aplicación a la aplicación que realiza la
Teamwork.Migrate.Allllamada. - El modo de migración debe estar habilitado en el destino:
- Para habilitar el modo de migración en un canal, llame a channel: startMigration.
- Para habilitar el modo de migración en un chat, llame a chat: startMigration.
- Se requiere la atribución de autor: establezca la propiedad from para atribuir el mensaje importado a un usuario que pertenezca al mismo inquilino que la aplicación autenticada.
- Reglas de marca de tiempo opcionales (si especifica createdDateTime): puede establecer una marca de tiempo personalizada para el mensaje importado, pero debe cumplir las siguientes restricciones:
- El valor debe ser posterior acreatedDateTime del chat o canal de destino.
- El valor no debe ser en el futuro.
- El valor debe ser único hasta el milisegundo dentro del chat o canal de destino. Si existe un mensaje con el mismo createdDateTime , se produce un error en la solicitud;
409 Conflictajuste el valor y vuelva a intentarlo.
Nota:
- Solo la aplicación que llamó a startMigration en el canal de destino o startMigration en el chat de destino puede importar mensajes en él. Ninguna otra aplicación puede solicitar esta API en el canal o chat hasta que la aplicación propietaria complete la migración llamando al canal: completeMigration o chat: completeMigration.
- Es posible que algunos mensajes importados no estén visibles en el cliente de Teams hasta que se complete la migración llamando a completeMigration en el canal de destino o a completeMigration en el chat de destino.
Solución de problemas
409 Conflicto al importar un mensaje
CreatedDateTime debe ser único en milisegundos dentro del chat o canal de destino. Si existe un mensaje con el mismo createdDateTime , se produce un error en la solicitud con 409 Conflict. Ajuste createdDateTime y vuelva a intentar la solicitud.