استحقاق تيليجرام

​

ما يتم تقديمه

• يتم إنشاء المنحة في Pending. وتظل في Pending بعد أن يربط العميل حسابه على Telegram ويُصدر البوت رابط طلب الانضمام.
• في Customer Portal، ينقر العميل على Connect، ويرسل /start إلى بوت Dodo Payments للحصول على معرّف مستخدم Telegram الخاص به، ثم يُدخله وينقر على Link account.
• يرسل البوت إلى العميل رابط طلب الانضمام في Telegram. وعندما يطلب العميل الانضمام، يوافق البوت على الطلب لحساب العميل المرتبط فقط.
• عند الإلغاء أو استرداد الأموال أو الإلغاء اليدوي، يزيل البوت العميل من الدردشة ويحظره. وإذا اشترى العميل مرة أخرى، يرفع البوت الحظر قبل إرسال رابط جديد.

​

ربط تيليجرام

1

Open Entitlements

في لوحة تحكم Dodo Payments، انتقل إلى Entitlements وانقر على +، ثم اختر Telegram Access باعتباره التكامل. تطلب لوحة التحكم منك Telegram user ID، الذي يربط الدردشات التي تضيف إليها الروبوت بنشاطك التجاري.

تحدث الخطوتان التاليتان في Telegram، ويمكنك تنفيذهما بأي ترتيب: الحصول على user ID وإضافة الروبوت إلى الدردشة بصفته مسؤولًا. بعد إكمال الخطوتين، عد إلى لوحة التحكم لتنفيذ الخطوة الأخيرة.

2

Get Your Telegram User ID

في Telegram، أرسل /start إلى:

• @dodo_payments_bot إذا كنت تستخدم وضع الحياة
• @DodoPaymentsTestBot إذا كنت تستخدم وضع الاختبار

يرد الروبوت باستخدام Telegram user ID الرقمي الخاص بك. انسخه، ثم الصقه في لوحة التحكم في الخطوة الأخيرة.

3

Add the Bot to Your Chat as an Admin

من حساب Telegram نفسه، افتح المجموعة أو القناة التي تريد تقييد الوصول إليها، ثم أضف الروبوت نفسه بصفته مسؤولًا (@dodo_payments_bot للوضع المباشر، و@DodoPaymentsTestBot لوضع الاختبار). فعّل هذين الإذنين:

• Ban Users: مطلوب لإزالة الأعضاء عند إلغاء المنحة.
• Add Users: مطلوب لدعوة العملاء الذين يدفعون.

اترك كل إذن مسؤول آخر مغلقًا.

4

Connect Telegram and Pick the Chat

ارجع إلى لوحة التحكم، والصق user ID من الخطوة 2 في Telegram User ID، ثم انقر على Connect Telegram. تعرض قائمة Chat المجموعات والقنوات التي أضفت إليها الروبوت من ذلك الحساب. اختر الدردشة التي تريد تقييد الوصول إليها، وأدخل Name للاستحقاق، ثم انقر على Create Entitlement.

​

تدفق العميل

1. يُكمل العميل عملية الدفع.
2. ينشئ Dodo Payments منحة Pending. لا يوجد رابط دعوة بعد.
3. يعرض بريد تأكيد الدفع الاستحقاق بالحالة Action Required ويربطه بـ Customer Portal. في البوابة، ينقر العميل على Connect، ويرسل /start إلى الروبوت، ويدخل Telegram user ID الخاص به، ثم ينقر على Link account.
4. يرسل الروبوت إلى العميل رابط طلب انضمام في Telegram. يفتح العميل الرابط ويطلب الانضمام، ثم يوافق الروبوت على الطلب.
5. عند إلغاء المنحة، يزيل الروبوت العميل من الدردشة.

​

الإعدادات المطلوبة

​

الإنشاء عبر 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"),
    },
  ),
})

​

الويب هوكس

​

استكشاف الأخطاء وإصلاحها