Telegram 権限

Telegram entitlementにより、支払い済みの顧客は非公開のTelegramグループまたはチャンネルにアクセスできます。顧客はCustomer PortalでTelegramアカウントをリンクし、Dodo Payments Telegram botは、そのアカウントに対してのみ承認する参加リクエストリンクを送信します。grantが取り消されると、botは顧客をチャットから削除します。

配信される内容

Grant は Pending で作成されます。顧客が Telegram アカウントをリンクし、ボットが参加リクエストリンクを発行した後も、Pending のままです。
Customer Portal で、顧客は Connect をクリックし、Telegram ユーザー ID を取得するために /start を Dodo Payments ボットに送信し、ID を入力して Link account をクリックします。
ボットは Telegram で顧客に参加リクエストリンクを送信します。顧客が参加をリクエストすると、ボットはリンクされたアカウントに対してのみリクエストを承認します。
キャンセル、返金、または手動での revoke が行われると、ボットは顧客をチャットから削除し、ban します。再度購入した場合、ボットは新しいリンクを送信する前に ban を解除します。

一般的な使い道には、プライベートアルファチャンネル、有料シグナルグループ、コミュニティ層の特典があります。

Telegramの接続

Open Entitlements

Dodo Payments dashboardで、Entitlementsに移動して**+をクリックし、integrationとしてTelegram Access**を選択します。dashboardでTelegram user IDの入力を求められます。このIDにより、botを追加したチャットとビジネスがリンクされます。

TelegramユーザーIDとTelegram接続ボタンのプロンプトを表示する新しい権限Telegramアクセスフォーム — New Entitlement → Telegram Access. The dashboard needs your Telegram user ID before it lists chats.

次の2つの手順はTelegramで行います。user IDの取得と、チャットへのbotのadminとしての追加は、どちらを先に行ってもかまいません。両方が完了したら、最後の手順のためにdashboardに戻ります。

Get Your Telegram User ID

Telegramで、次の宛先に**/start**を送信します。

@dodo_payments_bot を使用する場合、ライブモード
@DodoPaymentsTestBot を使用する場合、テストモード

botが数値のTelegram user IDを返信します。これをコピーします。最後の手順でdashboardに貼り付けます。

Add the Bot to Your Chat as an Admin

同じTelegramアカウントから、アクセス制限するグループまたはチャンネルを開き、同じbotをadminとして追加します（live modeでは@dodo_payments_bot、test modeでは@DodoPaymentsTestBot）。次の2つの権限を有効にします。

Ban Users：revoke時にメンバーを削除するために必要です。
Add Users：支払い済みの顧客を招待するために必要です。

他の管理権限はすべてオフにしてください。

Ban UsersとAdd UsersがDodo Paymentsボットのために有効になっているTelegram管理者に昇格画面 — Telegram → Promote to admin. Only Ban Users and Add Users need to be enabled.

Connect Telegram and Pick the Chat

dashboardに戻り、手順2で取得したuser IDをTelegram User IDに貼り付けて、Connect Telegramをクリックします。Chat pickerには、そのアカウントからbotを追加したグループとチャンネルが一覧表示されます。アクセス制限するチャットを選択し、entitlementのNameを入力して、Create Entitlementをクリックします。

顧客フロー

顧客がcheckoutを完了します。
Dodo PaymentsがPending grantを作成します。まだinvite linkは存在しません。
支払い確認メールにはentitlementがAction Requiredとして記載され、Customer Portalへのリンクが表示されます。portalで顧客はConnectをクリックし、botに/startを送信してTelegram user IDを入力し、Link accountをクリックします。
botがTelegramで顧客に参加リクエストリンクを送信します。顧客がリンクを開いて参加をリクエストすると、botがリクエストを承認します。
revoke時に、botが顧客をチャットから削除します。

botは、顧客がリンクしたTelegramアカウントからの参加リクエストのみを承認します。転送されたリンクを使っても、他のユーザーはアクセスできません。既存のgrantでリンクされたアカウントを変更することはできません。

必須設定

Field	Required	Description
`chat_id`	Yes	Telegram chat ID（数値。グループやチャンネルでは負の値になることがよくあります）。dashboardのchat pickerが自動入力します。

APIによる作成

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
  environment: 'test_mode',
});

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

import os
from dodopayments import DodoPayments

client = DodoPayments(
    bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"),
    environment="test_mode",
)

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

// client is a *dodopayments.Client, for example from
// dodopayments.NewClient(option.WithEnvironmentTestMode()); ctx is a context.Context.
client.Entitlements.New(ctx, dodopayments.EntitlementNewParams{
  Name:            dodopayments.F("Premium Signals Group"),
  IntegrationType: dodopayments.F(dodopayments.EntitlementIntegrationTypeTelegram),
  IntegrationConfig: dodopayments.F[dodopayments.IntegrationConfigUnionParam](
    dodopayments.IntegrationConfigTelegramConfigParam{
      ChatID: dodopayments.F("-1001234567890"),
    },
  ),
})

Webhooks

entitlement_grant.* webhook events を参照してください。Telegram の grant は Pending で届き、顧客が Telegram アカウントをリンクした後も Pending のままです。grant が delivered 状態の顧客がチャットから退出すると、Dodo Payments は revocation_reason: platform_external で grant を revoke します。

トラブルシューティング

Chat doesn't appear in the picker

Dodo Payments botをadminとしてチャットに追加し、Add Usersを有効にします。dashboardにuser IDを入力したTelegramアカウントから操作してください。botがadminになると、チャットがpickerに表示されます。

Customer says the invite link doesn't work

ボットは、リンクされた Telegram アカウントからの参加リクエストのみを承認します。そのアカウントからリンクを開くよう顧客に依頼してください。Grant の revoke は取り消せません。revoke された grant は再発行できないため、新しい grant を取得するには顧客が新たに購入する必要があります。

Customer cancelled but is still in the chat

メンバーを削除するには、ボットに Ban Users 管理者権限が必要です。チャット設定を開き、Dodo Payments ボットで Ban Users と Add Users の両方が有効になっていることを確認してください。

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

配信される内容

Telegramの接続

顧客フロー

必須設定

APIによる作成

Webhooks

トラブルシューティング

​配信される内容

​Telegramの接続

​顧客フロー

​必須設定

​APIによる作成

​Webhooks

​トラブルシューティング

配信される内容

Telegramの接続

顧客フロー

必須設定

APIによる作成

Webhooks

トラブルシューティング