支払いと残高
GetMyBot には2つの異なる「支払い」の流れがあります。プラットフォームのリクエスト残高(ボット動作のコスト)と、Telegram を通じてボットのユーザーから支払いを受け取る機能です。お支払いセクション(「支払い受け取り」とも)でプランと残高を管理します。
ボットの課金方法
プラットフォームはリクエスト単位で動作をカウントします。ボットが配信する各メッセージがアカウント残高から1リクエストを消費します。残高は整数カウンターで、不変のクレジット・デビットジャーナル(登録時のボーナス、プランのクレジット、チャージ、消費)がデータの信頼できる情報源です。
プランと残高
お支払いセクションには現在の残高と利用可能なプランが表示されます。各プランには名前、価格、リクエスト量、制限(例: 最大ボット数)があります。選択ボタンでプランを有効化できます。
- 残高 — 現在のリクエスト残数(概要と統計画面にも表示されます)。
- 見込み日数 — 統計画面に表示され、現在の消費ペースで残高が何日持つかを推定します。
クレジットジャーナル(ledger)
リクエスト残高は整数カウンターですが、その信頼できる情報源は不変の操作ジャーナル(ledger)です。残高のすべての変更がここに記録されます:
- 登録ボーナス — 新しいアカウントへの初期リクエスト量。
- プランクレジット — プランを有効化した際に付与されるリクエスト。
- チャージ — 追加購入したリクエスト。
- 消費 — ボットが配信する各メッセージにつき1リクエストの控除。
ジャーナルは追記のみ(既存レコードは変更されない)のため、支出とクレジットの履歴はいつでも確認できます。現在の残高はジャーナルの合計です。
チャージ
チャージは必要なリクエスト量の支払いを作成します。プロバイダーによる確認後、残高が自動的かつ冪等に付与されます(重複したコールバックでも二重付与されません)。具体的な支払いプロバイダーはインスタンスの設定によります。
ユーザーからの支払い受け取り(Telegram Payments)
ボットは Telegram の支払いを受け取って記録できます:
pre_checkout_queryは自動的に承認されます。- 成功した支払い(
successful_payment)が記録され(金額、通貨、取引 ID、ペイロード)、その後リアクションをトリガーできます。例えば、アクセスを付与したり、「支払済み」ラベルを設定したり、注文をコレクションに記録するなど。
成功した支払いの合計金額は 分析 の「支払い」で確認できます。
請求書の発行(sendInvoice)とコンストラクターの 「支払い受け取り」 / 「通知」 ボタンは現在「近日公開」とマークされています。ボットは受信した支払いを記録できますが、現バージョンではリアクションから請求書を発行することはできません。