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

Важно!

Примеры кода в этом разделе основаны на версии 4.6 и более поздних версиях пакета SDK Bot Framework. Если вы ищете документацию по более ранним версиям, см. раздел пакет SDK для ботов версии 3 в папке Устаревшие пакеты SDK документации.

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

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

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

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

Следующий этап

См. также