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

Гид подготовлен Тони⚡️.

Поддержать проект.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

⚡️ Протестировать отправку сат и поддержать проект можно, нажав эту 👇 кнопку:

Поддержать создание образовательных материалов

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

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

/tip <сумма> 

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

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

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

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

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

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

Чтобы активировать платный вход в чат или канал:

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

Комиссия #

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

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

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

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

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

• Месячная подписка автоматически продлевается, если на балансе в ZapGram достаточно средств (скоро добавится поддержка NWC).
• Если баланса недостаточно или автопродление отключено, бот отправит напоминание за сутки до окончания подписки.

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

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

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

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

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

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

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

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

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

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

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

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

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

1. Перейдите в настройки кошелька, нажав на значок “⚙️” напротив вашего кошелька на домашней странице:

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

3. Скопируйте строку соединения Nostr Connect (начинается с nostr+walletconnect:// и заканчивается @coinos.io):

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

В Alby и других кошельках с поддержкой NWC подключение производится аналогичным образом:

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

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

Итоги #

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

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