ChatbotLab.io

Publishing a chatbot (ru)

This document is available in English.

О чем эта статья

Эта статья описывает процедуру публикации чатбота на платформе ChatbotLab, а также, процесс подключения чатбота к различным каналам через портал Azure (Bot Framework), на примере мессенджеров Telegram и Facebook Messenger.


Требования

  • Учётная запись Microsoft.
  • Именная банковская карта с балансом равным как минимум $1 USD. (Данная сумма будет заблокирована на Вашем счёте сервисом Azure на какое-то время исключительно для верификации карты).

Каналы для публикации чатбота на портале Azure предоставляются бесплатно, при использовании тарифа F0. Более подробную информацию о тарифах Вы можете узнать здесь.

Если у Вас возникли трудности с регистрацией, напишите в нашу техническую поддержку.


Использование сервиса Microsoft Azure

Доступные каналы публикации работают через сервис Azure (Bot Framework). Для работы с сервисом Вам понадобится учетная запись Microsoft. Создать её Вы можете на странице регистрации.

Чтобы воспользоваться службами портала Azure нужно добавить подписку к своей учетной записи. Для этого авторизуйтесь на странице Microsoft Azure, используя свои логин и пароль, а затем перейдите в раздел Subscriptions в левом верхнем углу страницы, и нажмите на add subscription.

На следующей странице Вам будет предложено выбрать одну из подписок. Мы рекомендуем Вам выбрать, прежде всего, вариант подписки Pay-As-You-Go, т.к. она бесплатна и предполагает оплату только за дополнительные сервисы. Для активации подписки Вам будет необходимо заполнить все формы данными, которые потребует система. После активации подписки Вы можете начать работу с порталом Azure, нажав на Portal в верхнем правом углу страницы Microsoft Azure.


Регистрация чатбота на портале Azure

Для того, чтобы зарегистрировать чатбота на портале Azure, нужно воспользоваться службой Bot Channels Registration.

Нажимаем на кнопку New, которая находится слева, на панели портала Azure. В левой части появившегося окна выбираем строку AI + Cognitive Services, а затем нажимаем на See all напротив названия списка - Featured - в правой части окна для раскрытия полного списка служб. В нём находим раздел Bot Service и нажимаем на Bot Channels Registration.

После этого появится окно с информацией о службе. Внизу окна нажимаем кнопку Create.

Если Вы ещё не добавили подписку к своей учетной записи, появится окно с предложением сделать это. Подробнее об этом Вы можете прочесть здесь

В открывшемся окне Bot Service нужно предоставить требуемую информацию о чатботе:

  • Вводим Bot name чатбота: "ACService". Имя должно содержать от 4 до 36 символов.
  • Далее выбираем свою подписку в поле Subscription. В нашем случае это Pay-As-You-Go.
  • Поле Resource groups заполняется автоматически с написанием имени чатбота: "ACService". Имя группы можно изменить, либо выбрать уже существующую.

Resource groups — это контейнер, содержащий связанные ресурсы для решения Azure.

  • Выбираем ближайший к месту создания чатбота географический регион в поле Location .
  • Далее нужно выбрать Pricing tier. Выбираем рекомендуемую и бесплатную ценовую категорию - F0.
  • Затем заполняем поле Messaging endpoint. URL адрес Messaging endpoint можно узнать в профиле чатбота на нашем сайте.

Application Insights - это бесплатная служба для мониторинга и аналитики работы чатбота.

  • После предоставления всей необходимой информации о чатботе нажимаем кнопку Create внизу окна Bot Service.

Через некоторое время в правом верхнем углу портала появится уведомление об успешном развёртывании чатбота - Deployment succeeded.

Более подробная информация о регистрации чатбота на портале Azure.

В процессе публикации чатбота на платформе ChatbotLab Вам понадобятся учётные данные Microsoft App ID и Microsoft App password, которые необходимо будет скопировать и вставить в поля Application ID и Application password, соответственно, в настройках канала BotFramework.com.

Для того, чтобы получить эти учетные данные:

  • Нажимаем на Resource groups на левой панели портала Azure, выбираем в списке ресурсов нужный нам - "ACService", а затем нажимаем на аналогичное имя своего чатбота.
  • На левой панели открывшегося окна службы Bot Channels Registration в разделе Bot management выбираем меню Settings. В Bot profile находим строку Microsoft App ID в разделе Configuration. Копируем и сохраняем Application ID показанный под ней.
  • Далее нажимаем на ссылку Manage возле Microsoft App ID и на открывшейся странице, в разделе Application Secrets нажимаем кнопку Generate New Password. Копируем и сохраняем пароль Application password в надежном месте.

Если у Вас возникает ошибка при создании нового пароля, то узнать существующий пароль можно следующим образом:

  • Заходим в Resource groups, выбираем нужный ресурс и на левой панели окна ресурса в разделе Settings нажимаем на строку Deployments.
  • Затем в списке находим имя нужного чатбота и нажимаем на него.
  • В следующем окне в разделе Inputs Вы сможете найти строку APPSECRET, которая и является Application password.

Теперь Вы можете воспользоваться этими учетными данными для публикации чатбота на платформе ChatbotLab.


Публикация на платформе ChatbotLab

Переходим в My chatbots из вкладки Chatbot в верхней панели сайта и находим нужного чатбота в списке. Нажимаем на More и выбираем Profile для перехода в профиль чатбота.

В профиле чатбота, в разделе Common расположен URL адрес Messaging endpoint. Его необходимо было скопировать и вставить в соответствующее поле во время регистрации чатбота на портале Azure.

В разделе Channels нажимаем на Add для добавления доступного канала BotFramework.com в список подключаемых каналов. После этого нажимаем на Edit, чтобы попасть в конфигуратор канала.

В настройках канала BotFramework.com необходимо ввести учетные данные - Application ID и Application password - Вашего чатбота, скопированные на портале Azure.

Как получить Application ID и Application password вы можете узнать здесь.

Заполняем поля раздела Enter your credentials, нажимаем на Save configuration и возвращаемся в профиль чатбота.

Далее, в профиле чатбота, в разделе Channels переключаем статус Published канала BotFramework.com в состояние On.

Затем нажимаем на Publish для публикации нашего чатбота.

Получаем уведомления о том, что канал и чатбот были опубликованы. Теперь чатботом могут пользоваться ваши пользователи.

В профиле своего чатбота, в разделе Common Вы всегда можете проверить его статус публикации, посмотрев на Current status.


Отмена публикации чатбота

Если Вы больше не хотите, чтобы у других пользователей был доступ к Вашему чатботу, Вы можете отменить публикацию чатбота в его профиле. Для этого просто нажмите на Unpublish.


Тестирование чатбота на Azure

Перед тем, как подключать своего чатбота к различным каналам портала Azure, Вы можете протестировать его работу с помощью интегрированного веб-чата.

Для этого переходим к нашему чатботу на портале Azure: 'Resource groups > ресурс ACService > чатбот ACService'. Затем на левой панели окна чатбота в разделе Bot management выбираем меню Test in Web Chat. Далее откроется окно с веб-чатом, в котором Вы сможете проверить правильно ли выполнена публикация на платформе ChatbotLab и пообщаться со своим чатботом.


Подключение каналов Telegram и Facebook Messenger

Подключение канала Telegram:

Следуя простым шагам, создаём чатбота “ACService_Bot” используя бота BotFather в мессенджере Telegram. После этого мы получаем токен. Копируем его.

Открываем нашего чатбота на портале Azure: 'Resource groups > ресурс ACService > чатбот ACService'. Далее на левой панели окна чатбота в разделе Bot management выбираем меню Channels. В разделе More channels выбираем Telegram и в настройках канала в поле Access token вставляем полученный в мессенджере Telegram токен. Нажимаем Save.

Канал Telegram подключен!

Подключение канала Facebook messenger:

Доступ к чатботу осуществляется через Страницу Facebook. Если у Вас её ещё нет, то её можно создать здесь.

Прежде всего необходимо создать новое Facebook-приложение. Вводим имя нашего приложения: "ACService" и нажимаем на Create App ID.

В Product Setup находим строчку Messenger и, нажав на Get Started, активируем Facebook Messenger в нашем приложении.

Затем нужно настроить Webhooks для Messenger:

На портале Azure заходим в меню каналов нашего чатбота: 'Группа ресурсов > ресурс ACService > чатбот ACService > Channels (на левой панели окна чатбота в разделе Bot management)'. В разделе More channels выбираем Facebook Messenger и в настройках канала копируем значения в полях Callback URL и Verify Token.

Вставляем эти значения в соответствующие поля New Page Subscription в Facebook-приложении, а также, отмечаем галочками в Subscription Fields следующие пункты: messages, message_deliveries, messaging_postbacks, и messaging_optins. Нажимаем Verify and Save.

Далее генерируем Page Access Token, выбрав из списка нужную нам Страницу. Копируем полученный токен.

Заполняем поля Facebook Messenger credentials в настройках канала Facebook Messenger:

  • Вставляем скопированный Page Access Token в соответствующее поле.
  • Facebook App ID и Facebook App Secret можно узнать во вкладке Dashboard на странице создания Facebook-приложения.
  • Facebook Page ID можно узнать в Информации о Странице.

После заполнения всех полей нажимаем Save.

Канал Facebook Messenger подключен!


Тестирование подключенных каналов Telegram и Facebook Messenger

Проверим работу подключенных каналов чатбота в Telegram и Facebook Messenger.

Telegram:

  • Заходим в меню Channels чатбота на портале Azure: 'Группа ресурсов > ресурс ACService > чатбот ACService > Channels (на левой панели окна чатбота в разделе Bot management)'. В разделе Connect to channels кликаем на название подключенного канала - Telegram - и переходим к нашему чатботу “ACService_Bot” в мессенджере Telegram.
  • Нажав на кнопку Start, начинаем работу с чатботом: Приветствуем чатбота и пробуем заполнить форму заявки на услугу:

Канал Telegram работает!

Facebook Messenger:

  • В меню Channels чатбота на портале Azure, в разделе Connect to channels кликаем на название подключенного канала - Facebook Messenger - и переходим на страницу диалога с нашим чатботом “Air Conditioning Service”.
  • Приветствуем чатбота и заполняем форму заявки на услугу, отвечая на запросы чатбота:

Канал Facebook Messenger работает!

Таким образом, Вы можете запустить одного и того же чатбота, созданного на нашем сайте, одновременно на нескольких платформах.

Publishing a chatbot (ru)


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.