Основы разговора

  • Статья

Важно!

Примеры кода в этом разделе основаны на версии 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 для реагирования на команды чата, отображая пользовательский интерфейс с помощью адаптивной карточки.

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

Добавление проверки подлинности единого входа в боты беседы

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

Следующее действие

Сообщения в беседах с ботами

См. также