Бот который автоматически принимает заявки в Телеграм

Рассказываем, как подключить платежную систему к Telegram-боту и разместить его на сервере.

Введение

Telegram-боты обладают широкой функциональностью и решают массу задач клиентов самых разных бизнесов. Рассказываем, как создать и разместить бота для приема платежей в Telegram на Python. Видеоверсия доступна по ссылке.

В Telegram есть встроенная система оплаты, поэтому сценариев, как использовать бота для приема платежей, достаточно много. Это может быть разовая оплата заказа или ежемесячная подписка.

Платежные системы Telegram

Сейчас мессенджер поддерживает оплату в более чем 200 странах через такие шлюзы, как: Stripe, YooMoney, Sberbank, LiqPay, PayMaster и другие.

Все начинается с установки библиотеки aiogram. Сейчас, пожалуй, это самая популярная библиотека для разработки ботов на Python.

python -m pip install aiogram

Переходим в Telegram и пишем тут BotFather’у команду /newbot. Вводим имя нового бота. Важно, чтобы оно заканчивалось словом Bot.

Создай телеграм бот для заявок и уведомлений

Получаем уникальный токен нового бота. Теперь напишем код простейшего эхо-бота, чтобы проверить его работу.

Связать бота с приложением

Создаем файл config.py и вписываем в него токен, который выдал BotFather. В основном файле main.py прописываем базовый код любого бота.

Обратите внимание на один важный момент: бот должен обрабатывать каждое сообщение с серверов Telegram. Для этого при запуске бота обязательно нужно поставить аргумент skip_updates в значение False. Это спасет от проблем при обработке платежей.

Теперь можно запустить код и проверить, работает ли бот. Убедившись, что все хорошо, приступаем к подключению платежей.

Возвращаемся к BotFather’у, даем команду /mybots и выбираем из списка своего бота.

В открывшемся меню кликаем на кнопку «Payments». Из предоставленного списка выбираем нужный платежный шлюз. В качестве теста используем PayMaster. Чтобы подключить оплату в Telegram-бота, сначала нужно выполнить тест, поэтому выбираем «PayMaster Test».

Следуем простым инструкциям бота платежной системы и получаем тестовый токен PayMaster. Его сразу же можно сохранить в config.py.

TOKEN = «5432877141:AAHEwBEb2mwnZX56oaHM10o33ZBZwVkvv-s» PAYMENTS_TOKEN = «1744374395:TEST:f14d9f0d42528b780370»

Возвращаемся к коду бота. Для того, чтобы запросить оплату товаров/услуг, нужно сгенерировать invoice с деталями платежа. Отправить его клиенту и обработать результат.

Подключаем оплату

Указываем список доступных цен на продукты. В качестве цены нужно передать целочисленное значение в минимально возможных единицах валюты. Если речь идет о рублях, то стоимость нужно указывать в копейках. То есть место 500 рублей мы тут укажем 500 * 100 или же 50 000 копеек. В случае с долларами будет почти также, $1=100 центов. Если предполагается работа с другими валютами, можно использовать currencies.json от Telegram API.

Дальше в коде бота платежной системы мы создаем обработчик команды /buy. Команда будет генерировать и отправлять пользователю invoice платежа. В примере используется оплата месячной подписки.

Сам процесс генерации invoice довольно простой. Не стоит беспокоиться большому количеству аргументов. Это названия продуктов или услуг, описания, цена, валюта и т.п.

Настройки платежей

Обратите внимание на аргумент is_flexible. Его нужно указывать в значение True только в том случае, если финальная стоимость зависит от выбранного способа доставки, если речь идет о продаже какого-то физического продукта.

О других параметрах метода send_invoice вы всегда можете прочитать в официальной документации Telegram API.

Теперь нужно создать еще два обработчика: Pre Checkout Query и Successful Payment.

Pre Checkout Query отвечает за обработку и утверждение платежа перед тем, как пользователь его совершит. Так можно проверить доступность товара на складе или уточнить стоимость.

Важно, что серверам Telegram ответ нужен в течение 10 секунд. Если его не будет, платеж не пройдет.

Successful Payment отвечает за обработку успешно проведенного платежа.

Тут можно выдать пользователю тот самый месяц подписки, за которую он заплатил или любую другую услугу.

Как бот работает на практике

Получив invoice на оплату от бота, нажимаем «Оплатить». Поскольку сначала мы проводим тестирование бота, воспользуемся специальной тестовой картой.

Вводим данные и оплачиваем подписку — все работает. При переходе на боевой проект важно не забыть выбрать правильный счет.

Теперь возвращаемся в BotFather, чтобы получить реальный токен от выбранного платежного шлюза. Если есть запрос на разные тарифы или способы оплаты, лучше запросить сразу 2-3 токена от разных платежных шлюзов. Далее нужно будет генерировать invoice с помощью токена выбранного провайдера.

Перенос бота на боевой сервер

Чтобы бот работал 24/7 вне зависимости от того, включен компьютер или нет, зальем его на реальный сервер.

Для этого воспользуемся облачным сервером линейки Shared Line от Selectel. Калькулятор панели управления позволяет выбрать гибкую конфигурацию сервера и сразу узнать, сколько будет стоить решение. Все продукты и услуги собраны у провайдера в одном месте, поэтому ими легко управлять. Арендовать сервер можно от 10 ₽/день, а в консоли есть возможность быстро масштабировать вычислительные ресурсы при необходимости.

Регистрируемся и входим в панель управления my.selectel.ru. Переходим в раздел «Облачная платформа» и выбираем «Серверы». Создаем сервер — после этого шага он загорится в списке как «ACTIVE».

Настраиваем конфигурацию. Для примера используем 1 ядро, 512 МБ DDR4 и 5 ГБ на диске.

Теперь переходим к выгрузке бота на боевой сервер. Сначала нужно подключиться к серверу через SSH. Для этого мы можем воспользоваться программой WinSCP для Windows. В Linux и MAC для этого есть свои встроенные инструменты.

Запускаем WinSCP. В качестве имени хоста указываем IP адрес нашего нового сервера. Логин и пароль можно взять во вкладке «Консоль» в панели управления.

Теперь перенесем сюда файлы нашего бота: config.py и main.py. Далее открываем отдельное соединение с сервером по SSH в консоли.

Для этого в WinSCP нажать кнопку и открыть PuTTY. Можно также воспользоваться командной строкой, принципиальной разницы нет.

Настройка бота с Payments 2.0

Подключившись к серверу, нужно выполнить ряд простых действий.

• Обновить Python до версии 3.10.
• Установить PIP.
• Поставить библиотеку Aiogram.

Если оставить все в таком виде, то при закрытии SSH-соединения вместе с ним закроется и процесс бота. Что делать?

Есть несколько способов, как решить этот вопрос. Рассмотрим самый простой – использование команды screen.

Пишем команду screen и жмем Enter. Запускаем бота из обычного терминала и закрываем соединение.

Бот продолжит работу. Чтобы в любой момент вернуться к этому экрану, достаточно ввести команду screen -r $screen_running. На этом деплой в облаке Selectel закончен.

Заключение

Описанная схема запуска Telegram-бота не предел того, как можно настроить прием платежей. К боту всегда можно добавить дополнительные возможности: запрашивать адрес доставки или менять цену в зависимости от адреса.

Идеальное решение для pet-проектов

Сервер для решения задач, которые не требуют полной загрузки vCPU.

Зарегистрируйтесь в панели управления

И уже через пару минут сможете арендовать сервер, развернуть базы данных или обеспечить быструю доставку контента.

Инструкция

Как автоматизировать подготовку к собеседованиям с помощью Telegram-бота

29 сентября 2023

Инструкция

Как реализовать очередь в Redis

14 сентября 2023

Инструкция

Как генерировать истории с помощью ChatGPT и Telegram

Источник: selectel.ru

Подключение Telegram-бота для менеджеров

Получать сообщения о новых заказах своих клиентов менеджеры теперь могут в Telegram. Для настройки отправки уведомлений вам нужно будет создать нового чат-бота и подключить его к боту системы parts-soft.ru для менеджеров.

Подключение бота для клиентов описано в данной статье.

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

Содержание

• Создание нового бота в Telegram
• Подключение к боту parts-soft.ru для менеджеров

Подключение менеджерского бота

Для настройки уведомлений клиентам и менеджерам используются разные боты. Для отправки сообщений менеджерам важно создать нового и подключать именно его.

Создание нового бота в Telegram

Инструкцию по созданию бота в Telegram вы можете посмотреть в нашей статье о подключении бота для информирования клиентов.

Подключение к боту parts-soft.ru для менеджеров

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

Перейдите в раздел админпанели Служебные → SMS и мессенджеры → Сервисы и нажмите на кнопку Telegram bot для менеджеров. Во всплывающем окне подтвердите подключение сервиса.

Фото 1. Список сервисов рассылки уведомлений

На странице настройки сервиса:

• в поле API ключ (1) укажите токен, полученный в Telegram при создании бота.
• в поле Регион (2) выберите регион, по менеджерам которого будет рассылаться уведомления. В случае, если значение в поле не указано, сообщения будут отправляться менеджерам всех регионов.
• в поле Приоритет (3) установите уровень приоритета для сервиса. При значении 1, система будет пытаться отправить сообщение через Telegram, а затем — через подключенные SMS сервисы, если для них настроены соответствующие значения приоритета 2, 3 и т.д.

Если для оповещений у вас подключен и активен Универсальный сервис, то система в первую очередь будет пытаться отправить сообщение через него, а уже после через другие сервисы, согласно заданным уровням приоритета.

Фото 2. Настройки подключения к боту Parts-Soft

Предоставление менеджерам доступа к боту

Подписка на бота

Подписаться на бота каждый менеджер сможет самостоятельно. Для ему нужно будет в панели управления системой перейти к настройкам аккаунта. В выпадающем меню менеджер увидит кнопку Уведомления в Telegram. По клику на нее откроется страница подписки на бота.

Фото 3. Переход к подписке на бота (в панели управления)

На данной странице менеджер сможет:

Скопировать (1) ссылку на бота. Ее можно открыть в браузере или сразу в приложении Telegram.

Ссылка содержит уникальный код идентификации (для входа без проверки номера). Она предназначена только для его личного пользования. Ее нельзя передавать для входа третьим лицам.

Фото 4. Виджет подписки на бота

Отписка от бота

Любого подписанного менеджера администратор системы сможет отписать от бота в разделе Служебные → Справочники → Пользователи → Подписки TG. Для этого ему нужно нажать красную кнопку удалить.

Фото 5. Список подписанных на бота менеджеров

Доступ в данный раздел админпанели доступен только пользователям с ролью Администратор системы.

Чтобы отписать уволенного менеджера, рекомендуем сначала изменить его данные для входа в админпанель (логин и пароль) на странице редактирования профиля, а затем уже удалить подписку на бота в данном разделе.

Использование бота

Авторизация

Для использования бота менеджеру нужно будет авторизоваться. Для этого требуется нажать кнопку Запустить:

Фото 6. Запуск бота

После этого он будет авторизован автоматически и сможет получать уведомления.

Уведомления

Бот отправляет уведомления менеджеру клиента:

• о тех событиях, которые были выбраны администратором при создании/редактировании профиля менеджера в блоке Настройка оповещений. Тексты сообщений можно изменить в меню Служебные → Шаблоны html, отредактировав соответствующие шаблоны.
• о переходе позиции из заказа в статус, в настройках которого на вкладке Настройка SMS уведомлений о статусе позиции стоит галочка Отправлять уведомления менеджеру, а в поле Текст уведомления менеджеру указано сообщение.

Уведомление о данном событии в Telegram может также получить менеджер, который оформил заказ клиента в админпанели. Для этого на вкладке Настройка SMS уведомлений о статусе позиции требуется активировать опцию Отправлять уведомления менеджеру заказа и добавить текст сообщения (в поле Текст уведомления менеджеру).

Для сообщений о новом заказе или смене статуса заказа будет доступна кнопка перехода к заказу (см. фото 6). По клику на нее пользователь сможет перейти в раздел админпанели Заказы → Все к оформленному заказу.

Для корректной работы кнопок нужно правильно настроить домен для админпанели. Например, если основной домен вашего сайта в разделе Сайт → Общие настройки указан myparts-shop.ru , то для админпанели на стороне регистратора вашего сайта должен быть настроен домен admin.myparts-shop.ru

Входящие сообщения будут показываться непосредственно в Telegram-чате с ботом, так и на главной странице системы — в журнале событий (блок Последние события). Статусы доставки сообщений можно узнать в разделе Служебные → SMS и мессенджеры → Сообщения.

Источник: parts-soft.ru

Супер ОЛ Открытые линии Телеграм. Настраиваем приложение

Общайтесь с клиентами через мессенджер Телеграм! Создайте своего Телеграм-бота и разместите его в качестве контакта на вашем сайте или в соцсетях. Каждый, кто напишет боту, попадет в открытые линии на вашем портале Битрикс24 и будет сохранен в CRM.

Для настройки интеграции не требуются навыки программирования!

Установите приложение на ваши порталы Битрикс24 по ссылке

Установка приложения

После установки на ваш портал добавится новый кубик Контакт-центра

Сюда нужно будет подключить вашего бота Телеграм.

Создаем бота Телеграм

Если у вас еще нет телеграм-бота, его легко можно зарегистрировать.

Если у вас уже есть телеграм-бот, вы можете получить его токен также с помощью бота BotFather.

здесь же при желании можно сменить токен (кнопка Revoke current token).

Обратите внимание, что у Телеграм ботов имеются ограничения на отправку сообщений. Телеграм-бот может отправить не более 20 сообщений в минуту в один и тот же чат.

Настраиваем открытую линию

Скопируйте токен и сохраните его в настройки кубика в Контакт-центре и сохраните настройки.

Теперь все, кто напишут подключенному вами боту в Телеграме, попадут в открытые линии Битрикс24 и на каждое новое обращение в CRM будет создаваться лид или сделка (в зависимости от настроек, выставленных у вас на портале).

Ответы от сотрудников на портале будут видны внутри чата с ботом Телеграм

Внутри приложения будет отображаться подключенный бот.

Когда все настроено, в Битрикс24 автоматически создастся открытая линия. Ее настройки вы сможете найти в блоке Онлайн чат.

Отправляем кнопки в чат из Битрикса в Телеграм

Если со стороны Битрикс24 отправить клиенту коды кнопок, они распарсятся в Телеграме и будут видны как настоящие кнопки.

Код кнопки со стороны Битрикс24 представляет собой любой текст в двойных квадратных скобках.

Вот как выглядит код со стороны Битрикс24:

Вот что получит клиент:

Вариант с текстом вопроса:

Результат в Телеграме:

Если клиент со стороны Телеграм нажмет на кнопку, он отправит в чат ее текст.

Вы можете настроить бизнес-процессы, которые автоматически будут отправлять клиенту кнопки и реагировать на то, что пользователь выберет.

Добавляем бота в группы Телеграм и обмениваемся сообщениями с Битрикс24

В открытую линию Битрикс24 могут писать как из чата с ботом один на один, так и из групп. Для того, чтобы начать обмениваться сообщениями, требуется добавить бота, подключенного к ОЛ, в нужную группу Битрикс24 и дать ему право доступа к сообщениям.

По дефолту любой бот Телеграм не имеет доступа к сообщениям и реагирует только на команды и непосредственное обращение к нему. Предоставить боту доступ к сообщениям можно несколькими способами.

Способ 1. Добавить бота в список администраторов группы.

Откройте настройки группы и добавьте бота в список администраторов. Чтобы это сделать, вы сами должны быть администратором группы.

После выхода из меню добавления администраторов обязательно сохраните настройки!

Способ 2. Измените настройки приватности бота в его собственных настройках

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

По умолчанию настройки приватности всех ботов, которых вы создаете имеют включенный приватный режим, который, помимо прочего, не предоставляют ботам доступа к сообщениям (подробнее в официальной документации Телеграм). Вам потребуется отключить приватный режим.

После отключения приватного режима

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

Бот будет пересылать сообщения от участников чата в открытую линию Битрикс24, а ответы, написанные на стороне Битрикс24, — в чат в Телеграме.

Обращение в открытую линию из чата наедине с ботом или из группы Телеграм создаст на портале Сделку или Лид (в зависимости от ваших настроек).

Если обращение было из группы, куда пишет несколько разных пользователей, они НЕ будут сохранены как разные сделки/лиды.

Источник: it-solution.ru