Telegram-бот
Подключить модуль Telegram в настройках Bot.one.
Создать бота в Telegram и получить его токен.
Создать бота в Bot.one и указать в нем токен Telegram-бота.
Опубликовать бота Bot.one и получить ссылку на бота в Telegram.
Рассмотрим каждый шаг подробно.
Подключить модуль Telegram
Чтобы настроить поключение к модулю Telegram, обратитесь к администратору.
Создать бота в Telegram
Откройте Telegram.
В строке поиска введите
BotFather. Это бот для управления всеми ботами. Начните диалог с ним (команда/start).Отправьте команду
/newbot.Укажите имя и фамилию нового бота.
Когда бот будет создан, вы получите сообщение, которое содержит токен бота. Этот токен вам нужно будет использовать на следующем шаге.
Подробно о создании Telegram-бота читайте Bots: An introduction for developers.
Создать бота в Bot.one и указать в нем токен
Создайте нужного вам бота в разделе Чат-боты Bot.one. Подробно о создании ботов: Создать бот.
Перейдите на вкладку Настройки созданного бота и укажите полученный на предыдущем шаге токен в поле Токен авторизации в Telegram.
Warning | Поле Токен авторизации в Telegram появляется только при подключенном модуле Telegram. |
После ввода токена Bot.one готов к обмену сообщениями с Telegram.
Опубликовать бота Bot.one
Нажмите кнопку Публикация в правом верхнему углу.
В появившемся окне нажмите Опубликовать.
Ссылка на бот в Telegram в окне Публикация – это та же ссылка, которую передавал BotFather после создания бота (см. Создать бота в Telegram). Используйте ее, чтобы начать диалог в Telegram.
Теперь респонденты могут начать разговор с ботом в интерфейсе Telegram. Bot.one получает и сохраняет данные из этих диалогов.
Как взаимодействуют боты
Если при запуске или во время общения возникла ошибка, в диалог будет отправлено сообщение.
Заблокирован инстанс;
Выключена интеграция с Telegram;
Отсутствует или неверный токен;
Бот удален или снят с публикации в Bot.one;
Бот Bot.one может работать только с авторизованными через AD пользователями.
Если респондент в процессе диалога повторно запускает диалог, то текущий диалог завершается, создается и начинается новый.
Если оператор поставил диалог на паузу, то Bot.one переводит диалог в общение между респондентом и оператором. Как только оператор снимет бота с паузы, работа бота будет продолжена в обычном режиме.
Если оператор вводит сообщения в Bot.one – в Telegram они приходят с пометкой Оператор, чтобы респондент знал, когда с ним общается оператор от лица бота.
Все сообщения бота, отправленные в Telegram респондента, считаются прочитанными.
Если диалог с ботом начат в Telegram, продолжить его в веб-версии бота нельзя.
Ограничения
Бот Bot.one не может быть использован в групповых чатах – только в диалогах один на один.
Бот Bot.one не должен содержать блоки Форма, Событие, Doc.one, Авторизация, а также любой пользовательский блок. При передаче такого блока в Telegram диалог будет завершен, респондент получит сообщение об ошибке. Продолжить такой диалог нельзя.
Стикеры, контакты, опросы Telegram не передаются в Bot.one. Респондент получит сообщение об ошибке.
Текстовое сообщение должно быть максимум 4096 символов. Если сообщение больше, оно будет передано в Telegram несколькими сообщениями.
Если отправленное изображение превышает ограничения Telegram, то оно будет добавлено в диалог как прикрепленный файл. Если изображение или прикрепленный файл превышают 50Мб, то в диалог будет добавлена ссылка на этот файл в Bot.one.
Если отсутствует текст в передаваемых блоках Выбор ответа, Сбор данных (список или мультисписок), диалог будет прерван.