Начало совместного использования с мощными расширениями обмена сообщениямиStart sharing with powerful messaging extensions

Расширения обмена сообщениями предназначены для совместного использования контента с действиями.Messaging extensions are designed for sharing actionable content. Эта функция представляет наибольшее рентабельность инвестиций в нашем стеке.This feature represents the highest return on investment (ROI) in our stack. Расширения обмена сообщениями работают в чате и каналах, поддерживают несколько конечных точек запросов, позволяют создавать новые сущности и работать со ссылками унфурлинг для создания пользовательских предварительных просмотров ссылок.Messaging extensions work in chat and channels, support multiple query endpoints, enable the creation of new entities, and work with link unfurling to create custom link previews. Проблема состоит в том, что хотя функция является мощной и чрезвычайно полезна, она легко обнаруживается.The challenge is that while the feature is powerful and incredibly useful, it's not easily discoverable. Это руководство поможет вам создать расширения для обмена сообщениями, которые были найдены и использованы большим количеством пользователей.This guide will help you create messaging extensions that are readily found and utilized by more users.

Рекомендации по дизайнуDesign guidelines

Отображение контента в качестве типа пользователяShow content as a user type

Расширения обмена сообщениями представляют собой уникальный способ использования поиска по ключевым словам для поиска интерактивного контента, доступного для одного или нескольких пользователей.Messaging extensions present a unique way to use keyword searches to find actionable content that can be shared with one or more users. Это предпочитаемое взаимодействие позволяет пользователям вводить поисковые термины с отложенным автоматическим запросом в качестве типа пользователя.This preferred interaction allows users to enter search terms with a delayed auto query as the user type. Эта модель является хорошим заданием по моделированию предлагаемых результатов и требует от пользователей ввода минимальных символов.This model does a good job of simulating suggested results and requires users to type minimal characters.

Совет

Возможно, но не желательно, чтобы пользователи выделять enter или search перед отправкой запросов.It's possible, but not desirable, to require users to select enter or search before sending queries. При снижении нагрузки на внутреннюю службу эта модель не является нормой и может запутать пользователей.While there is less stress on the backend service, this model is not the norm and may confuse users.

Рассмотрите запросы с нулевым срокомConsider zero-term queries

Запросы с нулевым сроком действия напрямую инициируются действиями пользователя, а не записываются в поле поиска терминами пользователя.Zero-term queries are directly triggered by user action, rather than by the user writing terms in a search box. Все расширения обмена сообщениями могут отвлекать от нулевых терминов, обычно в зависимости от того, что пользователь последним видел в службе.All messaging extensions benefit from zero-term queries, usually based on what the user last saw on the service. Преимущество этого подхода заключается в том, что вероятность того, что вы не хотите поделиться тем, что пользователь последний раз видел, очень высок.The advantage is that the likelihood of wanting to share something the user last saw is quite high. Другие нулевые термины могут быть основаны на службе.Other zero-term queries might be based on the service. Например, news могут отображаться недавно опубликованные расширения новостей из последних и предстоящих событий.For instance, news might show recently posted news extensions from recent and upcoming events.

<img width="450px" title="Вкладка "Новая конфигурация"" src="../../assets/images/messaging-extension/zero-term-query.png" />

Один из наиболее распространенных способов совместного использования контента в Teams — это задача, с которой вы работали, или видеоролик, который вы нашли веселое решение.One of the most common ways to share content in Teams is through a hyperlink, whether it is a task you've been working on or a video that you found funny. Когда пользователь совместно использует ссылку в Teams, отображается предварительный просмотр, в том числе изображение, название или описание.When a user shares a link in Teams, a preview including image, title or description is displayed. С помощью Link унфурлинг теперь можно настраивать предварительные обзоры.With link unfurling you can now customize these previews. Кроме того, пользователям будет предложено установить приложение, когда они решили использовать предварительный просмотр.Users will also be prompted to install your app after they decide to use your preview. Добавление функций ссылок унфурлинг в приложение может значительно увеличить возможности обнаружения приложений.Adding link unfurling functionality to your app can greatly increase your app discoverability.

Выделение расширения для обмена сообщениямиHighlight your messaging extension

Расширения обмена сообщениями не всегда просты в поиске.Messaging extensions are not always easy to find. Включите снимки экрана приложений на странице сведений о приложении и в справочной документации, чтобы использовать расширение системы обмена сообщениями.Include app screenshots in the app detail page and your help documentation to feature your messaging extension. Вы также можете добавить документацию для расширения обмена сообщениями в пошаговом руководстве, чтобы выделить все приложение за пределами ленты.You can also include how-to documentation for your messaging extension in bot tours to highlight the entire app beyond the bot interactions.

Добавление действий на карточкуAdd actions on card

Не просто отображать текст для пользователей.Don't just display text to users. С ними можно взаимодействовать и выполнять следующее действие.Have something they can interact with and perform the next action. Например, приложение "места" не просто вставляет карту на карточку, но также содержит кнопку, при выборе которой будут отображаться указания по расположению.For example, the Places app doesn't just insert a map on the card, but also has a button that, when selected, will show directions to the location. После получения карты пользователи могут выполнять дополнительные задачи.Users can perform more tasks after obtaining the card.

<img width="450px" title="Вкладка "Новая конфигурация"" src="../../assets/images/messaging-extension/action-on-card.png" />

Сохранение пользователей в контексте приложенияKeep users in the app context

Если карта недостаточна и вам нужно получить ссылку для получения дополнительных сведений, рассмотрите возможность открытия вкладки вместо открытия браузера для улучшения взаимодействия с пользователем.If a card is not enough and you need to provide a link for more information, consider opening a tab instead of opening a browser for a better user experience. Ознакомьтесь со статьей расширение приложения Teams с помощью настраиваемой вкладкиSee Extend your Teams app with a custom tab