الانتقال إلى المحتوى الرئيسي

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.

يوفر استحقاق تيليجرام للعملاء المشترين الوصول إلى دردشة أو قناة خاصة. يقوم بوت Dodo Payments تيليجرام بإنشاء رابط دعوة لمرة واحدة لكل عميل ويقوم بإزالتهم في حالة الإلغاء.

ما يتم تسليمه

  • يتم إنشاء المنحة في pending بينما يقوم البوت بتجهيز الدعوة، ثم تنتقل إلى delivered بمجرد أن يكون الرابط جاهزًا.
  • يتلقى العميل رابط دعوة تيليجرام لمرة واحدة في بريد التسليم الإلكتروني ومحور العميل.
  • يقومون بالنقر على الرابط ويضيفهم البوت إلى الدردشة المكونة.
  • في حالة الإلغاء أو الاسترداد أو الإلغاء اليدوي، يقوم البوت بإزالتهم من الدردشة.
تشمل الاستخدامات الشائعة القنوات الخاصة الفا، مجموعات الإشارات المدفوعة، وامتيازات المستوى المجتمعي.

ربط تيليجرام

1

Open Entitlements

في لوحة تحكم Dodo Payments الخاصة بك، اذهب إلى استحقاقات وانقر على +، ثم اختر وصول تيليجرام كالتكامل. تطلب لوحة التحكم معرف المستخدم تيليجرام الخاص بك حتى يتمكن البوت من التحقق من ملكية الدردشات التي يديرها.
نموذج وصول جديد للاستحقاق في تيليجرام يطالب بمعرف المستخدم في تيليجرام وزر ربط تيليجرام
الخطوتان التاليتان هما مهام إعداد على تيليجرام ويمكن إتمامهما بأي ترتيب — احصل على معرف المستخدم الخاص بك وأضف البوت إلى الدردشة الخاصة بك كمسؤول. بمجرد الانتهاء من كلاهما، ارجع إلى لوحة التحكم للخطوة النهائية.
2

Get your Telegram user ID

على تيليجرام، أرسل رسالة إلى /start إلى:
  • @dodo_payments_bot إذا كنت تستخدم وضع الحياة
  • @DodoPaymentsTestBot إذا كنت تستخدم وضع الاختبار
يرد البوت بمعرف تيليجرام الرقمي الخاص بك. انسخه — ستلصقه في لوحة التحكم في الخطوة الأخيرة.
3

Add the bot to your chat as an admin

في المجموعة أو القناة في تيليجرام التي تريد جعلها مقيدة، افتح قائمة الأعضاء وأضف نفس البوت كمسؤول (@dodo_payments_bot في الوضع المباشر، @DodoPaymentsTestBot للاختبار) مع تمكين هذين الإذنين:
  • حظر المستخدمين — مطلوب لإزالة الأعضاء عند الإلغاء
  • إضافة المستخدمين — مطلوب لدعوة العملاء المشتركين
اترك كل إذن مسؤول آخر مغلقًا.
شاشة ترقيه تيليجرام إلى مسؤول تظهر تفعيل حظر المستخدمين وإضافة المستخدمين لروبوت Dodo Payments
4

Connect Telegram and pick the chat

عد إلى لوحة التحكم، الصق معرف المستخدم من الخطوة 2 في معرف مستخدم تيليجرام وانقر على ربط تيليجرام. الآن يعرض مختار الدردشة كل مجموعة وقناة حيث البوت هو مسؤول — اختر ما تريد قفله، أعط الاستحقاق اسمًا، وانقر على إنشاء استحقاق.

تدفق العملاء

  1. يكمل العميل عملية الدفع.
  2. يقوم Dodo Payments بإنشاء pending ومن ثم يطلب من البوت توليد رابط دعوة لمرة واحدة إلى الدردشة المكونة.
  3. بمجرد أن يكون الرابط جاهزًا، تنتقل المنحة إلى delivered ويتم تضمين الرابط في بريد التسليم الإلكتروني ومحور العميل.
  4. ينقر العميل على الرابط ويتم إضافته إلى الدردشة.
  5. عند الإلغاء، يقوم البوت بإزالة العميل من الدردشة.
رابط الدعوة للاستخدام لمرة واحدة وينتهي بعد انضمام العميل. إذا فقدوا الرابط قبل الانضمام، أعد إنشائه بإعادة إرسال بريد التسليم الإلكتروني أو بإلغاء واستعادة المنحة من لوحة التحكم.

التكوين المطلوب

الحقلمطلوبالوصف
chat_idنعممعرف دردشة تيليجرام (رقمي، وغالبًا ما يكون سالب للمجموعات/القنوات). يملأ مختار اللوحة هذا بالنيابة عنك.

الإنشاء عبر API

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

الويب هوكس

راجع أحداث الويب هوكس entitlement_grant.*. تصل منح تيليجرام pending وتنتقل إلى delivered بمجرد أن يصدر البوت رابط الدعوة.

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

يجب إضافة بوت Dodo Payments إلى الدردشة كمسؤول مع تمكين إضافة المستخدمين. يقرأ المختار الحالة الحية، لذا تظهر الدردشة بمجرد أن يكون البوت مسؤولاً.
يحتاج البوت إلى إذن مسؤول حظر المستخدمين لإزالة الأعضاء. افتح إعدادات الدردشة وتأكد من تمكين حظر المستخدمين وإضافة المستخدمين على بوت Dodo Payments.
Last modified on May 14, 2026