Quyền truy cập Telegram

Nội dung được cung cấp

• Grant được tạo trong Pending. Grant vẫn ở trạng thái đó sau khi khách hàng liên kết tài khoản Telegram và bot gửi liên kết yêu cầu tham gia.
• Trong Customer Portal, khách hàng nhấp vào Kết nối, gửi /start cho bot Dodo Payments để lấy Telegram user ID, nhập ID đó rồi nhấp vào Liên kết tài khoản.
• Bot gửi cho khách hàng một liên kết yêu cầu tham gia trong Telegram. Khi khách hàng yêu cầu tham gia, bot chỉ phê duyệt yêu cầu cho tài khoản đã liên kết của họ.
• Khi hủy, hoàn tiền hoặc thu hồi thủ công, bot xóa khách hàng khỏi cuộc trò chuyện và cấm họ tham gia. Nếu họ mua lại, bot gỡ lệnh cấm trước khi gửi liên kết mới.

Kết nối Telegram

1

Open Entitlements

Trong dashboard Dodo Payments, đi đến Entitlements và nhấp vào +, sau đó chọn Telegram Access làm integration. Dashboard yêu cầu Telegram user ID của bạn; ID này liên kết các cuộc trò chuyện mà bạn thêm bot vào với doanh nghiệp của bạn.

Hai bước tiếp theo diễn ra trong Telegram và bạn có thể thực hiện theo thứ tự bất kỳ: lấy user ID của bạn và thêm bot vào cuộc trò chuyện với vai trò admin. Khi hoàn tất cả hai bước, quay lại dashboard để thực hiện bước cuối cùng.

2

Get Your Telegram User ID

Trong Telegram, gửi /start đến:

• @dodo_payments_bot nếu bạn đang sử dụng Live Mode
• @DodoPaymentsTestBot nếu bạn đang sử dụng Test Mode

Bot sẽ trả lời bằng Telegram user ID dạng số của bạn. Hãy sao chép ID này. Bạn sẽ dán ID vào dashboard ở bước cuối cùng.

3

Add the Bot to Your Chat as an Admin

Từ cùng tài khoản Telegram, mở nhóm hoặc kênh mà bạn muốn giới hạn quyền truy cập và thêm chính bot đó làm admin (@dodo_payments_bot cho chế độ live, @DodoPaymentsTestBot cho chế độ test). Bật hai quyền sau:

• Ban Users: bắt buộc để xóa thành viên khi thu hồi.
• Add Users: bắt buộc để mời khách hàng đã thanh toán.

Tắt tất cả các quyền admin còn lại.

4

Connect Telegram and Pick the Chat

Quay lại dashboard, dán user ID từ bước 2 vào Telegram User ID và nhấp vào Connect Telegram. Bộ chọn Chat liệt kê các nhóm và kênh mà bạn đã thêm bot vào từ tài khoản đó. Chọn cuộc trò chuyện mà bạn muốn giới hạn quyền truy cập, nhập Name cho entitlement rồi nhấp vào Create Entitlement.

Quy trình của khách hàng

1. Khách hàng hoàn tất checkout.
2. Dodo Payments tạo một grant Pending. Chưa có liên kết mời nào.
3. Email xác nhận thanh toán liệt kê entitlement ở trạng thái Action Required và liên kết đến Customer Portal. Trong portal, khách hàng nhấp vào Connect, gửi /start đến bot, nhập Telegram user ID của họ rồi nhấp vào Link account.
4. Bot gửi cho khách hàng một liên kết yêu cầu tham gia trong Telegram. Khách hàng mở liên kết và yêu cầu tham gia, sau đó bot phê duyệt yêu cầu.
5. Khi bị thu hồi, bot sẽ xóa khách hàng khỏi cuộc trò chuyện.

Cấu hình bắt buộc

Tạo qua 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

Khắc phục sự cố