Что такое приложения Microsoft Teams?

  • 10 мин

Приложение, созданное на платформе Microsoft Teams, расширяет клиент Microsoft Teams (веб-сайт, мобильное устройство и настольный компьютер) с помощью размещенных веб-приложений и веб-служб. Платформа Teams предоставляет большой и гибкий набор точек расширения, конструкций пользовательского интерфейса и интерфейсов API, которые можно использовать при создании приложения. Ваше приложение может быть таким же простым, как внедрение существующего веб-сайт на вкладку для вашей команды или полнофункциональное, многогранное приложение, привлекающее пользователей через весь спектр клиента Teams. Вы можете интегрировать существующее приложение или создать новый интерфейс, полностью созданный для Teams.

С помощью платформы Microsoft Teams можно дополнить службы контекстной информацией, доступной из различных интерфейсов API Microsoft Teams, такой как информация о группе или канале, в котором установлено приложение, или сообщениях, из которых было запущено приложение. Вы можете создать приложения для отдельного пользователя, команды, всей организации или опубликовать приложение общедоступном магазине приложений, чтобы каждый мог его использовать.

Что составляет приложение Microsoft Teams?

Приложения, созданные на платформе Microsoft Teams, состоят из трех основных компонентов.

  • Клиент Microsoft Teams предоставляет точки расширений и элементы пользовательского интерфейса, которые приложение будет использовать для вовлечения пользователей.
  • Пакет приложения Teams — это пакет, установленный в Microsoft Teams. Он содержит небольшой значок, большой значок и JSON-файл манифеста. Файл манифеста содержит метаданные для вашего приложения (например, имя приложения, имя разработчика и т. д.), которые указывают на точки расширения, которые использует приложение (например, вкладки и расширения для сообщений), и указатели на веб-службы, которые обеспечивают работу приложения (например, идентификатор бота или URL-адрес вкладки).
  • Размещенные вами веб-службы предоставляют API и логику, которые обеспечивают ваше приложение.

Важно помнить, что платформа Microsoft Teams не является службой размещения. Веб-службы, поддерживающие приложение, должны быть размещены вами и доступны по протоколу HTTPS через Интернет.

Где можно расширить клиент Teams?

Существует несколько мест, где клиент Microsoft Teams можно расширить, чтобы пользователи могли взаимодействовать с приложением. В зависимости от сценария можно сосредоточиться на одной точке расширения (например, на личном боте для беседы) или объединить несколько точек расширения.

Teams, каналы и групповые чаты

Teams, каналы и групповые чаты позволяют нескольким пользователям работать совместно. Приложения, расширяющие контекст, становятся доступными для всех участников группы или беседы, обычно фокусируясь на включении других совместных рабочих процессов или разблокировке новых социальных взаимодействий. Ваше приложение получит доступ к API, что позволит ему получать информацию об участниках беседы, каналах в команде и метаданные о команде или беседе.

Их можно расширить с помощью:

  • Ботов бесед, звонков и медиаресурсов в сети, которые взаимодействуют с участниками беседы через чат и реагируют на события (например, путем добавления нового участника или переименования канала). Все беседы с ботом в этом контексте видны всем участникам канала или группы, поэтому вам потребуется убедиться, что беседа актуальна для всех.
  • Вкладки канала и группового чата , предоставляющие полноэкранный встроенный веб-интерфейс, настроенный для канала или группового чата, в котором он установлен. Все участники будут взаимодействовать в одном общем веб-приложении, поэтому использование одностраничного приложения без сохранения состояния является типичным.
  • Веб-перехватчики и соединители, позволяющие внешним службам публиковать сообщения в беседе. Вы можете использовать карточки и действия с карточками для создания сообщений с действиями. Веб-перехватчики предоставляют простой односторонний метод без проверки подлинности для отправки сообщений в беседе, в то время как соединители обеспечивают более надежную двустороннюю связь.

Персональные приложения

Персональные приложения — это часть приложения Teams, ориентированная на взаимодействие с одним пользователем. Этот интерфейс уникален для каждого отдельного пользователя. Эту часть приложения можно закрепить на левой панели навигации, что обеспечит доступ одним щелчком для пользователей.

Они могут содержать:

  • Боты бесед, бесед, звонков и медиаресурсов в сети, которые беседуют с пользователем один на один. Так как это частная беседа, если приложению необходимо вести множественную беседу с пользователем или предоставлять уведомление, относящееся только к одному пользователю, обычно лучше всего осуществлять это взаимодействие в персональном приложении.
  • Личные вкладки, обеспечивающие полноэкранный встроенный веб-интерфейс.

Сообщения

Сообщения — это сердце совместной работы в Teams. С помощью команды действия расширения для сообщений приложение может позволить пользователям вызывать API приложения из сообщения, отправляя содержимое сообщения вашему приложению для обработки или действия. Ваше приложение может ответить, представив пользователю форму (модуль задачи) для сбора дополнительных сведений, отправив ответ на исходное сообщение или отправив сообщение непосредственно пользователю.

Написание сообщений

Ваше приложение может помочь пользователям создавать более эффектные сообщения, позволяя им выполнять поиск или принимать меры во внешней системе и вставлять результаты в расширенном структурированном формате с кнопками действия.

Существует три способа, которыми ваше приложение может помочь пользователям создавать более качественные сообщения:

  • Расширение для сообщений — команды действий представляют пользователю модальную форму (модуль задачи), отправляют результаты формы в приложение, затем либо вставляют сообщение напрямую в беседу, либо создают часть сообщения, которое пользователь может изменять перед отправкой в беседу.
  • Расширение для сообщений — команды поиска, позволяющие быстро выполнять поиск во внешней системе, предварительно просматривать результаты этого поиска, а затем вставлять результат в беседу в качестве карточки.
  • Расширение для сообщений — развертывание ссылок позволяет приложению отслеживать интересующие вас веб-домены. При добавлении URL-адреса, содержащего этот домен, в поле сообщения, будет вызван API приложения, что позволит добавить в сообщение карточку с дополнительными сведениями об элементе, на который указывает ссылка.

Приложения для собраний

Собрания поддерживают совместную работу, взаимодействие, информированное общение и общие отзывы. Приложение для собраний может предоставлять пользовательский интерфейс для каждого этапа жизненного цикла собрания.

Жизненный цикл собрания включает в себя взаимодействие перед собранием, во время собрания и после собрания, в зависимости от статуса участника.

Элементы пользовательского интерфейса

Кроме того, платформа Microsoft Teams предоставляет гибкие элементы пользовательского интерфейса, которые могут быть доступны приложениям. Эти элементы позволяют создавать в клиенте Teams возможности, которые кажутся естественными для клиента Teams.

Карты и действия карт

Карточки — это контейнеры пользовательского интерфейса, определенные схематизированным JSON, которые могут содержать несколько свойств и вложений. Они могут содержать форматированный текст, мультимедиа, элементы управления (например, раскрывающиеся списки и переключатели) и кнопки, запускающие действия с карточками. Действия с карточками могут отправлять полезные данные в API приложения, открывать ссылку, запускать потоки проверки подлинности или отправлять сообщения в беседы. Платформа Microsoft Teams поддерживает несколько типов карточек, включая адаптивные карточки, карточки героев, карточки эскизов и многое другое. Их можно объединить в коллекции карточек и отобразить в виде списка или карусели.

Модули задач (диалоговые окна)

Модули задач позволяют создавать модальные всплывающие окна в приложении Teams. Внутри всплывающего окна можно запустить собственный код HTML или JavaScript, показать видео <iframe>, например YouTube или Microsoft Stream, или отобразить адаптивную карточку. Они особенно полезны для запуска и выполнения задач или отображения подробной информации, такой как видео или панели мониторинга Power BI. Всплывающие функции часто более естественны для пользователей, запускающих и завершающих задачи, по сравнению с вкладками или бесед с ботом.

Ваше приложение может создавать прямые URL-ссылки для навигации пользователя по приложению и клиенту Teams. Вы можете создать прямую ссылку для большинства объектов в Teams, а некоторые (например, новый запрос на собрание) позволяют предварительно заполнить сведения с помощью строк запроса в URL-адресе. Например, бот беседы может отправить сообщение в канал с прямой ссылкой на модуль задач, что приводит к отправке карточки пользователю в качестве индивидуального сообщения, которое, в свою очередь, содержит прямую ссылку для создания собрания с определенным пользователем в определенную дату или время. Используйте прямые ссылки для подключения к различным точкам расширения, доступным вашему приложения, сохраняя пользователя в правильном контексте.

Страницы веб-содержимого

Страница веб-содержимого — это веб-страница, которую можно встроить во вкладку или модуль задач. Чтобы веб-страницу можно было внедрять в клиент Microsoft Teams, она должна:

  • Размещение в конечной точке HTTPS.
  • Поддержка, внедренная <iframe> в клиент Teams.
  • Включив клиентский SDK JavaScript для Microsoft Teams и вызовите метод initialize() SDK при загрузке страницы.

Сводка

Таким образом, приложение Microsoft Teams — это коллекция веб-служб, размещенных извне в Microsoft Teams, которая использует преимущества точек расширения и элементов пользовательского интерфейса, доступных через платформу Microsoft Teams.