Подключение бота к каналамConnect a bot to channels

применимо к: Пакет SDK v4APPLIES TO: SDK v4

Канал — это подключение между приложениями связи и роботом.A channel is a connection between communication applications and a bot. Программа-робот, зарегистрированная в Azure, использует каналы для упрощения взаимодействия с пользователями.A bot, registered with Azure, uses channels to facilitate the communication with users.

Вы можете настроить робота для подключения к любому из стандартных каналов, например Алекса, Facebook Messenger и временного резерва.You can configure a bot to connect to any of the standard channels such as Alexa, Facebook Messenger, and Slack. Дополнительные сведения см. в статье Регистрация Azure Bot.For more information, see Azure Bot registration.

В дополнение к предоставленным каналам можно также подключить робот к коммуникационному приложению, используя прямую линию в качестве канала.In addition to the provided channels, you can also connect a bot to your communication application using Direct Line as the channel. Дополнительные сведения см. в разделе Подключение программы-робота к прямой линии.For more information, see Connect a bot to Direct Line.

Платформа Bot позволяет разрабатывать программы-роботы в независимом от канала виде путем нормализации сообщений, отправляемых программой-роботом в канал.The Bot Framework allows you to develop a bot in a channel-agnostic way by normalizing messages that the bot sends to a channel. В этом случае подразумевается следующее:This implies the following:

  • Преобразуйте сообщения из схемы "Bot Framework" в схему канала.Convert the messages from the Bot Framework schema into the channel's schema.
  • Если канал не поддерживает все аспекты схемы Bot Framework, служба соединителя Bot пытается преобразовать сообщение в формат, поддерживаемый каналом.If the channel does not support all aspects of the Bot Framework schema, the Bot Connector service tries to convert the message to a format that the channel does support. Например, если бот отправляет сообщение, содержащее карту с кнопками действий, в канал электронной почты, соединитель может отправить карту как изображение и включить действия как ссылки в текст сообщения.For example, if the bot sends a message that contains a card with action buttons to the email channel, the connector may send the card as an image and include the actions as links in the message's text.
  • Для большинства каналов необходимо предоставить сведения о конфигурации канала для запуска программы-робота на канале.For most channels, you must provide channel configuration information to run a bot on the channel. Для большинства каналов требуется, чтобы у робота была учетная запись в канале.Most channels require that a bot have an account on the channel. Другие, например Facebook Messenger, нуждаются в том, чтобы приложение-робот было зарегистрировано в канале.Others, like Facebook Messenger, require a bot to have an application registered with the channel also.

Чтобы настроить робот для подключения к каналу, выполните следующие действия.To configure a bot to connect to a channel, complete the following steps:

  1. Войдите на портал Azure.Sign in to the Azure Portal.

  2. Выберите бот, который требуется настроить.Select the bot that you want to configure.

  3. В левой области выберите каналы в разделе Управление программой- Bot.In the left pane, select Channels under Bot Management.

  4. На панели справа выберите значок канала, который нужно добавить в Bot.In the right pane, select the icon of the channel you want to add to your bot.

    Подключение к каналам

После настройки канала пользователи смогут использовать ваш бот.After you've configured the channel, users on that channel can start using your bot.

Подключение программы-робота к каналуConnect a bot to a channel

Шаги подключения для каждого канала различаются.The connection steps are different for each channel. Дополнительные сведения см. в соответствующей статье в таблице ниже.See the related article in the table below more information.

КаналChannel ОписаниеDescription
AlexaAlexa Обмен данными с пользователями через устройства Алекса, поддерживающие пользовательские навыки.Communicate with users through Alexa devices that support Custom Skills.
Direct LineDirect Line Интегрируйте робот в мобильное приложение, веб-страницу или другие приложения.Integrate a bot into a mobile app, web page, or other applications.
Электронная почта Office 365Office 365 email Разрешить роботам обмениваться данными с пользователями через электронную почту Office 365.Enable a bot to communicate with users via Office 365 email.
FacebookFacebook Подключите программу-робот к Facebook Messenger и к рабочей области Facebook, чтобы она могла взаимодействовать с пользователями на обеих платформах.Connect a bot to both Facebook Messenger and Facebook Workplace, so that it can communicate with users on both platforms.
KikKik Настройте робота для взаимодействия с пользователями через приложение KiK Messaging.Configure a bot to communicate with users through the Kik messaging app.
LINELINE Настройте робота для взаимодействия с пользователями через ЛИНЕЙное приложение.Configure a bot to communicate with users through the LINE app.
Microsoft TeamsMicrosoft Teams Настройка программы-робота для взаимодействия с пользователями через Microsoft Teams.Configure a bot to communicate with users through Microsoft Teams.
SkypeSkype Настройка робота для взаимодействия с пользователями через Skype.Configure a bot to communicate with users through Skype.
Skype для бизнесаSkype for Business Настройка робота для взаимодействия с пользователями через Skype для бизнеса.Configure a bot to communicate with users through Skype for Busines.
SlackSlack Настройте робота для взаимодействия с пользователями с помощью временного резерва.Configure a bot to communicate with users through Slack.
TelegramTelegram Настройте робота для взаимодействия с пользователями через Telegram.Configure a bot to communicate with users through Telegram.
Telephony (Телефония)Telephony Настройте робота для взаимодействия с пользователями через канал телефонии Bot Framework.Configure a bot to communicate with users through the Bot Framework Telephony channel.
TwilioTwilio Настройте робота для взаимодействия с пользователями через облачную платформу для обмена данными Twilio.Configure a bot to communicate with users through the Twilio cloud communication platform.
WeChatWeChat Настройте робота для взаимодействия с пользователями с помощью платформы WeChat.Configure a bot to communicate with users using the WeChat platform.
Веб-чатWeb Chat Автоматически настраивается при создании программы-робота с помощью службы платформы Bot.Automatically configured for you when you create a bot with the Bot Framework Service.
WebexWebex Настройте робота для взаимодействия с пользователями с помощью WebEx.Configure a bot to communicate with users using the Webex.
Дополнительные каналыAdditional channels Дополнительные каналы, доступные в виде адаптера с помощью предоставленных платформ через боткит и репозитории сообщества.Additional channels available as an adapter through provided platforms via Botkit and community repositories.

Версия преобразования схемы BotBot schema transformation version

Как описано выше, канал преобразует входящие сообщения из других служб в схему протоколов Bot Framework.As described above, a channel converts incoming messages from other services to the Bot Framework protocol schema. Аналогичным образом сообщения, отправленные с помощью программы-робота в другие службы, преобразуются из собственной схемы модели Bot в формат этих служб.Likewise, messages sent by the bot to other services are transformed from the Bot Framework native schema to the format of these services. Этот процесс называется преобразованием схемы.This process is called schema transformation. Служба платформы Bot поддерживает обратную совместимость протокола, чтобы избежать изменения поведения существующих программы-роботы.The Bot Framework Service maintains backward compatibility of the protocol in order to avoid changing behavior of the existing bots.

Иногда изменение в процессе преобразования схемы должно выполняться, что может привести к изменению поведения существующего программы-роботы.Occasionally, a change in the schema transformation process needs to take place that can, potentially, change the behavior of the existing bots. Примером такого изменения может быть любое исправление ошибки, если подмножество пользователей затратило зависимость от существующего (но ошибочного) поведения.An example of such a change could be any bug fix if a subset of the users have taken a dependency on the existing (however erroneous) behavior. Другим примером такого изменения могут быть обновления или улучшения в других службах, которые могут выиграть программы-роботы. Однако внедрение этих обновлений может привести к изменению существующего поведения.Another example of such a change would be updates or improvements in other services that would benefit bots; however adopting these updates can, potentially, change the existing behavior.

Контролируя версию преобразования схемы своих программы-роботы, разработчики-роботы могут контролировать, когда (если никогда) включить новое поведение.By controlling the schema transformation version of their bots, bot developers can control when (if ever) to enable new behavior. По умолчанию только что созданный программы-роботы получает последнюю версию преобразования схемы.By default, newly created bots get the most recent schema transformation version. Существующие программы-роботы можно обновить до последней версии, когда они будут готовы воспользоваться преимуществами усовершенствований, появившихся в этой версии.Existing bots can be upgraded to the newest version when they are ready to take advantage of the improvements introduced in this version. В любое время можно обновить или понизить уровень ленты.Any bot can be upgraded or downgraded at any time.

Версию преобразования схемы программы-робота можно изменить в области конфигурации :You can change your bot's schema transformation version in the Configuration pane:

Поле версии преобразования схемы в области конфигурации

Поддерживаемые версии преобразования схемыSupported schema transformation versions

  • Версия 1.3Version 1.3

    • Дата введена: Май 2021Date introduced: May 2021
    • Изменения:Changes:
      • Прямая линия: удалите десериализацию или ресериализацию адаптивных карт.Direct Line: Remove Deserialize/Reserialize of Adaptive Cards. Содержимое адаптивных карт будет передаваться клиенту как есть.The content of Adaptive Cards will be passed to the client as is.
  • Версия 1.2Version 1.2

    • Введенная дата: апрель 2021Date introduced: April 2021
    • Изменения:Changes:
      • Временной канал: имя вложения используется для текстового значения сообщения.Slack channel: Attachment name is used for Message Text value.
      • Канал Facebook: обновление до Facebook API Graph v 9.0.Facebook channel: Upgrade to Facebook Graph API v9.0.
  • Версия 1.1Version 1.1

    • Введенная дата: апрель 2021Date introduced: April 2021
    • Изменения:Changes:
  • Версия 1.0Version 1.0

    • Исходная версияOriginal version

Публикация ботаPublish a bot

Процесс публикации на каждом канале разный.The publishing process is different for each channel.

SkypeSkype

Примечание

Начиная с 31 октября 2019 г. канал Skype не принимает новые запросы на публикацию ботов.As of October 31, 2019 the Skype channel no longer accepts new Bot publishing requests. Это означает, что вы можете разрабатывать боты с использованием канала Skype, но бот будет доступен только 100 пользователям.This means that you can continue to develop bots using the Skype channel, but your bot will be limited to 100 users. Вы не сможете опубликовать бота для большего числа пользователей.You will not be able to publish your bot to a larger audience. Текущие боты в Skype будут работать без прерываний.Current Skype bots will continue to run uninterrupted. Узнайте больше о том, почему некоторые функции недоступны в Skype.Read more about why some features are not available in Skype anymore.

Боты публикуются в Skype со страницы конфигурации.Bots are published to Skype from the configuration page. При публикации бот отправляется на проверку.Publishing a bot submits it for review. До проверки бот поддерживает до 100 контактов.Before review, the bot is limited to 100 contacts. Для утвержденных ботов количество контактов не ограничено. Кроме того, их можно включать в каталог ботов Skype.Approved bots do not have limited contacts and you may opt to have the bot included in the Skype bot directory.

Skype для бизнесаSkype for Business

Важно!

Поддержка Skype для бизнеса Online будет прекращена 31 июля 2021 г.Skype for Business Online will retire on July 31, 2021. До этой даты клиенты смогут использовать Skype для бизнеса Online обычным образом.Skype for Business Online customers should see no change to the service before the retirement date. См. сведения о прекращении поддержки Skype для бизнеса Online.Read Skype for Business Online to Be Retired for more details.

Боты Skype для бизнеса регистрируются в клиенте Skype для бизнеса Online администратором клиента.Skype for Business bots are registered with a Skype for Business Online tenant by a Tenant Administrator.

Чтобы просмотреть состояние проверки, откройте бота на портале Bot Framework и выберите Каналы.To view the status of a review, open the bot in the Bot Framework Portal and click Channels. Если бот не утвержден, в результатах будет указана причина.If the bot is not approved, the result will link to the reason why. После внесения необходимых изменений отправьте бот на повторную проверку.After making the required changes, resubmit the bot for review.

Дополнительные ресурсыAdditional resources

Этот пакет SDK содержит примеры, которые можно использовать для создания ботов.The SDK includes samples that you can use to build bots. Посетите репозиторий примеров в GitHub, чтобы просмотреть список примеров.Visit the Samples repo on GitHub to see a list of samples.