Telegram
Бот в Telegram, через который участники области пишут агенту и ставят ему задачи.
Бот в Telegram работает от имени одного агента. Сообщение боту попадает к агенту в чат Otdano, а его ответ возвращается в Telegram. Боту можно поручить и отдельную задачу командой /issue.
Один бот подключается к одному агенту. Если в Telegram нужны два агента, заведите двух ботов.
Что нужно заранее
- Подключить бота может владелец или администратор области.
- Агент активен, а в его Настройках → Общие выбран компьютер. Чтобы агент ответил, компьютер должен быть на связи и иметь доступ к модели.
- Токен бота от @BotFather. Это пароль от бота: вставляйте его только в форму подключения Otdano.
Подключить бота
- Откройте @BotFather и отправьте
/newbot. Задайте имя, затем username с окончаниемbot. Скопируйте токен, который пришлет BotFather. - В Otdano откройте Настройки → Мессенджеры → Telegram и выберите агента. Ссылка ведет в карточку агента: Возможности → Мессенджеры → Telegram.
- Нажмите Подключить Telegram, вставьте токен и нажмите Подключить.
- Дождитесь проверки. Otdano спрашивает Telegram, что токен принадлежит боту, и хранит токен в зашифрованном виде. Если проверка не прошла, подключение не сохраняется.
После подключения в карточке видны имя бота, состояние соединения и кнопка Открыть в Telegram.
| Состояние | Что значит |
|---|---|
| Подключаемся | Otdano устанавливает связь с Telegram. |
| Подключено | Telegram ответил, бот принимает сообщения. |
| Ошибка соединения | Связь прервалась. Под состоянием написана причина, Otdano повторяет подключение сам. |
| Отключено | Бота отключили в Otdano. |
Бот получает сообщения сам, без вебхука. Если этот бот уже работает в другом сервисе, Telegram не отдаст его второму: отключите бота там или заведите для Otdano другого.
Привязать свой аккаунт
Бот отвечает только участникам области, которые связали свой Telegram с учетной записью Otdano. Это делает каждый участник один раз.
- Нажмите Открыть в Telegram, затем Start, и отправьте боту любое сообщение в личном чате.
- Бот пришлет одноразовую ссылку. Откройте ее, войдите в Otdano и нажмите Подтвердить привязку.
- Вернитесь в Telegram и отправьте сообщение еще раз.
Ссылка действует 15 минут. Каждое новое сообщение до привязки дает новую ссылку, а прежняя перестает работать.
Есть и обратный путь. В карточке бота в Otdano нажмите Связать мой аккаунт и отправьте боту личным сообщением показанную команду /bind. Код действует 5 минут.
Право пользоваться ботом проверяется на каждом сообщении. Участник, которого убрали из области или у которого нет доступа к агенту, ответа не получит.
Писать агенту
Первое сообщение начинает чат с агентом в Otdano, следующие продолжают его. У каждого участника в каждом чате Telegram свой чат с агентом. Вся переписка сохраняется в этом чате в Otdano.
Ответ приходит после того, как запуск агента закончился, отдельным сообщением в ответ на ваше. Длинный ответ бот делит на несколько сообщений. Если агент закончил запуск и ничего не написал, бот пришлет «Запуск завершился без ответа. Откройте чат в Otdano.»
Боту можно отправить фото или файл до 10 МБ, подпись станет текстом сообщения. Агент получит файл вложением. Голосовые, стикеры, геопозиция и другие сообщения без текста и файла бот не принимает. Агент отвечает в Telegram только текстом: файлы, которые он сделал, лежат в чате Otdano.
Привязать аккаунт можно только в личном чате с ботом. В группе бот пропускает сообщения участников без привязки.
Команды
| Команда | Что делает |
|---|---|
/new | Начинает новый чат с агентом, следующее сообщение попадет в него. /new текст сразу начинает новый чат с этим текстом. |
/clear | Оставляет текущий чат, но следующее сообщение агент получит без прошлой переписки. /clear текст сразу отправляет этот текст с чистым контекстом. |
/issue текст | Создает задачу вместо сообщения в чат. Исполнитель задачи — агент бота, работа начинается сразу. |
/new и /clear в группах работают и с именем бота, например /new@my_bot.
Отключить бота
В Настройках → Мессенджеры → Telegram нажмите Отключить и подтвердите. Бот перестанет принимать сообщения и отвечать. Чаты в Otdano сохранятся, а привязки аккаунтов сбрасываются: после повторного подключения каждому участнику нужно связать аккаунт заново.
Отключить бота может владелец или администратор области.
Если бот не отвечает
- Бот молчит в личном чате. Проверьте состояние бота в Настройках → Мессенджеры и компьютер агента на странице Рантаймы. Пока компьютер не на связи, запуск ждет, и ответ придет позже.
- Бот снова присылает ссылку. Аккаунт не связан или связь сброшена после переподключения бота. Пройдите привязку заново.
- Ссылка не открывается. Срок вышел или ссылкой уже воспользовались. Отправьте боту новое сообщение и откройте свежую ссылку.
- «Этот бот уже подключен в другом сервисе». Бота опрашивает другая программа или у него настроен вебхук. Отключите его там или подключите другого бота.
- «Сообщение не передано агенту». После двоеточия бот пишет причину, например нет доступа к запуску агента или закончился баланс.
Связанные страницы
- Задачи — что происходит с задачей, созданной командой
/issue. - Командная строка — как добавить компьютер, на котором работает агент.