Рекомендации по использованию уведомлений веб-канала действий Microsoft Teams

  • Статья

В этой статье рассматриваются рекомендации по использованию уведомлений веб-канала действий Microsoft Teams в Microsoft Graph. Эти рекомендации применяются к:

  • Создание уведомлений о призыве к действию
  • Запрос ответов на уведомления
  • Создание уведомлений о внешних событиях

На следующем рисунке показан пример уведомления веб-канала действий в Teams:

Снимок экрана: приложение Teams с представлением уведомлений веб-канала действий.

При реализации уведомлений веб-канала действий учитывайте следующие моменты:

  • Всплывающие уведомления перенаправляют пользователей в веб-канал действий, а не в приложение. Чтобы увидеть другое действие, пользователи должны выбрать соответствующее уведомление в веб-канале действий.
  • Пользователи могут управлять параметрами уведомлений только после того, как выбранное приложение отправит уведомление.
  • Значок для каждого уведомления включен в манифест приложения. Microsoft Graph не поддерживает настройку значка.
  • Уведомления о приоритете не поддерживаются.

Улучшение взаимодействия с уведомлениями

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

  • Локализуйте содержимое в всплывающем уведомлении или веб-канале. Локализация происходит только в том случае, если содержимое приложения локализовано.
  • Укажите соответствующие заголовки и описания для типов действий. Используйте короткие заголовки, такие как @упоминание и объявления. Избегайте длинных заголовков, таких как действие пользователя, указанное в описании , и действие после создания.
  • Уведомления должны передавать важную информацию, которая имеет отношение к пользователю. Например, Диего назначил вам билет на продажу — это соответствующее сообщение; Джони ушел из команды продаж нет.
  • Избегайте отправки уведомлений, которые носят рекламный характер, например опробуйте новую функцию в приложении "Велосипед".
  • Избегайте повторяющихся уведомлений из сообщений бота и уведомлений веб-канала действий. Дополнительные сведения см. в разделе Выбор уведомлений веб-канала действий или сообщений платформы ботов.
  • Используйте раздел предварительного просмотра текста в уведомлениях. Предоставьте сведения, которые помогут пользователю определить важность уведомления и при необходимости принять меры.
  • Не добавляйте точку в конце заголовка уведомления, чтобы соответствовать всем остальным параметрам уведомлений в Teams.
  • Сделайте связь между уведомлением и его содержимым ясным для пользователя. Например, когда пользователь получает уведомление об утверждении отпуска, уведомление должно перенаправлять его в соответствующий раздел приложения. Если уведомление относится к удалению или удалению сущностей, таких как пользователи и задачи, направь получателя к содержимому и укажите необходимое действие.
  • Убедитесь, что интерфейс веб-канала является автономным. Например, все всплывающие окна и модалы должны оставаться в приложении.
  • Убедитесь, что приложение отправляет не более 20 уведомлений в минуту на пользователя. Уведомления будут автоматически регулироваться, если их число превышает 20.
  • Убедитесь, что время загрузки приложения не влияет на взаимодействие пользователей при переключении между уведомлениями в веб-канале.
  • Сообщите пользователю о периоде хранения уведомлений в веб-канале действий. В Microsoft Teams срок хранения составляет 30 дней.

    Примечание.

    Ограничение хранилища в 30 дней применяется ко всем уведомлениям. Это не зависит от уведомлений, отправляемых через API уведомлений веб-канала действий.

Выбор уведомлений веб-канала действий или сообщений платформы бота

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

Уведомления ленты новостей

Уведомления веб-канала действий отображаются в веб-канале действий Teams и могут содержать ссылки на различные расположения. Эти уведомления:

  • Разрешите пользователю принять меры или рассмотреть уведомление.
  • Подведите пользователя на вкладку в чате или канале, личном приложении, чате или сообщении канала.

API уведомлений веб-канала действий позволяет пользователям настраивать уведомления для каждого типа уведомлений из параметров уведомлений.

Если вы используете уведомления веб-канала действий, имейте в виду, что приложение может отправлять двойные уведомления, если оно отправляет уведомления бота в чаты или каналы, а также в веб-канал действий. Отправлять двойные уведомления только в том случае, если это требуется для вашего сценария.

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

Вы можете обновить существующее уведомление веб-канала действий вместо создания нового уведомления с помощью параметра chainId .

Сообщения платформы бота

Сообщения бота доставляются в виде сообщений чата или канала. Если пользователь включает уведомления чата или канала, активированные уведомления отправляются в виде сообщений чата или канала. Чтобы отправить сообщения бота, @упоминание имя пользователя, чтобы уведомление отображалось в веб-канале действий.

Это полезно, чтобы оповещение использовалось как сообщение чата или канала; например, сообщение, которое используется всеми участниками канала.

Связанные материалы