Последнее время начал увлекаться разработкой приложений на Node.JS. Понравился своей гибкостью и тем, что приложения можно писать на JavaScript, а с ним я хоть немного дружу.
Недавно написал скрипт, который следит за активностью группы в ВК. А чуть позже, решил поинтересоваться Telegram API. Дуровы всегда умели делать качественный продукт и Telegram меня обрадовал своей быстротой и возможностью создания своего бота с понятным даже новичку API.
И в этой статье я коротко расскажу о том, как создать своего бота на Node.JS. Кстати, вот ссылка на репозиторий бота.
Если вы открыли чат с ботом, кликаем на кнопку «Start».
После чего, бот нам выдает все доступные команды.
Отправляем команду /newbot или кликаем по активной ссылке этой команды. Далее, бот нас попросить ввести имя для нашего бота.
Можете не париться с именем и вписать любое тестовое имя. Плюс в том, что вы в любой момент сможете удалить тестового бота или поменять имя.
Я решил во время статьи создать бота для этого блога и назвал его «Archakov Blog».
Telegram Бот на Java за 60 секунд #java #telegrambot #программирование
На последнем этапе, бот попросит вас придумать никнейм (логин). К никнейму в конце обязательно надо добавить суффикс «bot» можно и «Bot». К сожалению, никнейм поменять больше не получится. Если это ваш первый бот, не парьтесь и придумайте любой никнейм.
В итоге, получаем сообщение о том, что бот был создан и в конце будет указан его токен. Этот токен нам пригодится в процессе разработки.
[info] Не советую делиться токеном с другими людьми. Так как он дает полный доступ к вашему боту. Начиная от редактирования имени и до удаления бота.
Теперь приступим к написанию кода и первым делом установим Node.JS. У меня OS X и хочу предупредить, что от операционной системы не будет зависеть разработка нашего бота.
Как установить Node.JS рассказывать я не хочу и не буду. Для этого обращаемся к гугл с запросом как установить Node.JS.
После того, как установили Node.JS, начинаем разрабатывать наше приложение, а точней бота. Node.JS ищет в каждой папке наличие папки node_modules с модулями, откуда он и будет подключать библиотеку для работы с Telegram API.
Советую поучиться работать с npm командой в консоли. Заранее установите этот менеджер пакетов, он нам скоро пригодится. Кстати, очень крутая и полезная штука, в будущем пригодится. Особенно, когда наступит апокалипсис, будете сидеть и пакеты устанавливать.
Создаем папку с тестовым проектом, к примеру telegram-bot . Далее, в этой папке создаем файл index.js и все! Вы красавчик! Бот создан, можете работать с ним.
Ага, канешна. Код сам не напишется!
Прежде чем его и писать, установим модуль node-telegram-bot-api . Для этого открываем консоль, пропишем путь к директории нашего проекта cd telegram-bot (укажите полный путь к этой папке).
В моем случае, это cd /Applications/MAMP/htdocs/telegram-bot .
Если вы на Windows, советую создавать папку в корне диска, чтобы можно было обращаться к проекту по короче, к примеру cd C:telegram-bot .
Отлично, теперь не забываем про npm . В консоли вбиваем команду: npm install node-telegram-bot-api или yarn add node-telegram-bot-api (в зависимости от того, что вы используете yarn или npm).
И через несколько секунд модуль установился. Ура! В репозитории уже есть пример кода и с помощью этого кода, сделаем своего мега-тру-бота.
Теперь перейдем к файлу index.js и напишем немного кода.
Источник: archakov.im
Бот Телеграм на PHP
Примеры как зарегистрировать бота в Telegram, описание и взаимодействие с основными методами API. Документация на core.telegram.org и tlgrm.ru (неофициальный, на русском).
Все запросы к API должны осуществляться по HTTPS, подойдет бесплатный сертификат «Let’s Encrypt».
Регистрация бота
Следующим сообщением отправляем название для бота, обязательно на конце имени должно быть слово «bot» или «_bot». Ответным сообщением получим токен:
Тут же можно настроить описание и аватарку:
| /setname | Имя |
| /setdescription | Краткое описание |
| /setabouttext | Описание бота |
| /setuserpic | Юзерпик |
Далее нужно поставить «Webhook» чтобы все сообщения из Telegram приходили на PHP скрипт ( https://example.com/bot.php ). Для этого нужно пройти по ссылке в которой подставлены полученный токен и адрес скрипта. https://api.telegram.org/bot /setWebhook?url= https://example.com/bot.php
В ответе будет
При смене токена, установку вебхука нужно повторить.
Входящие сообщения
Сообщения приходят POST-запросом, с типом application/json . Получить его в PHP можно следующим образом:
$data = file_get_contents(‘php://input’); $data = json_decode($data, true);
Чтобы посмотреть входящие данные, их придется дампить в файл:
file_put_contents(__DIR__ . ‘/message.txt’, print_r($data, true));
Текстовое сообщение
Запрос от Телеграм:
Array ( [update_id] => 17584194 [message] => Array ( [message_id] => 26 [from] => Array ( [id] => 123456789 [is_bot] => [first_name] => UserName [language_code] => ru-US ) [chat] => Array ( [id] => 123456789 [first_name] => UserName [type] => private ) [date] => 1541888068 [text] => Привет бот! ) )
Получим текст сообщения:
if (!empty($data[‘message’][‘text’]))
Фотографии
При отправки фото боту, на скрипт приходит массив превьюшек, последним элементом будет оригинальное фото. Максимальный размер файла 20МБ.
Запрос от Телеграм:
Array ( [update_id] => 17584194 [message] => Array ( [message_id] => 38 [from] => Array ( [id] => 123456789 [is_bot] => [first_name] => UserName [language_code] => ru-US ) [chat] => Array ( [id] => 123456789 [first_name] => UserName [type] => private ) [date] => 1541924962 [photo] => Array ( [0] => Array ( [file_id] => AgADAgADUqexG7u8OEudBvlhgMzKC1agOQ8ABC6Bx26USA7Mw3gAAgI [file_size] => 1196 [width] => 51 [height] => 90 ) [1] => Array ( [file_id] => AgttAgADUqoxG7u8OEudBvlhgMzKC1agOQ8ABKwp_3jDPrIlxHgAAgI [file_size] => 21146 [width] => 180 [height] => 320 ) [2] => Array ( [file_id] => AgADAgADUqyxG7u8OEudBvlhgMzKC1agOQ8ABAN8gJWpUT1MxXgAAgI [file_size] => 90940 [width] => 449 [height] => 800 ) [3] => Array ( [file_id] => AgADAgADUqouu7u8OEudBvlhgMzKC1agOQ8ABIqVC1nEpbLDwngAAgI [file_size] => 114363 [width] => 719 [height] => 1280 ) ) ) )
Чтобы скачать файл нужно отправить POST или GET запрос на получение c параметром file_id изображения по URL: https://api.telegram.org/bot /getFile В ответ придет информация о файле:
Array ( [ok] => 1 [result] => Array ( [file_id] => AgADAgADUqoxG5u88E0dBvlhgMzKC1agOQ8ABIqVC1nEpbLDwngAAgI [file_size] => 114363 [file_path] => photos/file_1.jpg ) )
Далее его можно скачать по ссылке: https://api.telegram.org/file/bot / В PHP сохранение файла на сервер можно реализовать следующим образом:
$token = ‘123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11’; if (!empty($data[‘message’][‘photo’])) < $photo = array_pop($data[‘message’][‘photo’]); $ch = curl_init(‘https://api.telegram.org/bot’ . $token . ‘/getFile’); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, array(‘file_id’ =>$photo[‘file_id’])); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_HEADER, false); $res = curl_exec($ch); curl_close($ch); $res = json_decode($res, true); if ($res[‘ok’]) < $src = ‘https://api.telegram.org/file/bot’ . $token . ‘/’ . $res[‘result’][‘file_path’]; $dest = __DIR__ . ‘/’ . time() . ‘-‘ . basename($src); copy($src, $dest); >>
Документ
Запрос от Телеграм:
Array ( [update_id] => 17474201 [message] => Array ( [message_id] => 44 [from] => Array ( [id] => 123456789 [is_bot] => [first_name] => UserName [language_code] => ru-US ) [chat] => Array ( [id] => 123456789 [first_name] => UserName [type] => private ) [date] => 1541925844 [document] => Array ( [file_name] => IMG_7947.JPG [mime_type] => image/jpeg [thumb] => Array ( [file_id] => AAQCABMNv_QOAATwQugveIZBldZ3AAIC [file_size] => 2644 [width] => 67 [height] => 90 ) [file_id] => BQADAgADtQEAAqu9OEhzn2cEz8LpkgI [file_size] => 1976218 ) ) )
Скачивание файлов происходит по такой же схеме как у фотографий.
if (!empty($data[‘message’][‘document’])) < $file_id = $data[‘message’][‘document’][‘file_id’]; $ch = curl_init(‘https://api.telegram.org/bot’ . $token . ‘/getFile’); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, array(‘file_id’ =>$file_id)); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_HEADER, false); $res = curl_exec($ch); curl_close($ch); $res = json_decode($res, true); if ($res[‘ok’]) < $src = ‘https://api.telegram.org/file/bot’ . $token . ‘/’ . $res[‘result’][‘file_path’]; $dest = __DIR__ . ‘/’ . time() . ‘-‘ . basename($src); copy($src, $dest); >>
Ответы бота
Отправка текста
$response = array( ‘chat_id’ => $data[‘message’][‘chat’][‘id’], ‘text’ => ‘Хай!’ ); $ch = curl_init(‘https://api.telegram.org/bot’ . $token . ‘/sendMessage’); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, $response); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_HEADER, false); curl_exec($ch); curl_close($ch);
Отправка картинки
$response = array( ‘chat_id’ => $data[‘message’][‘chat’][‘id’], ‘photo’ => curl_file_create(__DIR__ . ‘/image.png’) ); $ch = curl_init(‘https://api.telegram.org/bot’ . $token . ‘/sendPhoto’); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, $response); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_HEADER, false); curl_exec($ch); curl_close($ch);
Отправка файла
Пример скрипта
Источник: snipp.ru
Что такое бот в Telegram, как он работает и для чего нужен?
Татьяна Минина OneSpot
Telegram-бот — это скрипт, написанный разработчиком или созданный через специальный конструктор. С его помощью пользователи мессенджера могут автоматизировать рутину. Например, получать автомобильные штрафы, ставить напоминания, принимать заявки, переводить тексты, транскрибировать аудио или искать авиабилеты.
Выглядят боты так же, как обычные диалоги в мессенджере. Информация, проходящая через скрипты, конфиденциальна и защищена, как и переписка пользователей.
С ботами можно работать не только в личных, но и в коммерческих целях. Компании задействуют их на разных этапах пути пользователя: предоставляют информацию о себе и своих товарах или услугах, делают персональные предложения, собирают заявки, мотивируют к покупке, удерживают клиента и повышают лояльность.
Продвигать ботов можно в Telegram Ads, каталогах и релевантных по теме каналах, у блогеров. Обо всем этом расскажем подробно.
- Что может Telegram-бот?
- Telegram-боты интернет-магазинов
- Telegram-боты для служб доставки
- Telegram-боты для записи на услуги
⚡ С августа 2023 минимальный бюджет для первого подключения к Telegram Ads снизили вдвое: было 3000 € → стало 1500 €
Как работают Telegram-боты?
Процесс использования скрипта интуитивно понятен.
- Откройте Telegram, найдите нужный бот в поиске или запустите свой (как его сделать и настроить, расскажем ниже).
- Нажмите «Старт» (Start) или отправьте в диалог с ботом команду /start.
- Отправьте сообщение по инструкции.
- Запрос уйдет на сервер, где установлен скрипт бота, и будет обработан.
Бот в Telegram — это приложение, которое вы используете без установки на свое устройство. Оно запускается с ресурса, который выбрал автор бота. Если бот создан средствами самого мессенджера, код хранится на серверах Telegram. Если в конструкторе — на хабах конструктора. Если вы заказали написание разработчику, он предложит и согласует сервер с вами.
- Ответ придет в ваш диалог с ботом.
Важно: бот умеет отправлять сообщения только тому пользователю, который его запустил. Без инициативы юзера бот не может к нему обратиться. Если вы заблокируете бота, он не сможет вам писать.
Как использовать бот в Telegram для бизнеса?
Telegram-бот будет полезен маркетологам, работникам клиентского сервиса, сотрудникам HR-отделов, специалистам по бизнес-процессам. Скрипты позволяют тратить меньше времени на рутинные задачи.
Что может Telegram-бот?
- Построить воронку продаж. Пользователь видит объявление в канале —> переходит в бот —> отвечает на вопросы —> оставляет контакты.
После этого с лидом можно работать через другие каналы: позвонить или отправить коммерческое предложение, запустить ретаргетинг на других платформах, включить в email-рассылку.
Совет OneSpot
Самый эффективный способ — комбинировать разные варианты, чтобы донести ценность вашего предложения в удобном для клиента формате. Например, одному человеку будет достаточно звонка от менеджера, и он примет решение о покупке. Другой не любит звонки и долго взвешивает все за и против, поэтому до него эффективнее дотянуться с помощью рассылки или таргетированной рекламы.
- Собирать заявки. Механизм мы описали выше. Сбор лидов через бот в Telegram эффективно использовать в связке с Telegram Ads. Когда пользователь увидит ваше рекламное объявление, ему не понадобится переходить на другую платформу, чтобы уточнить детали или сделать заказ — все можно сделать в мессенджере при помощи скрипта.
Например, компания Ukids использовала бот как посадочную страницу для рекламы в Telegram Ads. Бот отправлял юзерам полезный материал на тему детского образования и приглашал на продающий вебинар. После участия зрители могли оставить заявку на обучение и стать клиентами. Подробности читайте в кейсе Ukids и OneSpot.
- Уведомлять заказчика об этапах доставки. Можно отправить клиенту информацию, что его заказ собран на складе (прибыл в сортировочный центр, через три часа будет в месте вручения). Для пользователя это будет удобнее, чем заходить в личный кабинет магазина или службы доставки.
- Модерировать чат. Если у бизнеса есть канал или группа, где клиенты пишут комментарии и вопросы, там появляется спам. Можно подключить бот, который автоматически удалит комментарии со стоп-словами и забанит их авторов. Учтите, что в таком случае вы даете боту разрешение на управление сообщениями в чате, важно выбирать проверенных разработчиков ботов, чтобы избежать взлома.
- Получать обратную связь от клиентов. Если в вашем канале закрыты комментарии, для приема обращений можно использовать бот. Он автоматически рассортирует сообщения по ключевым словам и передаст сотрудникам.
- Оптимизировать клиентский сервис. Бот можно использовать для ответов на частые вопросы по товарам и услугам. Это позволит автоматизировать работу с типичными запросами, а сотрудников подключать только для нестандартных случаев.
- Напоминать сотрудникам компании о задачах и дедлайнах. Тогда им не придется заходить в CRM и настраивать пуш-уведомления о задачах. Все напоминания будут приходить в Telegram.
- Собирать резюме. Рекрутер может создать бота, в который соискатели будут присылать свои резюме и портфолио.
- Получать статистику. С помощью ботов можно загружать данные из Google Analytics, собирать статистику групп в Telegram и выстраивать график активности пользователей.
Это неполный список того, что умеют боты в Тelegram. Какие еще возможности они дают разным нишам бизнеса? Разберем с примерами.
Telegram-боты интернет-магазинов
Фактически это консультант, который всегда на связи и может даже в три часа ночи подсказать клиенту, где в его городе есть работающий магазин. В пиковые часы бот ответит сразу нескольким собеседникам, а сотруднику передаст только нестандартные задачи. Бот соберет контакты пользователей, а затем проведет их по воронке и сформирует персональные предложения.
Telegram-боты для служб доставки
Эти скрипты умеют принимать заявки и переносить лиды в CRM. У курьерских служб есть боты, где можно отслеживать отправления по номеру. Сервисы доставки еды внедряют скрипты для партнеров, чтобы отчитываться по заказам за рабочий день, делиться новостями и информировать об изменениях в условиях сотрудничества.
Telegram-боты для записи на услуги
Такие боты используют в медицинских клиниках, салонах красоты, фитнес-центрах, автосервисах и других учреждениях, где клиенты записываются на услуги. Это экономит время сотрудников, которые ведут запись по телефону, и позволяет быстрее обрабатывать запросы в часы-пик.
Собрав горячие лиды, вы можете при помощи бота напоминать им о следующих процедурах, предлагать дополнительные услуги, собирать обратную связь.
Совет OneSpot
Бот для записи на услуги можно дополнить другими функциями: загрузить ассортимент и прайс на услуги, добавить карту, чтобы клиент построил маршрут.
Запуская такого помощника, пользователь обычно видит информацию, что умеет этот бот Telegram. Далее с ним можно общаться командами либо выбирать кнопки в меню.
Как создать бота в Telegram?
Бот для бизнеса можно создать самостоятельно в конструкторе ботов. Покажем, как это делается средствами самого мессенджера. Функция доступна как в веб-версии, так и на мобильных устройствах.
- В поиске Telegram введите BotFather и выберите из списка бот с синей галочкой (она означает, что аккаунт верифицированный) или перейдите по ссылке.
- Кликните «Старт». Вы увидите список команд.
- Выберите первую строку /newbot, задайте имя и юзернейм для бота.
Имя может быть любым, в том числе кириллическим — это то, что увидят пользователи при общении с ботом. Юзернейм — внутренняя ссылка, по которой они будут заходить, он должен заканчиваться на bot. Если вы ошибетесь, либо имя или юзернейм окажутся заняты, BotFather подскажет, что исправить.
.jpg)
- Получите ссылку на бот и токен для доступа.
Токен — это буквенно-цифровой ключ, при помощи которого вы можете использовать бота для своих задач. Например, интегрировать его в CRM для передачи лидов или скачивать данные из Google Analytics.
Если вашему бизнесу нужен бот с нестандартными функциями, его написание можно заказать разработчику (например, на Python).
Как можно использовать Telegram-бота в рекламе
Бот можно сделать посадочной страницей для объявления Telegram Ads. Для этого при его создании важно соблюдать требования к рекламе в мессенджере.
- Бот должен быть функциональным и взаимодействовать с пользователями: реагировать на кнопку «Старт» и при запуске показывать заполненное поле «Что умеет этот бот».
- Бот не должен в первую очередь предлагать переход на внешние сайты.
- Контент бота должен соответствовать тексту рекламы.
- Тексты должны быть грамотными.
- Бот не должен обращаться к пользователям на «ты».
- Уведомления после запуска бота не должны быть навязчивыми.
- Контент бота не должен продвигать продукты и тематики, запрещенные для рекламы в Telegram Ads. Полный список —>в нашей статье.
С OneSpot рекламу в Telegram Ads можно оплачивать в одном окне с другими площадками: VK Реклама, myTarget и ВКонтакте, Яндекс Директ и Яндекс Бизнес, Авито. Мы подключим для вашего бизнеса рекламный кабинет Telegram, поможем с настройками, начислим кэшбэк, предоставим аналитику и оформим закрывающие документы. Минимальный бюджет — 1500 евро (его можно использовать в течение года с момента оплаты)(до августа 2023 действовали другие условия — минимальный порог от 3000 евро).
Продвигаем бот в Telegram
Существуют и другие способы продвижения помимо Telegram Ads.
- Тематические каталоги. Они есть как в самом мессенджере, так и на сторонних площадках. Можно найти их через поиск и подать заявки на добавление.
- QR-коды. Способ подходит для офлайн-бизнесов (например, ресторанов, фитнес-клубов или кейтерингов). Разместите на видном месте QR-код, ведущий в Telegram-бот, или напечатайте его на визитках или упаковке товара. В качестве лид-магнита используйте уникальные скидки и предложения, доступные только в боте.
- Размещение рекламы в релевантных по теме Telegram-каналах или у лидеров мнений.
Заключение
Зачем бизнесу бот в Telegram? В первую очередь — чтобы автоматизировать стандартные процессы и высвободить ресурсы команды.
Простые задачи (сбор заявок, прогрев покупателей и прямые продажи) можно решить с помощью ботов, созданных через конструкторы. Более сложные, например, самообучающиеся скрипты, требуют индивидуальной разработки.
Особенно эффективными боты будут в связке с официальной рекламой в Telegram. Вы сможете переводить аудиторию в бот, а затем «прогревать» и побуждать к целевому действию. Подписчики станут частью вашей клиентской базы, к которой вы впоследствии сможете обратиться в любой момент: напомнить о своих продуктах или сделать персональные предложения.
Оставьте заявку на подключение к Telegram Ads с OneSpot и запускайте и оплачивайте рекламу в одном окне с другими площадками. Мы поможем с настройками и модерацией, подготовим закрывающие документы, начислим кэшбэк и выгрузим аналитику.
Боты — не единственный инструмент, который можно использовать для продвижения бизнеса. Читайте наши статьи про Telegram, чтобы узнать больше о возможностях популярного мессенджера.
Источник: onespot.one