أدلة عربية لإنشاء البوت، تطبيق المتجر، الربط، المحادثات، الحملات، المحفظة، والتدفقات.
إنشاء بوت في BotFather خطوة بخطوة
افتح تيليجرام وابحث عن @BotFather ثم ابدأ محادثة.
أرسل الأمر /newbot.
اختر اسماً ظاهراً للبوت (مثلاً: متجر النور).
اختر معرفاً ينتهي بـ bot (مثلاً: alnoor_store_bot).
انسخ التوكن الذي يظهر (شكل طويل فيه :).
في لوحة برق داخل سلة → البوت → الصق التوكن واضغط تحقق.
انتظر رسالة نجاح الويب هوك، ثم أرسل لنفسك رسالة تجريبية من الزر المخصّص.
لا تشارك التوكن مع أحد. إن تسرب، ألغِه من BotFather عبر /revoke وأعد الربط.
إعدادات اختيارية في BotFather
/setuserpic — صورة البوت (يفضّل شعار المتجر).
/setdescription و /setabouttext — وصف يظهر قبل /start.
/setcommands — برق يضبط الأوامر الأساسية تلقائياً بعد الربط.
تطبيق المتجر كـ «التطبيق الرئيسي» للبوت (Main Mini App)
برق يضيف «تطبيق المتجر» لزر القائمة داخل المحادثة تلقائياً. لو تبي يظهر زر فتح التطبيق كبير في صفحة البوت نفسها (وفي تبويب التطبيقات في بحث تيليجرام)، فعّله مرة وحدة من BotFather:
هذا هو الزر اللي بيظهر لعملائك تحت اسم البوت. يفتح نفس «تطبيق المتجر»: طلباتهم، المحفظة، المنتجات، وتأكيد طلبات الدفع عند الاستلام، والتواصل مع الدعم.
في لوحة برق افتح ربط البوت ← بطاقة «تطبيق المتجر داخل تيليجرام» واضغط نسخ الرابط. (يلزم أن يكون رابط برق على HTTPS — تيليجرام ما يفتح التطبيقات بدونه.)
افتح @BotFather وأرسل /mybots ثم اختر بوت متجرك.
اتبع المسار: Bot Settings←Configure Mini App←Enable Mini App
اختياري: من نفس القائمة تقدر ترفع صور/فيديو معاينة للتطبيق، وتختار وضع الفتح (ملء الشاشة أو نصفها).
افتح صفحة البوت من جوالك وتأكد إن زر فتح التطبيق ظاهر، وجرّبه بحسابك.
روابط مباشرة لأقسام التطبيق
بعد التفعيل تقدر تشارك روابط تفتح قسم معيّن مباشرة (في الحملات أو البايو مثلاً):
https://t.me/اسم_البوت?startapp=orders — طلباتي
https://t.me/اسم_البوت?startapp=wallet — المحفظة
https://t.me/اسم_البوت?startapp=shop — المنتجات
https://t.me/اسم_البوت?startapp=support — نموذج التواصل مع الدعم
التطبيق يتحقق من هوية العميل بتوقيع تيليجرام في كل طلب، ويعرض له بياناته في متجرك فقط. لو العميل ما ربط رقمه، يطلب منه المشاركة أولاً — ويقدر يتواصل مع الدعم حتى قبل الربط.
ما ظهر الزر؟
تأكد إن الرابط يبدأ بـ https:// وإن «تطبيق المتجر» مفعّل في لوحة برق.
أغلق تيليجرام وافتحه من جديد — بعض الأجهزة تحدّث صفحة البوت بعد دقائق.
زر القائمة داخل المحادثة (بجانب خانة الكتابة) يضبطه برق تلقائياً من بطاقة «تطبيق المتجر»؛ ما يحتاج تعدّله من BotFather.
ربط العملاء
الربط يطابق رقم جوال العميل في تيليجرام مع ملفه في سلة.
من المتجر
من الإعدادات انسخ سكربت زر الربط وضعه في ثيم المتجر أو صفحة مخصّصة.
العميل يضغط الزر فيُفتح البوت بمعامل توقيع آمن.
يشارك رقمه عبر زر «مشاركة رقمي» داخل تيليجرام.
من داخل البوت
الأمر /link يطلب مشاركة جهة الاتصال.
يجب أن تكون الجهة هي رقم المستخدم نفسه (لا جهة أخرى).
إن تغيّر رقم الجوال على حساب تيليجرام آخر، يُلغى الربط السابق تلقائياً ويُعاد التعيين للحساب الجديد.
المحادثات (صندوق الوارد)
كل رسالة من عميل مرتبط أو غير مرتبط تظهر في المحادثات.
يمكن تعيين وكيل، تغيير الحالة، إضافة ملاحظات داخلية، واستخدام الردود الجاهزة.
على الجوال: القائمة تظهر أولاً، ثم المحادثة مع زر «الوارد» للرجوع.
البحث يدعم نص الرسائل والأسماء (FTS).
الوكلاء يدخلون عبر دعوة برابط سحري أو كلمة مرور من صفحة الوكلاء.
الحملات
من الحملات أنشئ حملة جديدة واختر الشريحة (كل المرتبطين أو فلتر).
اكتب النص أو أرفق صورة/فيديو، وأضف أزراراً بروابط إن رغبت.
استخدم «إرسال تجريبي» لنفسك قبل البث.
أرسل الآن أو جدول لاحقاً — الإرسال يمر عبر طابور يحترم حدود تيليجرام.
تتبّع المرسل والمُسلَّم والفشل من بطاقة الحملة والتقارير.
محفظة الرصيد
فعّل المحفظة من لوحة برق واختر المبالغ المقترحة ونسبة المكافأة.
عيّن مُعرّف الصفحة العامة (slug) ليصبح الرابط: https://barq.uteer.sa/اسمك.
العميل يدفع عبر منتج شحن داخل سلة؛ بعد تأكيد الدفع يُضاف الرصيد.
عند الطلب يمكن حجز جزء من الرصيد كقسيمة (إنفاق جزئي) وإكمال الباقي بوسيلة أخرى.
لا تُستخدم بطاقات سوا أو شحن خارجي — الدفع فقط عبر بوابة سلة للمتجر.
