メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt

Use this file to discover all available pages before exploring further.

Telegramの権限により、支払いを行った顧客がプライベートチャットやチャンネルにアクセスできます。Dodo PaymentsのTelegramボットは、各顧客に一回限りの招待リンクを生成し、キャンセル時に削除します。

何が提供されるか

  • ボットが招待を準備する間、権限は pending に作成され、リンクが準備できると delivered に移行します。
  • 顧客は、配信メールとカスタマーポータルで一回限りのTelegram招待リンクを受け取ります。
  • リンクをタップすると、ボットが設定されたチャットに追加します。
  • キャンセル、返金、または手動の取り消し時には、ボットがチャットから削除します。
一般的な使い道には、プライベートアルファチャンネル、有料シグナルグループ、コミュニティ層の特典があります。

Telegramの接続

1

Open Entitlements

Dodo PaymentsダッシュボードでEntitlementsに移動し、+をクリックしてからTelegram Accessを統合として選択します。ダッシュボードは、ボットが管理するチャットの所有権を確認するためにTelegramユーザーIDを求めます。
TelegramユーザーIDとTelegram接続ボタンのプロンプトを表示する新しい権限Telegramアクセスフォーム
次の2つのステップはTelegramでのセットアップタスクで、順序は自由です。ユーザーIDを取得して、ボットを管理者としてチャットに追加します。両方が完了したら、ダッシュボードに戻って最終ステップを実施してください。
2

Get your Telegram user ID

Telegramで /start にメッセージを送信します:
  • @dodo_payments_bot を使用する場合、ライブモード
  • @DodoPaymentsTestBot を使用する場合、テストモード
ボットが数値のTelegramユーザーIDと共に返信します。それをコピーして、最後のステップでダッシュボードに貼り付けます。
3

Add the bot to your chat as an admin

制限を掛けたいTelegramグループまたはチャンネルで、メンバーリストを開き、管理者として同じボットを追加します(ライブの場合は @dodo_payments_bot、テストの場合は @DodoPaymentsTestBot)この2つの権限を有効にしてください:
  • Ban Users — 取り消し時にメンバーを削除するために必要です
  • Add Users — 支払いを行った顧客を招待するために必要です
他の管理権限はすべてオフにしてください。
Ban UsersとAdd UsersがDodo Paymentsボットのために有効になっているTelegram管理者に昇格画面
4

Connect Telegram and pick the chat

ダッシュボードに戻り、ステップ2からのユーザーIDをTelegramユーザーIDに貼り付け、Connect Telegramをクリックします。チャットピッカーには、ボットが管理者としているすべてのグループとチャンネルがリストされます。制限を掛けたいものを選択して、権限に名前を付け、Create Entitlementをクリックします。

顧客フロー

  1. 顧客がチェックアウトを完了します。
  2. Dodo Paymentsが pending 権限を作成し、ボットに設定されたチャットへの一回限りの招待リンクを生成するよう依頼します。
  3. リンクの準備が整うと、権限は delivered に移行し、リンクは配信メールとカスタマーポータルに含まれます。
  4. 顧客がリンクをタップしてチャットに追加されます。
  5. 取り消し時には、ボットが顧客をチャットから削除します。
招待リンクは一回限りで、顧客が参加した後に無効になります。参加前にリンクを失った場合は、配信メールを再送信するか、ダッシュボードから権限を取り消して再作成してください。

必要な構成

フィールド必須説明
chat_idはいTelegramチャットID(数値、グループ/チャンネルの場合は多くの場合負)。ダッシュボードのピッカーによって自動入力されます。

APIによる作成

const entitlement = await client.entitlements.create({
  name: 'Premium Signals Group',
  integration_type: 'telegram',
  integration_config: {
    chat_id: '-1001234567890',
  },
});

Webhooks

entitlement_grant.* webhookイベントを参照してください。Telegramの権利は pending として到着し、ボットが招待リンクを発行すると delivered に移行します。

トラブルシューティング

Dodo Paymentsボットは、Add Usersが有効な管理者としてチャットに追加されなければなりません。ピッカーは実際の状態を読み込み、ボットが管理者になるとチャットが表示されます。
ボットはメンバーを削除するためにBan Users管理権限が必要です。チャット設定を開き、Dodo PaymentsボットにBan UsersAdd Usersの両方の権限がチェックされていることを確認してください。
Last modified on May 14, 2026