إشعارات تيليجرام¶

ما الذي يفعله¶

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

متى تستخدمه¶

فعّل هذه الإضافة إذا كنت تريد:

إرسال تأكيدات الطلبات تلقائياً للعملاء عبر تيليجرام
الحصول على تنبيهات تيليجرام فورية عند وصول طلبات جديدة
توفير قناة اتصال أخرى للعملاء
استخدام خدمة إشعارات مجانية (بدون تكاليف رسائل نصية)
الاحتفاظ بجميع إشعارات الطلبات في محادثة تيليجرام واحدة

كيف يعمل¶

تنشئ بوت تيليجرام باستخدام BotFather، ثم تقوم بإعداده في متجرك. عند إنشاء الطلبات، يرسل البوت الخاص بك رسائل منسقة للعملاء و/أو المسؤولين تلقائياً.

تعليمات الإعداد¶

الخطوة 1: إنشاء بوت تيليجرام¶

افتح تيليجرام وابحث عن @BotFather
ابدأ محادثة مع BotFather
أرسل الأمر: /newbot
سيطلب BotFather اسماً للبوت الخاص بك
أدخل اسم عرض (مثل: "MyStore Order Bot")
سيطلب BotFather اسم مستخدم للبوت الخاص بك
يجب أن ينتهي بـ bot (مثل: "mystore_order_bot")
يجب أن يكون فريداً عبر تيليجرام
سينشئ BotFather البوت الخاص بك ويعطيك رمز API
يبدو هكذا: 123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ
انسخ واحفظ هذا الرمز - ستحتاجه في الخطوة 3

مثال على المحادثة:

أنت: /newbot
BotFather: حسناً، بوت جديد. ماذا سنسميه؟
أنت: MyStore Order Bot
BotFather: جيد. الآن لنختار اسم مستخدم للبوت الخاص بك.
أنت: mystore_order_bot
BotFather: تم! إليك رمزك: 123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ

الخطوة 2: الحصول على معرّف محادثة المسؤول¶

لاستلام إشعارات المسؤول، تحتاج إلى معرّف المحادثة الخاص بك:

الطريقة 1: استخدام @userinfobot (الأسهل)

افتح تيليجرام وابحث عن @userinfobot
ابدأ محادثة مع البوت
أرسل أي رسالة (مثل "hello")
سيرد البوت بمعلومات المستخدم الخاصة بك
انسخ رقم Id (مثل: 123456789)

الطريقة 2: استخدام @chatIDrobot

افتح تيليجرام وابحث عن @chatIDrobot
ابدأ محادثة مع البوت
سيرسل البوت معرّف المحادثة الخاص بك تلقائياً
انسخ الرقم

الطريقة 3: الطريقة اليدوية

أرسل رسالة إلى البوت الخاص بك (الذي أنشأته في الخطوة 1)
قم بزيارة هذا الرابط في متصفحك (استبدل YOUR_BOT_TOKEN): https://api.telegram.org/botYOUR_BOT_TOKEN/getUpdates
ابحث عن "chat":{"id":123456789}
انسخ رقم id

احفظ معرّف المحادثة الخاص بك - ستحتاجه في الخطوة 3.

الخطوة 3: تفعيل الإضافة¶

في لوحة تحكم متجرك، اضغط على الأقسام ← إعدادات النظام ← الإضافات
ابحث عن بطاقة إشعارات تيليجرام
اضغط على إعداد
فعّل الإضافة باستخدام مفتاح التبديل
املأ حقول الإعداد:
رمز البوت: الصق الرمز من الخطوة 1
معرّف محادثة المسؤول: الصق معرّف المحادثة من الخطوة 2
قم بإعداد إعدادات الإشعارات والقوالب (انظر أدناه)
اضغط على حفظ

الخطوة 4: إعداد إشعارات العملاء (اختياري)¶

لكي يستلم العملاء الإشعارات، يحتاجون إلى:

العثور على البوت الخاص بك في تيليجرام (استخدم اسم المستخدم الذي أنشأته، مثل @mystore_order_bot)
بدء محادثة مع البوت (اضغط "Start")
إضافة معرّف محادثة تيليجرام الخاص بهم إلى حسابهم في متجرك:
يذهب العميل إلى إعدادات حسابه
يدخل معرّف محادثة تيليجرام الخاص به
يحفظ ملفه الشخصي

ملاحظة: يمكن للعملاء الحصول على معرّف المحادثة الخاص بهم باستخدام @userinfobot (انظر الخطوة 2).

الخطوة 5: اختبار الإضافة¶

اضغط على زر اختبار في بطاقة الإضافة
سيرسل النظام رسالة اختبار
تحقق من تيليجرام - يجب أن تستلم رسالة من البوت الخاص بك

إذا نجح الاختبار، فأنت جاهز!

حقول الإعداد¶

الإعدادات الأساسية¶

مفعّل¶

النوع: مفتاح تبديل الوصف: تشغيل أو إيقاف الإضافة

رمز البوت¶

النوع: نص مطلوب: نعم الصيغة: 123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ الوصف: رمز واجهة برمجة تطبيقات بوت تيليجرام الخاص بك من @BotFather

من أين تحصل عليه: أنشئ بوتاً مع @BotFather (انظر الخطوة 1)

معرّف محادثة المسؤول¶

النوع: نص مطلوب: نعم الصيغة: أرقام فقط (مثل: 123456789) الوصف: معرّف مستخدم تيليجرام الخاص بك لاستلام إشعارات المسؤول

من أين تحصل عليه: استخدم @userinfobot أو @chatIDrobot (انظر الخطوة 2)

إعدادات الإشعارات¶

إشعار العملاء¶

النوع: مربع اختيار الافتراضي: مفعّل (محدد) الوصف: إرسال تأكيد تيليجرام للعملاء عند إنشاء طلباتهم

المتطلبات: - يجب أن يكون لدى العملاء معرّف محادثة تيليجرام محفوظ في حسابهم - يجب أن يكون العملاء قد بدأوا محادثة مع البوت الخاص بك

متى تعطله: إذا كنت تريد إشعارات المسؤول فقط

إشعار المسؤول¶

النوع: مربع اختيار الافتراضي: مفعّل (محدد) الوصف: إرسال تنبيه تيليجرام للمسؤول عند وصول طلبات جديدة

متى تعطله: إذا كنت لا تريد استلام إشعارات الطلبات

قوالب الرسائل¶

يدعم تيليجرام تنسيق HTML في الرسائل: - عريض لـ النص العريض - مائل لـ النص المائل - <code>كود</code> لـ نص أحادي المسافة - <a href="url">رابط</a> للروابط

قالب رسالة العميل¶

النوع: مربع نص الوصف: الرسالة المرسلة للعملاء عند إنشاء طلب

العناصر النائبة المتاحة: - {customer_name} - اسم العميل - {order_id} - رقم الطلب - {order_total} - المبلغ الإجمالي مع العملة - {order_url} - رابط عرض تفاصيل الطلب

القالب الافتراضي:

<b>تأكيد الطلب</b>

مرحباً {customer_name}!

تم استلام طلبك <b>#{order_id}</b>.

الإجمالي: <b>{order_total}</b>

<a href="{order_url}">تتبع طلبك</a>

شكراً للتسوق معنا!

نصائح: - استخدم HTML لتنسيق أفضل - اجعلها ودية وواضحة - ضمّن رابط تتبع الطلب - أضف معلومات الاتصال بمتجرك

قالب رسالة المسؤول¶

النوع: مربع نص الوصف: الرسالة المرسلة للمسؤول عند وصول طلبات جديدة

العناصر النائبة المتاحة: - {customer_name} - اسم العميل - {customer_phone} - رقم هاتف العميل - {order_id} - رقم الطلب - {order_total} - المبلغ الإجمالي مع العملة - {admin_order_url} - رابط تفاصيل الطلب في لوحة الإدارة

القالب الافتراضي:

🔔 <b>تنبيه طلب جديد!</b>

الطلب: <b>#{order_id}</b>
العميل: {customer_name}
الهاتف: {customer_phone}
الإجمالي: <b>{order_total}</b>

<a href="{admin_order_url}">عرض الطلب في لوحة الإدارة</a>

نصائح: - استخدم الرموز التعبيرية للمسح البصري السريع - ضمّن معلومات اتصال العميل - أضف رابطاً مباشراً للوحة الإدارة - استخدم النص العريض للتفاصيل المهمة

أفضل الممارسات¶

إعداد البوت الخاص بك¶

اسم البوت: - اختر اسماً واضحاً ومعروفاً - ضمّن اسم متجرك - مثال: "MyStore Orders" أو "MyShop Support"

اسم مستخدم البوت: - اجعله بسيطاً وسهل التذكر - استخدم اسم متجرك إذا كان متاحاً - يجب أن ينتهي بـ "bot" - مثال: @mystorebot أو @myshop_order_bot

ملف البوت الشخصي: - عيّن صورة ملف شخصي (استخدم /setuserpic في BotFather) - أضف وصفاً (استخدم /setdescription في BotFather) - أخبر العملاء كيفية استخدامه

قوالب الرسائل¶

افعل: - استخدم تنسيق HTML للوضوح - ضمّن رقم الطلب للمرجعية - وفر روابط تتبع قابلة للنقر - أضف رموزاً تعبيرية ذات صلة (ليس كثيراً) - اجعل المعلومات المهمة عريضة

لا تفعل: - إرسال رسائل طويلة غير منسقة - نسيان تفاصيل الطلب الأساسية - استخدام HTML معطوب أو غير صالح - الإفراط في استخدام الرموز التعبيرية (يبدو غير احترافي) - تضمين بيانات حساسة (كلمات المرور، أرقام البطاقات الكاملة)

تهيئة العملاء¶

لمساعدة العملاء على استلام الإشعارات:

أضف تعليمات على صفحة الحساب/الملف الشخصي
أرهم كيفية العثور على معرّف المحادثة الخاص بهم (@userinfobot)
اربط بالبوت الخاص بك مباشرة: https://t.me/your_bot_username
أرسل رسالة ترحيب عند بدء البوت

الخصوصية والأمان¶

لا تشارك رمز البوت الخاص بك أبداً - أي شخص يملكه يمكنه التحكم في البوت
خزّن معرّفات المحادثة بشكل آمن في ملفات المستخدمين
لا ترسل تفاصيل الدفع الحساسة عبر تيليجرام
التزم بلوائح الخصوصية (GDPR، إلخ)

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

البوت لا يرسل الرسائل؟

تحقق من صحة رمز البوت الخاص بك (بدون مسافات إضافية)
تأكد من أن البوت لم يُحذف أو يُحظر
حاول إرسال رسالة اختبار باستخدام أمر /mybots في @BotFather
تأكد من أنك لم تصل إلى حدود معدل تيليجرام (30 رسالة/ثانية)

المسؤول لا يستلم الرسائل؟

تحقق من تفعيل "إشعار المسؤول"
تأكد من صحة معرّف محادثة المسؤول
تأكد من أنك بدأت محادثة مع البوت الخاص بك
جرب زر الاختبار للتحقق من الاتصال

العميل لا يستلم الرسائل؟

تحقق من تفعيل "إشعار العملاء"
تأكد من أن العميل حفظ معرّف محادثة تيليجرام في ملفه الشخصي
تأكد من أن العميل بدأ محادثة مع البوت الخاص بك
تحقق من صحة معرّف محادثة العميل

تنسيق HTML لا يعمل؟

تأكد من استخدام وسوم HTML صالحة: ، ، <code>، <a>
لا تستخدم وسوماً غير مدعومة مثل <div>، ، <h1>
أغلق جميع الوسوم بشكل صحيح: نص وليس نص
قم بترميز الأحرف الخاصة: < لـ <، > لـ >، & لـ &

خطأ "Bad Request: message text is empty"؟

تحقق من أن قالب الرسالة ليس فارغاً
تحقق من تهجئة جميع العناصر النائبة بشكل صحيح
تأكد من وجود نص على الأقل خارج العناصر النائبة

خطأ "Unauthorized"؟

رمز البوت الخاص بك غير صالح أو غير صحيح
تحقق من الأخطاء الإملائية أو المسافات الإضافية
أنشئ رمزاً جديداً من @BotFather إذا لزم الأمر

كيفية إرسال الرسائل¶

يتم إرسال الرسائل بشكل غير متزامن باستخدام مهام الخلفية:

يتم إنشاء الطلبات فوراً
يتم وضع رسائل تيليجرام في قائمة الانتظار وإرسالها خلال ثوانٍ
إذا كان تيليجرام غير متاح مؤقتاً، تتم إعادة المحاولة تلقائياً
يتم تسجيل الرسائل الفاشلة لاستكشاف الأخطاء وإصلاحها

هذا يضمن سرعة إتمام عملية الدفع حتى لو تأخر تسليم تيليجرام.

حدود معدل تيليجرام¶

لدى تيليجرام هذه الحدود للبوتات:

30 رسالة في الثانية لمحادثات مختلفة
رسالة واحدة في الثانية لنفس المحادثة
لا أكثر من 20 رسالة في الدقيقة لنفس المجموعة

تتعامل الإضافة مع تحديد المعدل تلقائياً، لذا لا تحتاج للقلق بشأنه لأحجام الطلبات العادية.

متقدم: اختبار البوت يدوياً¶

لاختبار البوت مباشرة بدون الإضافة:

افتح هذا الرابط في متصفحك (استبدل YOUR_BOT_TOKEN و YOUR_CHAT_ID):

https://api.telegram.org/botYOUR_BOT_TOKEN/sendMessage?chat_id=YOUR_CHAT_ID&text=Hello

إذا نجح، سترى استجابة JSON:

{"ok":true,"result":{...}}

إذا فشل، سترى رسالة خطأ تشرح المشكلة

توثيق واجهة برمجة تطبيقات بوت تيليجرام
أوامر BotFather
@userinfobot - الحصول على معرّف المحادثة الخاص بك
@BotFather - إنشاء وإدارة البوتات
العودة إلى الإضافات

إشعارات تيليجرام¶

ما الذي يفعله¶

متى تستخدمه¶

كيف يعمل¶

تعليمات الإعداد¶

الخطوة 1: إنشاء بوت تيليجرام¶

الخطوة 2: الحصول على معرّف محادثة المسؤول¶

الخطوة 3: تفعيل الإضافة¶

الخطوة 4: إعداد إشعارات العملاء (اختياري)¶

الخطوة 5: اختبار الإضافة¶

حقول الإعداد¶

الإعدادات الأساسية¶

مفعّل¶

رمز البوت¶

معرّف محادثة المسؤول¶

إعدادات الإشعارات¶

إشعار العملاء¶

إشعار المسؤول¶

قوالب الرسائل¶

قالب رسالة العميل¶

قالب رسالة المسؤول¶

أفضل الممارسات¶

إعداد البوت الخاص بك¶

قوالب الرسائل¶

تهيئة العملاء¶

الخصوصية والأمان¶

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

كيفية إرسال الرسائل¶

حدود معدل تيليجرام¶

متقدم: اختبار البوت يدوياً¶

مصادر ذات صلة¶