Предоставление общего доступа к отзыву:
Мы хотели бы ваши отзывы о документации разработчика Microsoft Teams. Ответьте на наш короткий трехпрошенный опрос.Пройти опрос
Этот браузер больше не поддерживается.
Выполните обновление до Microsoft Edge, чтобы воспользоваться новейшими функциями, обновлениями для системы безопасности и технической поддержкой.
Вы можете создать прямую ссылку на чат Teams, например, чтобы начать новый чат, перейти в беседу на канале и получить доступ к файлу в канале.
Прямая ссылка для начала нового чата
Вы можете переходить к или создавать личные чаты между пользователями с помощью клиентской библиотеки JavaScript (TeamsJS) Microsoft Teams, указав набор участников. Если чат с указанными участниками не существует, пользователь будет перенаправлен в новый пустой чат.
Когда пользователь создает новый чат с помощью глубокой ссылки, Teams создает новый чат в состоянии черновика, пока пользователь не отправит первое сообщение. Вы также можете указать имя чата, если он еще не существует, а также текст, который следует вставить в поле создания пользователя. Считайте это ярлыком для пользователя, который выполняет вручную переход к чату или создает его, а затем создает сообщение.
В качестве примера использования, если вы извлеките данные профиля пользователя Microsoft 365 из бота в качестве карта, эта прямая ссылка может позволить пользователю приложения легко общаться с этим человеком.
Вы можете настроить глубокие ссылки для запуска нового чата одним из следующих двух способов:
Рекомендуется использовать типизированные API, но также можно использовать следующий формат для созданной вручную прямой ссылки, которую можно использовать в боте, соединителе или карточке расширения для сообщений:
Чтобы использовать эту прямую ссылку с ботом, укажите прямую ссылку в качестве целевого URL-адреса в кнопке карта или коснитесь действия с помощью openUrl типа действия.
Параметры запроса:
users: разделенный запятыми список идентификаторов пользователей, представляющих участников чата. Пользователь, выполняющий действие, всегда включен в качестве участника. Параметр User ID поддерживает Microsoft Entra UserPrincipalName, например только адрес электронной почты.
topicName: необязательный параметр для отображаемого имени чата, если в чате есть три или более пользователей. Если это поле не указано, отображаемое имя чата основывается на именах участников.
message: необязательное поле для текста сообщения, которое вы хотите вставить в поле создания текущего пользователя приложения, пока чат находится в состоянии черновика.
Настройка прямой ссылки для запуска чата с помощью библиотеки TeamsJS
В следующем примере показано, как открыть сообщение чата для группы участников с исходным сообщением. Вы можете настроить прямую ссылку на существующий или новый чат. Если чат уже существует, откроется прямая ссылка в этом чате.
JavaScript
if(chat.isSupported()) {
const chatPromise = chat.openGroupChat({ users: ["joe@contoso.com","bob@contoso.com"], topic: "Prep For Meeting Tomorrow", message: "Hi folks kicking off chat about our meeting tomorrow"});
chatPromise.
then((result) => {/*Successful operation*/}).
catch((error) => {/*Unsuccessful operation*/});
}
else { /* handle case where capability isn't supported */ }
Прямая ссылка для перехода к чату
Чтобы перейти к определенной беседе чата в Teams, используйте следующий формат глубокой ссылки:
chatId: идентификатор чата беседы. Поддерживаемый формат — chatId 19: xxx. Например, 19:253f5895-9a62-4362-8d38-43f0205c702c_f1b94dcf-0aa3-4989-bcdf-ef4a5ed00f86@unq.gbl.spaces.
Приложения могут считывать идентификатор чата через контекст приложения в Teams, входящие полезные данные боту или через API Microsoft Graph.
Примечание
Для общения с ботом в входящие полезные данные для бота содержат идентификатор беседы в формате a:xxx.
messageId: уникальный идентификатор каждого сообщения в чате. Когда бот публикует сообщение в чате messageId , возвращается . Вы также можете получить через messageIdAPI Microsoft Graph. Например, 1563480968434.
Вы можете начать беседу с ботом, используя предварительно заполненное сообщение через прямую ссылку. Вместо адреса электронной почты используйте идентификатор бота с 28: префиксом . Формат прямой ссылки:
Указанная прямая ссылка только загружает сообщение в текстовое поле чата бота и не отправляет сообщение автоматически. Чтобы отправить сообщение, необходимо либо нажать кнопку Отправить , либо нажать клавишу ВВОД.
Прямая ссылка для перехода к команде
Чтобы перейти к определенной команде, используйте следующий формат глубокой ссылки:
channelId: идентификатор канала беседы (в кодировке URL-адреса). Например, 19%3A9be3de4e70874c71a608dee9ba803ed3%40thread.tacv2.
channelName: имя канала команды (в кодировке URL-адреса). Например, My%20example%20channel.
groupId: идентификатор группы. Например, 72602e12-78ac-474c-99d6-f619710353a9.
tenantId: идентификатор клиента, например aaaabbbb-0000-cccc-1111-dddd2222eeee.
ngc: указывает канал следующего поколения. Для частных каналов необходимо задать значение true.
allowXTenantAccess: указывает канал, к которому можно получить доступ через границы клиента. Для общих каналов необходимо задать значение true.
Создание прямой ссылки на файл в канале
В боте, соединителе или расширении сообщений карта для настройки глубокой ссылки для подключения к файлу в канале можно использовать следующий формат глубокой ссылки:
fileId: уникальный идентификатор файла из Sharepoint Online, также известный как sourcedoc или sharepointIds.listItemUniqueId из ответа API Sharepoint Online driveItem . Например, 1FA202A5-3762-4F10-B550-C04F81F6ACBD.
tenantId: идентификатор клиента, например 0d9b645f-597b-41f0-a2a3-ef103fbd91bb.
fileType: поддерживаемый тип файла, например DOCX, PPTX, XLSX и PDF.
objectUrl: URL-адрес объекта файла. Представлено в формате https://{tenantName}.sharepoint.com/sites/{TeamName}/SharedDocuments/{ChannelName}/FileName.ext. Например, https://microsoft.sharepoint.com/teams/(filepath).
baseUrl: базовый URL-адрес файла. Представлено в формате https://{tenantName}.sharepoint.com/sites/{TeamName}. Например, https://microsoft.sharepoint.com/teams.
serviceName: имя службы, идентификатор приложения Например, teams.
threadId: threadID — это идентификатор команды, в которой хранится файл. Это необязательно и не может быть установлено для файлов, хранящихся в пользовательской папке OneDrive. Например, 19:<f8fbfc4d89e24ef5b3b8692538cebeb7@thread.skype>.
groupId: идентификатор группы файла. Например, ae063b79-5315-4ddb-ba70-27328ba6c31e.
Примечание
Вы можете увидеть threadId и groupId в URL-адресе канала.
В новом клиенте Teams формат глубокой ссылки, использующий objectURL для файла в канале, не поддерживается и используется objectUrl в формате deep link.
Следующий пример формата иллюстрирует глубокую ссылку на файлы:
В этом примере показано, как использовать прямую ссылку из чата бота на вкладку, используюющую идентификатор subentity. Здесь также показаны подробные ссылки для: — Переход к приложению — Переход к чату — Открытие диалогового окна профиля — Открытие диалогового окна планирования
Источник этого содержимого можно найти на GitHub, где также можно создавать и просматривать проблемы и запросы на вытягивание. Дополнительные сведения см. в нашем руководстве для участников.
Отзыв о Platform Docs
Platform Docs — это проект с открытым исходным кодом. Выберите ссылку, чтобы оставить отзыв:
Продемонстрировать навыки для планирования, развертывания, настройки и управления Microsoft Teams, чтобы сосредоточиться на эффективной и эффективной совместной работе и взаимодействии в среде Microsoft 365.