Telegram Stars API للمبيعات الآلية
الإجابة المختصرة
Telegram Stars هي العملة داخل تطبيق منصّة تيليجرام، تُستخدم للدفع مقابل السلع الرقمية المباعة داخل بوتات وقنوات تيليجرام، وفتح ميزات Telegram Premium، وإرسال التفاعلات، وإكرام صنّاع المحتوى. يستطيع البائعون بيع Telegram Stars عبر API بقبول معرّف مستخدم تيليجرام للمشتري وإضافة Stars مباشرةً إلى حسابه. مع أكثر من 900 مليون مستخدم لتيليجرام عالميًا، تُعدّ Stars منتج شحن سريع النمو بطلب قوي من مستخدمي تيليجرام النشطين.
التعريف: إعادة بيع Telegram Stars عبر API يعني شراء Telegram Stars بالجملة من مورّد B2B وتسليمها مباشرةً إلى حساب المشتري في تيليجرام عبر معرّف المستخدم — دون كود قابل للاسترداد، فالتسليم من حساب إلى حساب.
الخلاصة الأساسية: تتميّز Telegram Stars بموقع فريد لأن قناة بيع البائع غالبًا هي المنصّة ذاتها التي يستخدم فيها المشترون المنتج. بوت تيليجرام الذي يبيع Stars هو نفسه منتج تيليجرام — يستطيع المشتري شراء Stars داخل تيليجرام واستخدامها فورًا في تيليجرام. يخلق هذا حلقة شراء بلا احتكاك لا تستطيع السلع الرقمية الأخرى محاكاتها.
لمن هذا الدليل
- مشغّلو بوتات تيليجرام الذين يضيفون Stars كمنتج شحن
- البائعون الذين يستهدفون قاعدة مستخدمي تيليجرام النشطة
- المتاجر الإلكترونية التي تضيف Telegram Stars كوحدة SKU للسلع الرقمية
- المطوّرون الذين يبنون خطوط مبيعات آلية لـ Telegram Stars
كيف تعمل Telegram Stars
تُستخدم Telegram Stars (⭐) داخل نظام تيليجرام البيئي من أجل:
| حالة الاستخدام | عدد Stars المطلوب |
|---|---|
| شراء سلع رقمية في البوتات | يحدّده مالك البوت |
| اشتراك Telegram Premium | 1,000 Stars/شهر (توضيحي) |
| فتح إيموجي الملف الشخصي | متفاوت |
| إرسال stars لصنّاع المحتوى | أي مبلغ (إكرامية) |
| الدفع مقابل خدمات في التطبيقات المصغّرة | تحدّده الخدمة |
| إهداء مستخدم آخر | أي مبلغ |
تُشترى Stars بأموال حقيقية عبر تطبيق تيليجرام (بسعر تيليجرام القياسي) أو عبر بائعي طرف ثالث بأسعار قد تكون أقل — وهي فرصة البائع.
تدفّق الشحن عبر API
على خلاف بطاقات الهدايا، يتطلّب شحن Telegram Stars معرّف مستخدم تيليجرام للمشتري:
الخطوة 1: يقدّم المشتري معرّف مستخدمه في تيليجرام
(يوجد في تيليجرام — الإعدادات ← اضغط منطقة اسم المستخدم ← يظهر المعرّف الرقمي،
أو عبر @userinfobot)
الخطوة 2: تحقّق من معرّف المستخدم
POST /validate-user
{ "platform": "telegram", "user_id": "123456789" }
→ { "valid": true, "username": "@username" }
الخطوة 3: اعرض اسم المستخدم على المشتري للتأكيد
"جارٍ شحن @username — هل تؤكّد؟"
الخطوة 4: اقبل الدفع؛ ضع الطلب
POST /topup
{ "platform": "telegram", "user_id": "123456789", "stars": 500 }
→ { "order_id": "ORD-005", "status": "processing" }
الخطوة 5: تُضاف Stars إلى الحساب؛ أكّد للمشتري
مرجع باقات Stars (توضيحي)
تُباع Stars في حِزَم. تعتمد أحجام الباقات والتسعير على مورّدك. ما يلي توضيحي.
| الباقة | Stars | سعر التجزئة التقريبي |
|---|---|---|
| Starter | 50 | ~1.00$ |
| Small | 100 | ~2.00$ |
| Medium | 250 | ~4.50$ |
| Standard | 500 | ~8.50$ |
| Large | 1,000 | ~16.00$ |
| Mega | 2,500 | ~37.00$ |
| Ultra | 5,000 | ~70.00$ |
بسعر تيليجرام داخل التطبيق (مرجع توضيحي)، تُباع Stars بنحو 0.016–0.02$ للستار الواحد. يستطيع البائعون تقديم أسعار تنافسية، مما يجعل شحن الطرف الثالث جذّابًا للمستخدمين المتكرّرين.
بنية الهامش (توضيحي)
مثال توضيحي فقط. تعتمد الهوامش الفعلية على تسعير المورّد.
500 Stars — بوت تيليجرام بدفع TON/عملات مشفّرة:
| المتغيّر | المبلغ |
|---|---|
| ما يدفعه العميل (تجزئة) | 9.00$ |
| تكلفة الجملة | 8.25$ |
| الهامش الإجمالي | 0.75$ |
| رسوم الدفع (عملات مشفّرة، 0.5%) | 0.05$ |
| صافي الربح | 0.70$ |
| صافي الهامش | 7.8% |
500 Stars — متجر إلكتروني، دفع بالبطاقة:
| المتغيّر | المبلغ |
|---|---|
| ما يدفعه العميل (تجزئة) | 9.00$ |
| تكلفة الجملة | 8.25$ |
| رسوم الدفع (2.5%) | 0.23$ |
| صافي الربح | 0.52$ |
| صافي الهامش | 5.8% |
تتمتّع بوتات تيليجرام التي تقبل TON (العملة المشفّرة الأصلية لتيليجرام) أو المدفوعات المشفّرة بتكاليف معالجة دفع أقل ماديًا، مما يحسّن الهامش بشكل كبير على المنتجات صغيرة الفئة.
بيع Stars عبر بوت تيليجرام
القناة الطبيعية لـ Telegram Stars هي بوت تيليجرام. التدفّق الكامل:
يرسل المستخدم /buy إلى @StarResellBot
البوت: "كم عدد Stars؟ 100 | 250 | 500 | 1000"
المستخدم: 500
البوت: "أدخل معرّف مستخدمك في تيليجرام"
المستخدم: 123456789
البوت: "جارٍ شحن @username — هل هذا صحيح؟"
المستخدم: نعم
البوت: "اختر الدفع — [TON] [بطاقة] [عملات مشفّرة]"
المستخدم: TON
يرسل البوت فاتورة TON؛ يدفع المستخدم
يستدعي البوت API → وُضع الطلب → أُضيفت Stars
البوت: "✅ أُرسلت 500 Stars إلى @username. الطلب #ORD-005"
هذا التدفّق قابل للأتمتة بالكامل. مع API مورّد وإطار عمل بوت تيليجرام (Python — aiogram/python-telegram-bot؛ Node.js — telegraf)، يمكن بناء هذا البوت في أقل من أسبوع.
وسائل الدفع لبوتات Telegram Stars
| وسيلة الدفع | التكامل | الرسوم | الأنسب لـ |
|---|---|---|---|
| TON (Toncoin) | تكامل تيليجرام الأصلي | ~0.1–0.5% | الجمهور المتمكّن من العملات المشفّرة |
| Telegram Payments (Stripe) | مدمج | 2.5%+ | المشترون غير المستخدمين للعملات المشفّرة |
| البطاقة (بوّابة خارجية) | تكامل API | 2–3% | المشترون الدوليون |
| العملات المشفّرة (USDT، BTC عبر بوّابة) | تكامل API | 0.5–1% | المشترون المهتمّون بالخصوصية |
الفروق الأساسية عن منتجات الشحن الأخرى
| البُعد | Telegram Stars | PUBG UC | ML Diamonds |
|---|---|---|---|
| المنصّة | تيليجرام | لعبة جوّال | لعبة جوّال |
| معرّف الحساب | معرّف مستخدم تيليجرام | معرّف اللعبة + الخادم | معرّف اللعبة + المنطقة |
| ملاءمة قناة البيع | بوت تيليجرام (أصلي) | أي قناة | أي قناة |
| ملاءمة الدفع | TON / عملات مشفّرة | دفع محلي | دفع محلي |
| الجمهور | مستخدمو تيليجرام الكثيفون | لاعبو الجوّال | لاعبو الجوّال (جنوب شرق آسيا) |
قائمة التحقّق
- تأكّد من أن المورّد يوفّر API شحن Telegram Stars
- نفّذ جمع معرّف مستخدم تيليجرام في تدفّق الشراء
- تحقّق من معرّف المستخدم قبل قبول الدفع (اعرض اسم المستخدم للتأكيد)
- اقبل الدفع (يُوصى بـ TON في سياق بوت تيليجرام)
- ضع الطلب عبر API واستطلع حالة الإتمام
- أكّد التسليم للمشتري مع مرجع الطلب
- عالج حالات الخطأ — معرّف مستخدم غير صالح، فشل الطلب
- حدّد الشروط — تسليم Stars يكون لحساب مؤكّد؛ غير قابل للعكس بعد التسليم
- اختبر التدفّق الكامل في بيئة sandbox/الاختبار قبل الإطلاق