Предоставление общего доступа к отзыву:
Мы хотели бы ваши отзывы о документации разработчика Microsoft Teams. Ответьте на наш короткий трехпрошенный опрос.Пройти опрос
Этот браузер больше не поддерживается.
Выполните обновление до Microsoft Edge, чтобы воспользоваться новейшими функциями, обновлениями для системы безопасности и технической поддержкой.
Выбор расположений, из которых будет вызываться команда действия
Сначала необходимо определить расположение, из которого должна быть вызвана команда действия. При указании свойства в манифесте context приложения (ранее называемом манифестом приложения Teams) можно вызвать команду из одного или нескольких из следующих расположений:
Область создания сообщения: кнопки в нижней части области создания сообщения.
Контекст команд = compose
Командное поле: с помощью / в командном окне. Например, /your-app-name. Если вы используете классическую команду Teams, команда action вызывается в командном @mentioning окне. Например, @your-app-name.
Контекст команд = commandBox
Примечание
Если расширение сообщений вызывается из командного окна, вы не сможете ответить сообщением бота, вставленным непосредственно в беседу.
Сообщение: непосредственно из существующего сообщения через меню переполнения ... сообщения.
Контекст команд = message
Примечание
Начальный вызов бота включает объект JSON, содержащий сообщение, из которого он был вызван. Вы можете обработать сообщение перед представлением диалогового окна.
Когда пользователь выбирает многоточие ..., отображается меню переполнения. Однако по умолчанию действия с сообщениями для приложений, созданных вами для вашей организации или сторонних приложений, не отображаются. Когда пользователь выберет Дополнительные действия, он сможет просмотреть действия сообщения и выбрать необходимый параметр. Соответствующее действие сообщения отображается в меню переполнения. В меню переполнения отображаются три последних действия сообщений. Вы не можете закрепить отображаемое действие сообщения.
На следующем рисунке показаны расположения, из которых вызывается команда действия:
Выбор способа создания диалогового окна
Помимо выбора места вызова команды, необходимо также выбрать способ заполнения формы в диалоговом окне для пользователей. У вас есть три варианта создания формы, отображаемой в диалоговом окне:
Статический список параметров: это самый простой метод. Вы можете определить список параметров в манифесте приложения, отображаемом клиентом Teams, но не можете управлять форматированием в этом случае.
Адаптивная карточка. Вы можете использовать адаптивную карточку, которая обеспечивает больший контроль над пользовательским интерфейсом, но по-прежнему ограничивает доступные элементы управления и параметры форматирования.
Внедренное веб-представление. Вы можете внедрить пользовательское веб-представление в диалоговое окно, чтобы иметь полный контроль над пользовательским интерфейсом и элементами управления.
Если вы хотите создать диалоговое окно со статическим списком параметров и когда пользователь отправляет его, вызывается расширение сообщения. При использовании внедренного веб-представления или адаптивной карточки расширение сообщения должно обработать исходное событие вызова от пользователя, создать диалоговое окно и вернуть его клиенту.
Выбор способа, которым будет отправлено окончательное сообщение
В большинстве случаев команда действия приводит к вставке карточки в окно создания сообщения. Пользователь может отправить ее в канал или чат. В этом случае сообщение поступает от пользователя, и бот не может изменить или обновить карточку дальше.
Если расширение для сообщений вызывается из поля создания или непосредственно из сообщения, веб-служба может вставить окончательный ответ непосредственно в канал или чат. В этом случае адаптивная карточка поступает от бота, бот обновляет ее и при необходимости отвечает потоку беседы. Необходимо добавить объект в bot манифест приложения, используя тот же идентификатор и определив соответствующие области.
Создание команды действия с помощью портала разработчика
Команду действия можно создать с помощью набора средств Teams и портала разработчика для Teams.
Если вы получаете заявление об отказе от ответственности, которое считывает расширение API Message, уже используется пользователями. Вы хотите изменить тип расширения сообщений на bot?. Выберите Да, изменить.
Если у вас нет бота, выберите Существующий бот или, если у вас есть идентификатор бота, выберите Ввести идентификатор бота.
Если у вас нет идентификатора бота, выберите Создать бот, чтобы создать бот, и введите идентификатор созданного бота.
Выберите необходимые области.
В разделе Команда выберите + Добавить команду.
Откроется страница сведений о команде.
На странице Сведения о команде выберите Действие , а затем выберите тип параметра.
Выберите Действие в качестве типа команды и обновите следующие поля:
Идентификатор команды
Заголовок команды
Описание команды
Контекст, в котором работает команда
Имя параметра
Заголовок параметра
Описание параметра
Тип описания параметра
Выберите Добавить домен в разделе Ссылки предварительного просмотра.
Введите допустимый домен и нажмите кнопку Добавить.
Выберите Сохранить.
Добавление дополнительных параметров
В команде щелкните значок с многоточием (...) и выберите Изменить параметр.
Выберите Добавить параметр и обновите сведения о параметре.
Нажмите кнопку Сохранить.
Создается расширение сообщений о действиях на основе бота.
Фрагменты кода
В следующем коде приведен пример использования расширений сообщений на основе действий.
Источник этого содержимого можно найти на GitHub, где также можно создавать и просматривать проблемы и запросы на вытягивание. Дополнительные сведения см. в нашем руководстве для участников.
Отзыв о Platform Docs
Platform Docs — это проект с открытым исходным кодом. Выберите ссылку, чтобы оставить отзыв:
Learn how to build message extensions that allow users to interact with external services within their flow of work in Microsoft Teams and Microsoft 365 Copilot.
Продемонстрировать навыки для планирования, развертывания, настройки и управления Microsoft Teams, чтобы сосредоточиться на эффективной и эффективной совместной работе и взаимодействии в среде Microsoft 365.