Телеграм-бот ZapGram

Гид подготовлен Тони⚡️.
Поддержать проект.

ZapGram – удобный робот, который выведет ваше взаимодействие с Telegram и сетью Лайтнинг на новый уровень.

Возможности ZapGram #

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

Для начала работы просто перейдите по этой ссылке или введите @zap_gram_bot в поиске Телеграм. Заведите беседу с ботом, нажав /start.

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

Основные функции и команды #

Отправка и получение сат #

⚠️ Единственное условие: получатель должен завести беседу с ботом!
Если получатель ещё не взаимодействовал с ботом, вы можете попросить его это сделать.

Проще всего отправить или получить саты можно из главного меню бота: ㆔ → Главное меню.

Просто следуйте инструкциям бота. Все взаимодействия интуитивны.

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

В главном меню или по команде /wallet нажмите Отправить и выберите:

⚡️ Оплатить Lightning счёт для отправки средств на сторонний кошелёк (по лайтнинг-инвойсу).
👤 Отправить сатоши пользователю для отправки средств пользователю Телеграм.

Просто следуйте инструкциям бота. Все взаимодействия интуитивны.

Использование бота в групповом чате #

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

/tip <сумма>

Если вы не хотите наделять бота правами администратора, вы все равно можете использовать те же команды, просто добавляя @zap_gram_bot в начале каждой команды.

Донаты за посты в канале #

ZapGram позволяет авторам каналов получать донаты за посты. Для этого убедитесь, что к вашему каналу привязан чат (возможность комментировать посты канала) и что бот добавлен в качестве администратора канала. Это позволит вашим читателям отправлять вам саты ответом на пост в канале, используя команду /tip.

Пример отправления доната ответом на пост канала.

Запросы на добавление новых функций #

Хотите увидеть новую функцию в боте? Используйте команду /feature, чтобы предложить разработчику добавление нового функционала. Для приоритизации запрашиваемой функции советую приложить к запросу саты:

Опишите запрос после ввода команды /feat. Под сообщением появятся кнопки для отправки сат.

Запрос и саты приняты.

Управление платными подписками #

ZapGram позволяет настраивать платный вход в Telegram-чаты — как приватные, так и привязанные к каналам. Также доступен функционал подписок, где вы можете установить сумму, которая будет автоматически списываться с кошелька подписчика (работает только для Лайтнинг).

Взимайте плату за вход в чат ончейн (широкое принятие) или через сеть Лайтнинг (околонулевые комиссии)
Определяйте стоимость входа в сатоши, долларах или других валютах
Настраивайте разовые платежи или подписки с регулярными списаниями
Подписчики могут отменить подписку в любой момент

Детали работы бота для владельцев платных чатов и подписчиков #

Настройка платного доступа #

Чтобы активировать платный вход (Лайтнинг-платежи) в чат или канал:

Добавьте ZapGram в администраторы.
- Для чатов: выдайте права на приглашение и бан пользователей.
- Для каналов: достаточно права на приглашение.
После назначения админом бот автоматически отправит уведомление с настройкой доступа.
В настройках укажите:
- Стоимость входа (в сатоши, долларах или другой валюте).
- Тип подписки: месячная (автопродление) или разовая.
- Включите платный доступ.
Раздавайте любую ссылку с параметром “request admin approval” — бот сам обработает заявки.

Ончейн-платежи за вход #

Бот также позволяет пользователям оплачивать вход ончейн-платежом. Для небольших платежей это решение проигрывает Лайтнингу, но распространение у него намного шире. Ончейн-платежи можно добавить в настройках добавленных чатов (команда /chats).

Добавление оплаты входа ончейн.

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

Выбор метода оплаты.

Комиссия #

Комиссия бота составляет 5% от суммы оплаты.

Управление чатами #

Команда /chats в боте позволяет:

Просматривать все подключённые чаты.
Менять настройки подписки и стоимости.

Подписки и продление #

Месячная подписка автоматически продлевается, если на балансе в ZapGram или подключённом NWC-кошельке достаточно средств.
Если баланса недостаточно или автопродление отключено, бот отправит напоминание за сутки до окончания подписки.

Изменение условий подписки #

Новая цена и условия подписки применяются только к новым пользователям.
У активных подписчиков остается старая стоимость.

Контроль доступа #

Бот контролирует только пользователей, оплативших доступ через него. Если кто-то вошел в чат обходным путём, бот его игнорирует.

Подключение лайтнинг-кошельков #

Изначально ZapGram разрабатывался как исключительно некастодиальный мост, позволяющий использовать сеть Лайтнинг в популярном мессенджере Telegram. Для этого бот использует протокол NWC, позволяющий подсоединять лайтнинг-кошельки к миниприложениям и управлять подписками и всеми другими финансовыми взаимодействиями в сети из любимого кошелька или собственного узла.

Кастодиальный кошелёк появился в боте лишь для тех, кто пока не разобрался с настройкой отдельного кошелька и соединения “ЛН-кошелёк ↔ ZapGram”.

ZapGram позволяет подключить любой лайтнинг-кошелёк, поддеживающий NWC. Мы советуем одно из следующих решений:

Coinos (бесплатный кастодиальный кошелёк с открытым кодом и с поддержкой ончейн-платежей, Лайтнинг, eCash и Liquid).
Alby (предлагает платные облачные лайтнинг-узлы и возможность самостоятельно хостить AlbyHUB на своём устройстве).

С полным списком кошельков и приложений, поддерживающих NWC, можно ознакомиться здесь.

Пошаговая инструкция подключения NWC-кошелька #

Разберём переход на некастодиальное использование кошелька ZapGram через настройку подключениея кошелька Coinos с поддержкой протокола NWC.

Чтобы привязать свой кошелёк Coinos к ZapGram:

Перейдите в настройки кошелька, нажав на значок ⛭ напротив вашего кошелька на домашней странице:

Создайте новое соединение, где помимо названия можно указать бюджет и даже приемлемые комиссии.
Скопируйте строку соединения Nostr Connect (начинается с nostr+walletconnect:// и заканчивается @coinos.io):

Вставьте скопированную строку в ZapGram, перейдя в Настройки → Добавить кошелёк NWC.

В Alby и других кошельках с поддержкой NWC подключение производится аналогичным образом:
Создаём новое соединение, указывая нужные параметры и устанавливая необходимые ограничения;
Копируем строку соединения в настройках кошелька;
Вставляем в ZapGram и активируем NWC-кошелёк.

Готово! Вы можете пользоваться Телеграм-ботом ZapGram некастодиальным образом. Просто выберите Использовать NWC для отправки донатов в группах в настройках бота:

Итоги #

ZapGram – отличный инструмент для пользователей Телеграм и новичков, только знакомящихся с возможностями сети Лайтнинг. Вы можете не только отправить немного сат пользователю Телеграм, не знакомому с Лайтнинг, но и управлять подписками, а также использовать микроплатежи для обмена донатами и блокировки спама в своих чатах.

Предложить улучшения и оставить фидбэк можно @vmozharov.

Телеграм-бот ZapGram с поддержкой сети Лайтнинг