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 com 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 poder importar conteúdo.
Quando utilizar a importação de mensagens
Utilize a importação de mensagens quando precisar de:
- Migrar mensagens históricas para um chat ou canal existente do Teams.
- Preserve a atribuição do autor original (de quem é a mensagem).
- Opcionalmente, preserve (ou defina) um carimbo de data/hora histórico para cada mensagem.
Requisitos
Para utilizar a API de mensagens do Teams para importar mensagens, as seguintes condições têm de ser cumpridas:
- Contexto apenas de aplicação (aplicação): o pedido tem de ser feito com permissões de aplicação.
- Permissão necessária: a aplicação de chamada tem de receber a permissão da aplicação
Teamwork.Migrate.All. - O modo de migração tem de estar ativado no destino:
- Para ativar o modo de migração num canal, chame o canal: startMigration.
- Para ativar o modo de migração num chat, ligue para chat: startMigration.
- A atribuição do autor é necessária: defina a propriedade from para atribuir a mensagem importada a um utilizador que pertença ao mesmo inquilino que a aplicação autenticada.
- Regras de carimbo de data/hora opcionais (se especificar createdDateTime): pode definir um carimbo de data/hora personalizado para a mensagem importada, mas tem de cumprir as seguintes restrições:
- O valor tem de ser posterior ao createdDateTime do chat ou canal de destino.
- O valor não pode estar no futuro.
- O valor tem de ser exclusivo até ao milissegundo no chat ou canal de destino. Se existir uma mensagem com o mesmo createdDateTime , o pedido falha com
409 Conflict; ajuste o valor e repita.
Observação
- Apenas a aplicação que chamou startMigration no canal de destino ou startMigration no chat de destino pode importar mensagens para o mesmo. Nenhuma outra aplicação pode pedir esta API no canal ou chat até que a aplicação proprietária conclua a migração ao chamar o canal: 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 ao chamar completeMigration no canal de destino ou completeMigration no chat de destino.
Solução de problemas
409 Conflito ao importar uma mensagem
O createdDateTime tem de ser exclusivo até ao milissegundo no chat ou canal de destino. Se existir uma mensagem com o mesmo createdDateTime , o pedido falha com 409 Conflict. Ajuste o createdDateTime e repita o pedido.