--- --- # Создание чат-бота Для создания чат-бота в личном кабинете перейдите в раздел «Чат-боты». Необходимо создать канал для каждого мессенджера, в котором будет работать чат-бот, и при создании чат-бота указать каналы, по которым он будет работать. ## Создание канала Перейдите на вкладку "Список каналов", и нажмите на кнопку "Добавить канал" справа вверху. ![chatbot_001](/chatbot/chatbot_001.png) В появившемся окне введите название канала. Название будет видно только вам. Введите любое удобное имя, по которому в дальнейшем вы сможете легко идентифицировать канал в общем списке. ![chatbot_002](/chatbot/chatbot_002.png) Выберите канал передачи данных (мессенджер), через который будет работать чат-бот. Введите ключ доступа к вашему аккаунту (подробнее в разделе "Доступ к аккаунтам"). Нажмите "Сохранить изменения". Созданный канал появится в списке каналов. ### Доступ к аккаунтам Для работы чат-бота в мессенджерах необходимо предоставить доступ к вашим аккаунтам. Для предоставления доступа введите необходимые параметры (ключи доступа API) в окне создания канала. Ниже вы найдёте информацию о том, как получить ключи доступа для различных мессенджеров. #### Создание чат-бота Telegram Со своего аккаунта Telegram найдите канал @Botfather, запустите бот, нажав на кнопку «Начать». Затем отправьте команду /newbot, и следуйте рекомендациям. В следующих сообщениях введите имя бота (name), которое будет отображаться в диалогах, и ник бота (username). Ник бота должен быть уникальным и оканчиваться на bot. При успешном создании чат-бота в ответном сообщении придет токен для API-интеграции (ключ). Для изменения описания бота используйте команды: /setabouttext. Люди увидят этот текст на странице профиля бота, и он будет отправлен вместе со ссылкой на вашего бота, когда они поделятся им с кем-то. /setdescription. Люди увидят это описание, когда они впервые откроют чат с вашим ботом, в блоке под названием "Что может этот бот?" Для изменения фото профиля используйте команду /setuserpic . #### Регистрация имени отправителя WhatsApp Для регистрации имени отправителя обратитесь к менеджеру. #### Получение ключа Вконтакте Со страницы вашего сообщества Вконтакте откройте раздел «Управление сообществом» («Управление страницей», если у Вас публичная страница), выберите вкладку «Работа с API» и нажмите «Создать ключ доступа». #### Создание чат-бота Viber Авторизуйтесь на сайте https://partners.viber.com/. На ваш номер будет отправлен код для подтверждения. Нажмите "Создать бот" (Create Bot Account). Заполните поля формы регистрации, и нажмите "Create". При успешном создании чат-бота Viber вы получите токен для API-интеграции (ключ). ## Создание чат-бота После создания необходимых каналов перейдите на вкладку "Список чат-ботов" и нажмите на кнопку "Создать Чат-бота" справа вверху. ![chatbot_003](/chatbot/chatbot_003.png) В появившемся окне введите название чат-бота. Название будет видно только вам. Введите любое удобное имя, по которому в дальнейшем вы сможете легко идентифицировать чат-бот в общем списке. ![chatbot_004](/chatbot/chatbot_004.png) Выберите мессенджеры, через которые будет работать чат-бот. Для каждого из мессенджеров выберите канал. Позже вы сможете изменить состав и параметры мессенджеров, выбрав пункт «Настройки» меню чат-бота. Нажмите "Сохранить изменения". Созданный чат-бот появится в списке чат-ботов. ## Редактирование чат-бота Для редактирования чат-бота выберите пункт «Редактирование» меню чат-бота или нажатием на бота перейдите к странице бота и нажмите на кнопку "Редактировать" справа вверху. ![chatbot_005](/chatbot/chatbot_005.png) Будет открыт конструктор, в котором вы сможете создать цепочку сообщений (действий) бота, используя иконки элементов в нижней части экрана. Для создание цепочки действий бота необходимо соединить элементы. Элементы «Меню» и «Поле ввода» могут создавать разветвления цепочки. Текст сообщения может содержать переменные, ранее запрошенные у пользователя, либо полученные по API. Переменные должны быть обрамлены символами #. Каждый элемент, содержащий сообщение пользователю, может также содержать изображение. Для загрузки изображения нажмите на кнопку «Выберите изображение» в окне редактирования соответствующего элемента. ### Начало диалога Для начала диалога с пользователем выберите элемент «Старт». Это первое сообщение, которое увидит пользователь при запуске бота. В окне редактирования введите текст приветственного сообщения. ![chatbot_006](/chatbot/chatbot_006.png) ### Текстовое сообщение Для отправки текстового сообщения пользователю выберите элемент «Текстовый блок». В окне редактирования введите текст сообщения. ![chatbot_007](/chatbot/chatbot_007.png) ### МЕНЮ - Вопрос с вариантами ответа Для того, чтобы задать пользователю вопрос с вариантами ответа используйте элемент «Меню». В окне редактирования введите текст сообщения. В соответствующем поле введите текст ошибки. Его пользователь увидит, если введет вариант ответа, не предполагаемый ботом. Для записи ответа пользователя в переменную поставьте флажок «Запись ответа в переменную», и введите название переменной. Добавьте кнопки вариантов ответа. ![chatbot_009](/chatbot/chatbot_009.png) ### Запрос данных от пользователя Для запроса данных от пользователя выберите элемент «Поле ввода». В окне редактирования введите текст сообщения, а также выберите тип поля (запрашиваемых данных): e-mail, номер телефона, url, диапазон чисел или свои данные. Для типов полей e-mail, номер телефона, url и диапазон чисел осуществляется проверка введеного значения. Если введеное пользователем значение соответствует ожидаемому типу, то далее бот действует по ветке «да», если не соответствует - то по ветке «нет». Введенное пользователем значение будет записано в переменную. ![chatbot_008](/chatbot/chatbot_008.png) ### Обмен данными по API Для передачи данных (значений переменных), полученных от пользователя, по API в свою систему, а также запроса данных из своей или сторонних систем выберите элемент «Отправка данных». Это действие бота происходит в фоновом режиме, и не сопровождается сообщением пользователю. В окне редактирования введите запрос, а также выберите переменные для передачи. Для проверки запроса нажмите «Протестировать». ![chatbot_010](/chatbot/chatbot_010.png) ### Отправка уведомления администратору Для отправки уведомления администратору чат-бота в Telegram, с текстом и переменными, полученными от пользователя, выберите элемент "Уведомление". Это действие бота происходит в фоновом режиме, и не сопровождается сообщением пользователю. В окне редактирования введите текст уведомления, используя интересующие вас переменные. Введите токен бота Telegram, который вы получили при создании бота, и ID пользователя Telegram, которому должны приходить уведомления. ![chatbot_011](/chatbot/chatbot_011.png) Вы можете узнать свой ID пользователя, например, с помощью канала @my_id_bot ### Завершение диалога Для завершения диалога используйте элемент «Выход». В окне редактирования введите текст завершающего сообщения. ![chatbot_012](/chatbot/chatbot_012.png)