가이드

레시피: Telegram 봇

봇 명령, 역할, 비공개 그룹을 파세요. 사용자마다 자기 청구서를 받고, 서명된 웹훅이 이용권을 엽니다.

봇은 돈을 보지 않습니다. /buy에서 사용자에게 그 사람만의 청구서 링크를 보내고, 내 서버가 invoice.fulfilled를 듣고 이용권을 엽니다. 모든 유료 명령이 Perly Pay에 묻기 때문에 재시작해도 잃는 것이 없습니다. Discord도 같은 방식, 역할로.

어시스턴트와 함께: 이 레시피는 Perly Pay 플러그인의 sell-bot-access 스킬이 내 프로젝트에서 실행합니다. 실행 가능한 예제는 플러그인 저장소의 examples/telegram-bot(MIT)입니다.

작동 방식

1
상품과 가격
1회 또는 평생은 '영구', 기간제는 이용권, 구독은 청구서로 갱신되는 멤버십.
2
채팅 사용자마다 고객
external_id: "tg:<user id>". 이메일은 구독일 때만 물으세요: 갱신 청구서가 그리로 갑니다.
3
/buy
metadata에 채팅 ID를 넣은 청구서를 버튼으로 보냅니다. 멱등성 키 덕분에 사용자당 하루 청구서 하나.
4
이용권 열기
invoice.fulfilled에서 metadata의 채팅 ID를 꺼내 답하세요: 메시지, 1회용 초대, 역할.
5
유료 명령
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 }]] } });

예제 실행

1
설치
examples/telegram-bot에서 npm install(Node 20.12+).
2
키
.env.example을 .env로 복사하고 PERLY_PAY_SECRET_KEY에 테스트 키(sk_test_…)를 넣으세요.
3
준비
npm run setup이 내 키로 상품과 가격을 만들고 .env용 ID를 출력합니다.
4
실행
README에 적힌 대로 npm start(또는 npm run dev).
5
지갑 없이 결제
봇에게 /buy를 보내고, Pay를 열어 Simulate payment를 누르세요: 봇이 "Payment confirmed"라고 하고 /secret이 답합니다.

함정

모두에게 같은 결제 링크 하나: 누가 결제했는지 알 수 없습니다. 사용자마다 채팅 ID를 담은 청구서를.
사용자가 "결제했어요"를 누르면 이용권 열기. 여는 것은 웹훅이나 entitlements.check뿐입니다.
봇 메모리에 둔 이용권. 재시작하면 사라집니다. Perly Pay에 물으세요.