Przejdź do treści
Perly
ZacznijZacznij za darmo

Poradniki

Przepis: bot w Telegramie

Sprzedawaj komendy bota, rolę lub prywatną grupę. Każdy użytkownik dostaje własną fakturę; podpisany webhook otwiera dostęp.

Otwórz jako Markdown

Bot nie widzi pieniędzy. Na /buy wysyła użytkownikowi jego własny link do faktury; Twój serwer słyszy invoice.fulfilled i otwiera dostęp. Każda płatna komenda pyta Perly Pay, więc po restarcie nic nie ginie. Discord — tak samo, przez rolę.

Z asystentem: ten przepis realizuje w Twoim projekcie skill sell-bot-access wtyczki Perly Pay. Działający przykład to examples/telegram-bot (MIT) w repozytorium wtyczki.

Jak to działa

  1. 1

    Produkt i cena

    Jednorazowa lub dożywotnia — „na zawsze”, okresowa — dla przepustek, subskrypcja — dla członkostwa z odnowieniem fakturą.

  2. 2

    Klient dla każdego użytkownika czatu

    external_id: "tg:<user id>". O e-mail pytaj tylko przy subskrypcjach: tam idą odnowienia.

  3. 3

    /buy

    Faktura z identyfikatorem czatu w metadata, wysłana przyciskiem. Jedna faktura na użytkownika na dzień — dzięki kluczowi idempotencji.

  4. 4

    Otwórz dostęp

    Na invoice.fulfilled weź identyfikator czatu z metadata i odpowiedz: wiadomość, jednorazowe zaproszenie, rola.

  5. 5

    Płatne komendy

    entitlements.check({ customer_external_id: "tg:<id>", product }).

/buy
const invoice = await pay.invoices.create(
  { line_items: [{ price: PRICE }], customer: customer.id, metadata: { chat_id: String(chatId) } },
  { idempotencyKey: `buy-${userId}-${today}` },
);
await tg("sendMessage", { chat_id: chatId, text: "Pay:", reply_markup: { inline_keyboard: [[{ text: "Pay", url: invoice.url }]] } });

Uruchom przykład

  1. 1

    Zainstaluj

    npm install w examples/telegram-bot (Node 20.12+).

  2. 2

    Klucz

    Skopiuj .env.example do .env i wpisz klucz testowy (sk_test_…) w PERLY_PAY_SECRET_KEY.

  3. 3

    Przygotuj

    npm run setup tworzy produkt i cenę Twoim kluczem i drukuje ich identyfikatory do .env.

  4. 4

    Uruchom

    npm start (lub npm run dev), jak mówi jego README.

  5. 5

    Zapłać bez portfela

    Napisz do bota /buy, otwórz Pay i kliknij Simulate payment: bot napisze „Payment confirmed”, a /secret odpowie.

Pułapki

  • Jeden wspólny link do płatności dla wszystkich: nie widać, kto zapłacił. Faktura dla każdego, z identyfikatorem czatu.
  • Otwieranie dostępu, gdy użytkownik kliknął „Zapłaciłem”. Otwiera tylko webhook albo entitlements.check.
  • Dostęp w pamięci bota. Po restarcie go nie ma; pytaj Perly Pay.