Основы разговора
Важно!
Примеры кода в этом разделе основаны на версии 4.6 и более поздних версиях пакета SDK Bot Framework. Если вы ищете документацию по более ранним версиям, см. раздел пакет SDK для ботов версии 3 в папке Устаревшие пакеты SDK документации.
Беседа — это серия сообщений, отправляемых между ботом Microsoft Teams и одним или несколькими пользователями. В следующей таблице приведены три типа бесед, также называемых областями в Teams:
Тип беседы | Описание |
---|---|
channel |
Этот тип беседы виден всем участникам канала. |
personal |
Этот тип беседы включает беседы между ботами и одним пользователем. |
groupChat |
Этот тип беседы включает чат между ботом и двумя или более пользователями. Он также включает бота в чатах собраний. |
Бот ведет себя по-разному в зависимости от беседы, в которую он участвует:
Боты в беседах канала и группового чата требуют, чтобы пользователь @mention бота, чтобы вызвать его в канале.
Ботам в личной беседе не требуют @mention. Все сообщения, отправленные пользователем, направляются боту.
Боты могут получать все сообщения канала и чата в команде @mentioned , не используя разрешения на согласие для конкретного ресурса (RSC). RSC для всех сообщений чата доступен только в общедоступной предварительной версии разработчика для Teams. Дополнительные сведения см. в статье Получение всех сообщений беседы с помощью RSC.
Чтобы бот работал в определенной беседе или области, добавьте поддержку этой области в манифесте приложения.
Каждое сообщение в беседе бота Activity
является объектом типа messageType: message
. Когда пользователь отправляет сообщение, Teams отправляет его боту, и бот обрабатывает его. Кроме того, чтобы определить основные команды, на которые отвечает бот, можно добавить меню команд с раскрывающимся списком команд для бота. Боты в группе или канале получают сообщения только при упоминании @botname. Microsoft Teams отправляет вашему боту уведомления о событиях в тех областях, где этот бот активен. Эти события можно записать в коде и выполнить с ними действия.
Бот также может отправлять упреждающие сообщения пользователям. Упреждающее сообщение — это любое сообщение, отправленное ботом, которое не является ответом на запрос пользователя. Сообщения бота можно форматировать так, чтобы они включали в себя полнофункциональные карточки с интерактивными элементами, такими как кнопки, текст, изображения, звук, видео и т. д. Бот может динамически обновлять сообщения после их отправки вместо того, чтобы сообщения были статическими моментальными снимками данных. Сообщения также можно удалить с помощью метода Bot Framework DeleteActivity
. Исходящий запрос к боту отображает идентификатор беседы и идентификатор клиента в заголовках.
Бот уведомлений — это тип бота беседы, который отправляет уведомления в виде обычного текста или адаптивных карточек. Шаблон бота уведомлений создает приложение, которое отправляет сообщение в Teams с адаптивными карточками, активируются http-запросом после.
Командный бот — это тип бота для общения, который может отвечать на простые команды, отправленные в чатах с помощью адаптивных карточек. Вы можете создавать шаблоны ботов команд в Teams для реагирования на команды чата, отображая пользовательский интерфейс с помощью адаптивной карточки.
Бот рабочего процесса — это тип бота беседы, который взаимодействует с пользователями в адаптивной карточке. Вы можете настроить способ отправки ботом адаптивной карточки пользователям.
Добавление проверки подлинности единого входа в боты беседы
Вы можете добавить проверку подлинности единого входа в бот беседы, выполнив следующие действия.
Следующее действие
См. также
Platform Docs