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

ماذا تفعل

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

متى تستخدمها

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

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

كيف تعمل

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

---

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

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

1. افتح تيليجرام وابحث عن @BotFather
2. ابدأ محادثة مع BotFather
3. أرسل الأمر: /newbot
4. سيطلب BotFather اسماً للبوت
5. أدخل اسماً للعرض (مثل "بوت طلبات متجري")
6. سيطلب BotFather اسم مستخدم للبوت
7. يجب أن ينتهي بـ bot (مثل "mystore_order_bot")
8. يجب أن يكون فريداً في تيليجرام
9. سينشئ BotFather البوت ويعطيك رمز API
10. يبدو كهذا: 123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ
11. انسخ واحفظ هذا الرمز - ستحتاجه في الخطوة 3

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

You: /newbot
BotFather: Alright, a new bot. How are we going to call it?
You: MyStore Order Bot
BotFather: Good. Now let's choose a username for your bot.
You: mystore_order_bot
BotFather: Done! Here's your token: 123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ

الخطوة 2: الحصول على معرّف الدردشة للمشرف

لتلقي إشعارات المشرف، تحتاج إلى معرّف الدردشة الخاص بك:

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

1. افتح تيليجرام وابحث عن @userinfobot
2. ابدأ محادثة مع البوت
3. أرسل أي رسالة (مثل "مرحباً")
4. سيرد البوت بمعلومات المستخدم الخاصة بك
5. انسخ رقم Id (مثل 123456789)

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

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

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

1. أرسل رسالة إلى البوت الخاص بك (الذي أنشأته في الخطوة 1)
2. زر هذا الرابط في متصفحك (استبدل YOUR_BOT_TOKEN):

https://api.telegram.org/botYOUR_BOT_TOKEN/getUpdates

1. ابحث عن "chat":{"id":123456789}
2. انسخ رقم id

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

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

1. في لوحة تحكم المتجر، انتقل إلى إعدادات النظام > الإضافات
2. ابحث عن بطاقة إشعارات تيليجرام
3. انقر على إعداد
4. فعّل الإضافة باستخدام زر التبديل
5. املأ حقول الإعداد:
6. رمز البوت: الصق الرمز من الخطوة 1
7. معرّف دردشة المشرف: الصق معرّف الدردشة من الخطوة 2
8. قم بإعداد إعدادات الإشعارات والقوالب (انظر أدناه)
9. انقر على حفظ

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

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

1. البحث عن البوت في تيليجرام (استخدم اسم المستخدم الذي أنشأته، مثل @mystore_order_bot)
2. بدء محادثة مع البوت (انقر على "ابدأ")
3. إضافة معرّف دردشة تيليجرام إلى حسابهم في متجرك:
4. ينتقل العميل إلى إعدادات الحساب
5. يدخل معرّف دردشة تيليجرام
6. يحفظ الملف الشخصي

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

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

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

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

---

حقول الإعداد

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

مفعّل

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

رمز البوت

النوع: نص مطلوب: نعم التنسيق: 123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ الوصف: رمز API الخاص ببوت تيليجرام من @BotFather

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

معرّف دردشة المشرف

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

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

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

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

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

المتطلبات:

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

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

إشعار المشرف

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

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

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

تدعم تيليجرام تنسيق HTML في الرسائل:

• <b>عريض</b> لـ نص عريض
• <i>مائل</i> لـ نص مائل
• <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>

نصائح:

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

---

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

إعداد البوت

اسم البوت:

• اختر اسماً واضحاً يمكن التعرف عليه
• أضف اسم متجرك
• مثال: "طلبات متجري" أو "دعم متجري"

اسم مستخدم البوت:

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

ملف البوت الشخصي:

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

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

افعل:

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

لا تفعل:

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

تأهيل العملاء

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

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

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

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

---

استكشاف الأخطاء

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

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

المشرف لا يتلقى رسائل؟

1. تحقق من تفعيل "إشعار المشرف"
2. تأكد من صحة معرّف دردشة المشرف
3. تأكد من أنك بدأت محادثة مع البوت
4. جرب زر الاختبار للتحقق من الاتصال

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

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

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

1. تأكد من استخدام وسوم HTML صالحة: <b>، <i>، <code>، <a>
2. لا تستخدم وسوماً غير مدعومة مثل <div>، <span>، <h1>
3. أغلق جميع الوسوم بشكل صحيح: <b>نص</b> وليس <b>نص
4. تجنب الأحرف الخاصة: < لـ <، > لـ >، & لـ &

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

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

خطأ "Unauthorized"؟

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

---

كيف يتم إرسال الرسائل

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

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

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

---

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

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

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

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

---

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

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

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

https://api.telegram.org/botYOUR_BOT_TOKEN/sendMessage?chat_id=YOUR_CHAT_ID&text=مرحباً

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

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

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

---

موارد ذات صلة

• وثائق Telegram Bot API
• أوامر BotFather
• @userinfobot - احصل على معرّف الدردشة
• @BotFather - أنشئ وأدر البوتات
• العودة إلى الإضافات