Инструкции по созданию ботов

  • Работа в редакторе
  • Как подключить чат бота в телеграмм
  • Как подключить чат бота на сайт
После того как вы зарегестрировались на нашем сайте вам понадобится следующее:
Создать сценарий
Подключить его
Пополнить баланс компании
И все начнет работать
Что Такое сценарий
Сценарий - это бот, с которым общаются ваши клиенты в виджетах, мессенджерах, социальных сетях и по телефону. Сценарии предназначены для автоматизации распространения информации о ваших продуктах, поддержки ваших клиентов, а также экономии времени ваших сотрудников
Каждый сценарий состоит из следующих элементов:
Блоки – вопросы, сообщения, а также различные действия, которые бот выполняет во время диалога с клиентом.
Стрелки – условия, от выполнения которых зависит то, как развивается диалог бота с клиентом.
Все ваши сценарии находятся в разделе "Сценарии" - "Сценарии".
Как создать сценарий
Чтобы создать новый сценарий, нажмите кнопку "Новый сценарий"
В открывшемся диалоговом окне введите название сценария и нажмите кнопку "Создать новый сценарий"

В результате будет создан пустой сценарий.

Как добавить в сценарий блоки и настроить связи между ними
Чтобы перейти к работе со сценарием, нажмите кнопку "глаз"
в строке созданного вами сценария.
В результате откроется страница редактора сценариев.

Редактор сценариев состоит из следующих компонентов:

Панель управления – содержит кнопки, которые служат для выполнения типовых операций при работе со сценарием (например, отменить выполненное действие, сохранить изменения и др.)

Панель инструментов – содержит кнопки, с помощью которых вы можете размещать блоки и стрелки в рабочей области редактора.

Панель параметров – содержит элементы управления, при помощи которых вы можете задавать параметры блоков и стрелок.

Начальный блок – любой сценарий содержит начальный блок. Из этого блока бот начинает диалоги с клиентами.

Строка состояния – отображает различные статусы во время работы со сценарием (например, в строке состояния отображаются уведомления о добавлении блоков в рабочую область).

Любой сценарий состоит из блоков, которые связаны друг с другом при помощи стрелок. Стрелки показывают, в каком направлении развивается диалог с клиентом.

Наиболее часто в сценариях используются следующие блоки:

  • Вопрос – в этом блоке бот задает клиенту вопрос и ожидает получить от него ответ. Бот не перейдет к следующему блоку, пока клиент не ответит на вопрос.
  • Информация – в этом блоке бот сообщает клиенту определенную информацию и затем переходит к следующему блоку. При этом ответа клиента не требуется.

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

Добавим в сценарий блок Вопрос:

  • Кликните по начальному блоку Вопрос в рабочей области сценария. В нижней части блока отобразятся иконки.


Наведите курсор на иконку с символом «?», нажмите левую кнопку мыши и, удерживая ее нажатой, переместите указатель мыши в сторону. В рабочей области появится блок Вопрос.



Кликните по блоку Вопрос и на панели параметров в поле Вопрос (произносится роботом) введем следующий текст: «Здравствуйте! хотим пригласить Вас на пробный урок английского языка. Скажите, вам интересно данное предложение?»

Текст, который вы введете, автоматически отобразится в блоке Вопрос.



Теперь добавим в сценарий блок Информация:

  • Кликните по блоку Вопрос в рабочей области сценария. В нижней части блока снова отобразятся иконки.
  • Наведите курсор на иконку с символом «i», нажмите левую кнопку мыши и, удерживая ее нажатой, переместите указатель мыши в сторону. В рабочей области появится блок Информация.
  • Повторите указанные действия, чтобы разместить второй блок Информация.


Далее определим связи между блоком Вопрос и блоками Информация:
  • Кликните по стрелке, которая ведет из блока Вопрос в левый блок Информация.
  • На панели параметров в раскрывающемся списке Тип выходных данных выберите значение Ключевые слова, а в поле Ключевые слова введите «да» и «интересно».


Кликните по стрелке, которая ведет из блока Вопрос в правый блок Информация и повторите указанные действия, только в поле Ключевые слова ведите «нет» и «не интересно».


Теперь зададим 2 варианта сообщения, которое бот отправит пользователю в зависимости от полученного ответа:
  • Кликните по левому блоку Информация.
  • На панели параметров в поле Информационное сообщение (произносится роботом) введите: «Отлично! Спасибо за ответ.»
  • Кликните по правому блоку Информация.
  • На панели параметров в поле Информационное сообщение (произносится роботом) введите: «Очень жаль! Спасибо за ответ.»
Нажмите кнопку Сохранить на панели Управления.



В редакторе отобразится сообщение об успешном сохранении сценария.



Как проверить, что сценарий работает
Чтобы посмотреть, как работает сценарий, нажмите кнопку "Диалог"
в правом верхнем углу редактора сценариев и в открывшемся окне ответьте на вопрос бота.




Как подключить телеграм бота
После того как вы создали сценарий, мы создаём чат, для этого переходим в вкладку "Чаты" и нажимаем на кнопку "Настройки", затем нажимаем сверху на кнопку "Новый чат".



В открывшимся окне вы можете настроить всё под себя.



После того как всё настроили нажимаем в самом низу окна на кнопку "Создать новый чат"



После того как вы создали чат мы открываем телеграм и в поиске пишем "BotFather".




Затем заходим в чат этого бота и нажимаем кнопку "Меню" и выбираем самую первую комманду "/newbot".



После этого бот попросит вас написать название для вашего бота (сценария) например "VR TECH", после того как отправили ему название своего бота, он попросит вас написать уникальное имя для вашего бота по которому вашего бота смогут найти например "test_vrtech_bot" еще обязательно в конце должно стоять слово "bot" и это имя должно быть обязательно на английском языке. Ещё хотелось бы уточнить что в дальнейшем ник бота поменять не удастся. Если вы сделали всё правильно то бот выведет вам сообщение которое показано на скрине. Также после того как вы это сделали бот пришлёт вам ссылку на вашего бота перейдя по которой вы попадёте в чат со своим ботом. Но наш бот ещё не работает, для начала нам нужно импортировать наш сценарий с платформы VR TTECH в телеграм



Для того чтобы импортировать наш сценарий в телеграм мы открываем нашу страницу TWIN и переходим в вкладку "Помощь" и нажимаем на кнопку "API". Перед нами появился длинный токен который мы выделяем и копируем. После того как скопировали токен, на той же странице нажимаем на кнопку "Чат сервис"



Перед нами откроется страница, и для начала нам нужно авторизоваться для этого мы нажимаем на кнопку "Authorize"


В появившиеся окно вставляем наш токен и ниже нажимаем на кнопку "Authorize"


После этого закрывем окно нажав на кнопку "Close".


После этого мы спускаемся по странице вниз до раздела "Messenger Integrations" и здесь открываем раздел "Telegram integration"


Нажимаем на кнопку "Try it out"


Полсе этого перед нами появится поле ввода (1), куда мы должны ввести "chat id" нашего сценария. В поле (2) мы должны ввести API который нам выдал "BotFather".


Для того чтобы скопировать "Chat id" мы переходим снова на сайт VR TECH, затем переходим в вкладку "Чаты" затем наживаем на кнопку "Настройки", и слева от названия нашего чата есть иконка "двух файлов", нажимаем на нее них и у нас скопировался "Chat id" нашего сценария.


Затем переходим обратно на сайт куда мы должны были ввести этот "Chat id" и вводим его в поле для ввода (1).


API для полля ввода (2) берем из сообщения "BotFather".


Вставляем его в поле ввода (2) вместо слова "string" (токен обязательно должен быть в ковычках)


После того как мы вставили наш токен, мы спускаемся чуть ниже и нажимаем на большую синию кнопку "Execute" . Ниже кнопки откроется поле. Слева будет расположен код. Если вам выдало код 200 то поздравляем, ваш бот успешно начал работать и перейдя по ссылке на вашего бота который прислал вам бот "BotFather" и написав комманду /start вы сможете пользоваться ботом.


Но также после того как вы нажали кнопку "Execute" у вас может выдать другие коды ошибок, и вот что озночают следующие коды ошибок:

403 - не верно ввели токен из личного кабинета или его срок действия истёк

400 - допустили ошибку в теле запроса или при написании id чата

404 - нужно перепроверить все ведённые данные и если ошибка не уходит то попробуйте сменить сервер вверху страницы и снова нажать на "Execute"