Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Este artigo descreve como importar mensagens para um chat ou canal existente do Microsoft Teams durante uma sessão de migração usando o Microsoft Graph. A importação de mensagens destina-se a cenários de migração e requer que o chat ou canal de destino seja colocado no modo de migração antes de importar o conteúdo.
Quando usar a importação de mensagens
Use a importação de mensagens quando precisar:
- Migre mensagens históricas para um chat ou canal existente do Teams.
- Preserve a atribuição do autor original (de quem vem a mensagem).
- Opcionalmente, preserve (ou defina) um carimbo de data/hora histórico para cada mensagem.
Requisitos
Para usar a API de mensagens do Teams para importar mensagens, as seguintes condições devem ser atendidas:
- Contexto somente aplicativo (aplicativo): a solicitação deve ser feita usando permissões de aplicativo.
- Permissão necessária: o aplicativo de chamada deve receber a permissão do
Teamwork.Migrate.Allaplicativo. - O modo de migração deve ser habilitado no:
- Para habilitar o modo de migração em um canal, chame o canal: startMigration.
- Para habilitar o modo de migração em um chat, chame chat: startMigration.
- A atribuição do autor é necessária: defina a propriedade from para atribuir a mensagem importada a um usuário que pertence ao mesmo locatário que o aplicativo autenticado.
- Regras opcionais de carimbo de data/hora (se você especificar createdDateTime): você pode definir um carimbo de data/hora personalizado para a mensagem importada, mas ele deve atender às seguintes restrições:
- O valor deve ser posterior a createdDateTime do chat ou canal de destino.
- O valor não pode estar no futuro.
- O valor deve ser exclusivo até um milissegundo no chat ou canal de destino. Se existir uma mensagem com o mesmo createdDateTime , a solicitação falhará com
409 Conflict; ajuste o valor e tente novamente.
Observação
- Somente o aplicativo que chamou startMigration no canal de destino ou startMigration no chat de destino pode importar mensagens para ele. Nenhum outro aplicativo pode solicitar essa API no canal ou chat até que o aplicativo proprietário conclua a migração chamando channel: completeMigration ou chat: completeMigration.
- Algumas mensagens importadas podem não estar visíveis no cliente do Teams até que a migração seja concluída chamando completeMigration no canal de destino ou completeMigration no chat de destino.
Solução de problemas
409 Conflito ao importar uma mensagem
O createdDateTime deve ser exclusivo até um milissegundo no chat ou canal de destino. Se existir uma mensagem com o mesmo createdDateTime , a solicitação falhará com 409 Conflict. Ajuste o createdDateTime e repita a solicitação.