Telegram-бот

Чтобы настроить интеграцию между ботами Bot.one и Telegram, нужно выполнить следующие шаги:

1. Подключить модуль Telegram в настройках Bot.one.
2. Создать бота в Telegram и получить его токен.
3. Создать бота в Bot.one и указать в нем токен Telegram-бота.
4. Опубликовать бота Bot.one и получить ссылку на бота в Telegram.

Подключить модуль Telegram

Чтобы настроить подключение к модулю Telegram, обратитесь к администратору.

Создать бота в Telegram

Чтобы создать бота в Telegram и получить его токен:

1. Откройте Telegram.
2. В строке поиска введите BotFather. Это бот для управления всеми ботами. Начните диалог с ним (команда /start).
3. Отправьте команду /newbot.
4. Укажите имя и фамилию нового бота.

Когда бот будет создан, вы получите сообщение, которое содержит токен бота. Этот токен вам нужно будет использовать на следующем шаге.

Подробно о создании Telegram-бота читайте Bots: An introduction for developers.

Создать бота в Bot.one и указать в нем токен

Создайте нужного вам бота в разделе Чат-боты Bot.one. Подробно о создании ботов: Создать бот.

Перейдите на вкладку Настройки созданного бота и укажите полученный на предыдущем шаге токен в поле Токен авторизации в Telegram.

После ввода токена Bot.one готов к обмену сообщениями с Telegram.

Опубликовать бота Bot.one

Опубликуйте бота, чтобы его можно было использовать в диалогах:

1. Нажмите кнопку Публикация в правом верхнему углу.
2. В появившемся окне нажмите Опубликовать.

Ссылка на бот в 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.
• Если отсутствует текст в передаваемых блоках Выбор ответа, Сбор данных (список или мультисписок), диалог будет прерван.