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

Важно!

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

Беседа — это серия сообщений, отправленных между Microsoft Teams ботом и одним или более пользователями. В следующей таблице 3 типа бесед, которые также называются области в Teams:

Тип беседы Описание
channel Этот тип беседы виден всем участникам канала.
personal Этот тип беседы включает беседы между ботами и одним пользователем.
groupChat Этот тип беседы включает чат между ботом и двумя или более пользователями. Он также позволяет вашему боту в чатах собраний.

Бот ведет себя по-разному в зависимости от разговора, в который он вовлечен:

  • Боты в беседах канала и группового чата требуют, чтобы пользователь @упомянул бота, чтобы вызвать его в канале.

  • Боты в беседе один к одному не требуют @mention. Все сообщения, отправленные пользователем по маршрутам к боту.

Примечание

Ботам можно разрешить получать все сообщения канала в команде, не @mentioned с помощью разрешений, определенных для ресурсов( RSC). В настоящее время эта функция доступна только для предварительного просмотра общедоступных разработчиков. Дополнительные сведения см. в сообщении о приеме всех сообщений канала с помощью RSC.

Чтобы бот работал в определенной беседе или области, добавьте поддержку к этой области в манифесте приложения.

Каждое сообщение в беседе с ботом — Activity это объект типа messageType: message . Когда пользователь отправляет сообщение, Teams отправляет сообщение боту, а бот обрабатывает сообщение. Кроме того, чтобы определить основные команды, на которые отвечает бот, можно добавить меню команд со списком команд для бота. Боты в группе или канале получают сообщения только в том случае, если они упоминаются @botname. Teams отправляет уведомления боту для событий беседы, которые происходят в сферах, где ваш бот активен. Вы можете зафиксировать эти события в коде и принять меры по ним.

Бот также может отправлять пользователям упреждающие сообщения. Проактивное сообщение — это любое сообщение, отправленное ботом, которое не является ответом на запрос пользователя. Вы можете форматирование сообщений бота, чтобы включить богатые карты, которые включают интерактивные элементы, такие как кнопки, текст, изображения, аудио, видео и так далее. Бот может динамически обновлять сообщения после их отправки, а не иметь сообщения в виде статических снимков данных. Сообщения также можно удалить с помощью метода Bot DeleteActivity Framework.

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