В нашем небольшом туториале мы расскажем о том, как создать бота, настроить в нем графическое меню, редактирование сообщений и отправку текста и фото в одном сообщении.
Зачем бот нам?
Tagvisor — сервис для поиска настоящих отзывов о заведении. Мы агрегируем их по геолокации, хэштегам и из официальных аккаунтов заведений в социальных сетях. Далее ранжируем по популярности (количеству и свежести постов в социальных сетях) и близости к пользователю.
Custdev показал, что наша целевая аудитория часто ищет места поблизости с телефона. Не любит просматривать больше 20 вариантов в результатах поиска, хочет сразу видеть отзывы, фото и отметку заведения на карте.
Логично было бы выкатить мобильное приложение, но цена разработки и порог входа для потенциального пользователя слишком высок для молодого стартапа. Решили пойти модным путем и в качестве mvp выпустили бота.
@TagvisorBot показывает ближайшие к вам заведение по выбранной категории.
Как и в десктопной версии сервиса, основным контентом выдачи являются посты из социальных сетей.
Разработка
Для реализации был выбран Node.js и форк для модуля @node-telegram-bot-api, адаптированный для Telegram 2.0.
В основном использовали документацию API telegram и модуля node-telegram-bor-api. Для людей, любящих русскую документацию, есть перевод, но он еще в процессе. Также есть группа разработчиков со всей России в самом Telegram ) и в facebook. В группах всегда можно написать вопрос, обычно отвечают в течение пары дней.
Создание
Чтобы создать бота, в первую очередь, постучитесь к @botfather с командой /newbot. Он попросит написать имя бота и его username (которое должно заканчиваться на bot). При создание бота @botfather сообщит http-токеп для api. Команды, начинающиеся с /set, помогут настроить различные параметры бота, такие как имя, описание, аватар, текст в профиль и описание. Все достаточно просто.
Для работы бота нужно выбрать режим обновлений: polling или WebHook.
- в режиме WebHook сервер Телеграма будет отправлять данные вашему боту, каждый раз при поступлении запроса. Это удобный и надежный вариант, а, главное, быстрый, но, к сожалению, этот режим требует https-подключения и сертификата.
- в режиме polling бот будет сам ходить на сервер Телеграма и забирать новые данные. Этот режим гораздо проще, но реакция бота будет не мнгновенной, а в среднем с полсекундной задержкой. Кроме того, нужно учесть, что иногда бывают сбои в ответе с сервера, поэтому бота следует сделать устойчивым к таким ошибкам.
Запуск бота
Чтобы запустить бота, необходимо подключить пакет и передать боту необходимые данные: токен и режим обновления.
const TelegramBot = require('./lib/telegram.js');
const bot = new TelegramBot(‘YOUR_TOKEN’, {polling: true});
bot.getMe().then(function (me) {
console.log('Hi my name is %s!', me.username);
});
Вызов функции getMe() происходит при успешной авторизации токена бота и выдачи управления программе. При этом в качестве аргумента функция getMe().then() принимает функцию function(me). Ее первым аргументом является объект, с помощью которого можно получить различную информацию о вашем боте и, в данном случае, вывести её в консоль.
Далее, чтобы научить бота отправлять сообщения, нужно использовать метод bot.sendMessage(chatId, ‘Hello World!!!’); А чтобы бот понимал входящие запросы, достаточно использовать bot.on('message', function (msg){}). Более подробно методы описаны в документации node-telegram-bot-api.
Красивые кнопочки
Чтобы вместо стандартной пользователь видел inline клавиатуру, необходимо при отправке сообщений передать методу sendMessage ее параметры:
const opt = {
parse_mode: 'markdown',
disable_web_page_preview: false,
reply_markup: JSON.stringify({
inline_keyboard: [
[{text: `Русский ${emoji.get('ru')}`, callback_data:'rus'},
{text: `English ${emoji.get('gb')}`, callback_data:'eng'}]
]
})
}
bot.sendMessage(chatId, 'language?',opt);
Где text — текст на кнопке, callback_data — данные, которые получит бот при нажатии на кнопку.
![](https://habrastorage.org/files/009/25b/aeb/00925baeb45045e2959208858bbb062f.png)
Соответственно, чтобы отловить события нажатия на определенную кнопку, нужно воспользоваться методом.
bot.on('callback_query', function (msg) {
if (msg.data === 'rus'){
console.log(“Russian”);
}
if (msg.data === ‘eng’){
console.log(“English”);
}
});
Изменение сообщения
Иногда требуется не отправлять заново сообщения, а поправить уже существующее (для удобства отображения данных). Для этого мы решили воспользоваться методом bot.editMessageText(text, opt); где text — измененный текст сообщения, opt — Дополнительные опции для запроса к telegram, такие как наличие клавиатуры, форматирование текста и другое.
![](https://habrastorage.org/files/cb0/cf4/ca2/cb0cf4ca2bb6447888a4d9b0d094e18b.png)
![](https://habrastorage.org/files/0d1/703/563/0d170356398a4bb18f2c1bba20763e0a.png)
Отправка текста и фото в одном сообщении
Стандартный метод sendPhoto не подходит, так как имеет ограничения на количество символов в тексте и другое форматирование – текст пишется под фото. Поэтому мы использовали sendMessage и просто вставили в текст сообщения ссылку на нужную картинку.
![](https://habrastorage.org/files/c08/288/1a7/c082881a79da48b9a73fc7eeb1378bea.png)
Чтобы телеграм подгрузил картинку в сообщение, необходимо установить параметр disable_web_page_preview: false.
var opt = {
chat_id: chatId,
parse_mode: 'markdown',
disable_web_page_preview: false,
reply_markup = JSON.stringify({
inline_keyboard: [..]
})
}
Для форматирования текста нужно установить параметр parse_mode. Он имеет два значения: markdown и html. При значении markdown используется форматирование вида:
*bold text*
_italic text_
[text](URL)
`inline fixed-width code`
```pre-formatted fixed-width code block```
const text = ‘[текст](url)’;
bot.sendMessage(chatId, text);
Магазин ботов
Чтобы всю эту красоту увидел мир, а не только ваши пользователи, вы можете написать статью на хабр загрузить вашего бота в магазин ботов – storebot.
Регистрация и публикация простая – достаточно залогиниться на сайте storebot.met и после «далее-делее-готово» нажать в меню «AddBot». Это вам не модерация в AppStore.
Бонус для самых классных
![](https://habrastorage.org/files/fef/9fe/9bc/fef9fe9bc0774fa9908bdda590345da8.jpg)
Итак, при помощи нашего небольшого туториала вы смогли узнать, как сделать бота в телеграме. Надеемся, он был вам полезен. А если вы крутой разработчик, и все это было для вас очевидным, тогда приглашаем поучаствовать в небольшом челлендже: как мы уже писали выше, у Tagvisor есть еще и десктопная версия, которую мы на днях запустили в тестовом режиме. И тому, кто найдет больше всех багов (в верстке, коде, мобильной-версии), мы организуем доставку трех больших пицц. Найденные баги присылайте на почту bugtracker@tagvisor.com.
Комментарии (14)
loststylus
21.07.2016 18:59Это все здорово, если хардкодить. А вот какой бы формат дерева для бота лучше использовать, чтобы его удобно было редактировать?
TimsTims
22.07.2016 00:26Спасибо. Как-раз будет для чего поковырять, наконец, ноду)
sichanastasia
22.07.2016 10:16Ура, кому-то было полезно :)
TimsTims
22.07.2016 10:47Учитывая, что статью добавили в избранное не только я, но и еще 119 человек, то определенно статья полезная
samodum
22.07.2016 03:06Боты для телеграма — это обычные post/get запросы к api телеграма и здесь нет магии.
А каждая статья про ботов телеграма — как какое-то откровение для автора, приобщение к чему-то высшему. Что за хайп такой?sichanastasia
22.07.2016 10:15+2ну поэтому решили рассказать не про алгоритмы ботовские, а про оформление: как сделать визуальное меню и вот это все.
Hello1
22.07.2016 14:39реакция бота будет не мнгновенной, а в среднем с полсекундной задержкой
Можно поподробней. Пишу на полинге и пока не замечал такого.sichanastasia
22.07.2016 16:23Как я уже писала в статье, в режиме polling бот будет сам раз в секунду ходить на сервер телеграма, поэтому и возможна небольшая задержка при ответе самого бота. Т.е. если ты отправил запрос боту в 1 милисекунду, ответит он тебе лишь через 1000 милисекунд
Естественно, это не очень заметно, но это важно так как если не сделать бота устойчивым к «плохим» ответам телеграмма. Например, если недоступно апи, бот может упастьHello1
23.07.2016 10:12Мы похоже с разным api работаем. В моём полинге телеграм отправляет ответ когда есть данные, а не раз в 1000 мс. Соответственно бот держит соединение всегда.
TimsTims
24.07.2016 12:28При pooling'e, телеграмм ничего не отвечает, пока не появятся какие-нибудь данные. Технически это похоже на долгий ответ от сервера, как будто он лагает. Стандартное максимальное время ответа составляет 30секунд. Как только появляются данные для ответа, сервер сразу -же их отдает (при этом, сам механизм*сразу-же* может где-то допускать задержки, например в те же полсекунды)
SleepwalkerOne
Есть ли возможность в Telegram создать групповой чат из двух человек и двух с ботов?
Возможно не в тему, но очень интересно :)
mihmig
Бот не может создавать чат, как и первым писать пользователю.
Но можно создать чат и добавить туда несколько ботов, оба могут видеть либо все сообщения (если настроить приватность для бота)
либо начинающиеся с /
Если команды звучат одинаково то их можно давать так:
/command@MyBot1_bot или /command@MyBot2_bot
Сообщения других ботов боты не видят.
SleepwalkerOne
Спасибо за пояснения, буду пробовать :)
ArtSKIF
Возможно, если у ботов включена опция работы в группах, но в любом случае они буду видеть сообщения только от людей.