Telegramの権限により、支払いを行った顧客がプライベートチャットやチャンネルにアクセスできます。Dodo PaymentsのTelegramボットは、各顧客に一回限りの招待リンクを生成し、キャンセル時に削除します。
何が提供されるか
- ボットが招待を準備する間、権限は
pendingに作成され、リンクが準備できるとdeliveredに移行します。 - 顧客は、配信メールとカスタマーポータルで一回限りのTelegram招待リンクを受け取ります。
- リンクをタップすると、ボットが設定されたチャットに追加します。
- キャンセル、返金、または手動の取り消し時には、ボットがチャットから削除します。
Telegramの接続
1
Open Entitlements
Dodo PaymentsダッシュボードでEntitlementsに移動し、+をクリックしてからTelegram Accessを統合として選択します。ダッシュボードは、ボットが管理するチャットの所有権を確認するためにTelegramユーザーIDを求めます。
New Entitlement → Telegram Access. The dashboard needs your Telegram user ID before it lists chats.
2
Get your Telegram user ID
Telegramで
/start にメッセージを送信します：@dodo_payments_botを使用する場合、ライブモード@DodoPaymentsTestBotを使用する場合、テストモード
3
Add the bot to your chat as an admin
制限を掛けたいTelegramグループまたはチャンネルで、メンバーリストを開き、管理者として同じボットを追加します（ライブの場合は 
@dodo_payments_bot、テストの場合は @DodoPaymentsTestBot）この2つの権限を有効にしてください：- Ban Users — 取り消し時にメンバーを削除するために必要です
- Add Users — 支払いを行った顧客を招待するために必要です
Telegram → Promote to admin. Only Ban Users and Add Users need to be enabled.
4
Connect Telegram and pick the chat
ダッシュボードに戻り、ステップ2からのユーザーIDをTelegramユーザーIDに貼り付け、Connect Telegramをクリックします。チャットピッカーには、ボットが管理者としているすべてのグループとチャンネルがリストされます。制限を掛けたいものを選択して、権限に名前を付け、Create Entitlementをクリックします。
顧客フロー
- 顧客がチェックアウトを完了します。
- Dodo Paymentsが
pending権限を作成し、ボットに設定されたチャットへの一回限りの招待リンクを生成するよう依頼します。 - リンクの準備が整うと、権限は
deliveredに移行し、リンクは配信メールとカスタマーポータルに含まれます。 - 顧客がリンクをタップしてチャットに追加されます。
- 取り消し時には、ボットが顧客をチャットから削除します。
必要な構成
APIによる作成
Webhooks
entitlement_grant.* webhookイベントを参照してください。Telegramの権利は pending として到着し、ボットが招待リンクを発行すると delivered に移行します。
トラブルシューティング
Chat doesn't appear in the picker
Chat doesn't appear in the picker
Dodo Paymentsボットは、Add Usersが有効な管理者としてチャットに追加されなければなりません。ピッカーは実際の状態を読み込み、ボットが管理者になるとチャットが表示されます。
Customer says the invite link doesn't work
Customer says the invite link doesn't work
Telegramの一回限りのリンクは初回使用後に失効します。顧客がログアウトしたデバイスでタップしたり、リンクを失った場合は、権限を取り消して再発行します。
Customer cancelled but is still in the chat
Customer cancelled but is still in the chat
ボットはメンバーを削除するためにBan Users管理権限が必要です。チャット設定を開き、Dodo PaymentsボットにBan UsersとAdd Usersの両方の権限がチェックされていることを確認してください。