بوت تيليجرام لتنبيهات الطلبات: إشعار فوري لك أو لفريقك مجاناً
باختصار: بوت تيليجرام يستطيع أن يرسل إليك أو إلى مجموعة فريقك رسالة فورية عند وصول طلب جديد أو حدوث عطل في الموقع، وإعداده لا يحتاج أكثر من إنشاء بوت واحد وإضافته إلى المجموعة. أنشئ البوت عبر BotFather، واحفظ رمزه في مكان آمن على الخادم، ثم احصل على معرّف المحادثة وأرسل الرسالة من خادمك عند الحدث. اجعل كل نوع من التنبيهات في مجموعة منفصلة، مثل الطلبات والأعطال والتقييمات. ولا تضع في الرسالة بيانات حساسة مثل كلمات السر أو أرقام البطاقات أو العنوان الكامل. وإذا فشل الإرسال فلا يوقف الطلب نفسه، بل يسجل الخطأ ويعيد المحاولة لاحقاً.
إنشاء البوت
التنفيذ يبدأ من حساب تيليجرام العادي، لا من لوحة خاصة:
- افتح محادثة مع BotFather، وهو البوت الرسمي الذي ينشئ البوتات الأخرى.
- أرسل الأمر
/newbot، ثم اختر اسماً ظاهراً واسم مستخدم ينتهي بكلمة bot. - سيعطيك BotFather رمزاً طويلاً. هذا الرمز كلمة سر كاملة، فلا تنشره في أي مكان.
إذا فقدت الرمز أو ظننت أنه تسرّب، يمكنك إنشاء رمز جديد من BotFather، وبذلك يتوقف الرمز القديم عن العمل. افعل ذلك فوراً إذا شككت في أي تسريب.
الحصول على معرّف المحادثة
لكي يرسل البوت إلى مجموعة، يحتاج معرّف المجموعة. الطريقة العملية:
- أنشئ مجموعة للفريق، وأضف البوت إليها.
- أرسل رسالة عادية في المجموعة، مثل "اختبار".
- افتح في المتصفح رابط واجهة الاستدعاء الخاصة بالبوت، وهو عنوان يبدأ بموقع تيليجرام ويحتوي على الرمز، ثم ابحث في النتيجة عن الحقل chat ومعرّفه.
معرّف المجموعة يبدأ عادة بعلامة سالبة، وهذا طبيعي. تعامل مع الرابط الذي يحمل الرمز كأنه كلمة سر، ولا تشاركه مع أحد، وأغلق الصفحة بعد الاستخدام.
الإرسال من الخادم
الرسالة ترسل بطلب واحد إلى واجهة تيليجرام، ويكفي أن تحدد المعرّف ونص الرسالة. مثال بسيط:
async function notifyTeam(order) {
const text = [
'طلب جديد',
`رقم الطلب: ${order.id}`,
`الإجمالي: ${order.total} ${order.currency}`,
`المدينة: ${order.city}`
].join('\n');
try {
await fetch(`https://api.telegram.org/bot${process.env.TELEGRAM_BOT_TOKEN}/sendMessage`, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ chat_id: process.env.TELEGRAM_CHAT_ID, text })
});
} catch (err) {
console.error('فشل إرسال تنبيه تيليجرام', err.message);
}
}
الرمز والمعرّف يُقرآن من إعدادات الخادم، وليسا داخل الكود. ولاحظ أن الخطأ يُسجل ولا يُرمى إلى الأعلى، لأن تعطّل تيليجرام لا يجب أن يمنع قبول الطلب. التنبيه إضافة مفيدة، لكنه ليس جزءاً من عملية الدفع أو الحفظ.
ماذا تضع في الرسالة
الرسالة المفيدة قصيرة وتحمل ما يحتاجه المسؤول ليتخذ قراراً دون أن يفتح لوحة أخرى:
- رقم الطلب والإجمالي والمدينة.
- نوع الحدث: طلب جديد، أو خطأ دفع، أو تقييم منخفض.
- رابط مباشر للطلب في لوحة الإدارة، إن كان متاحاً لمن يستقبل التنبيه.
ولا تضع فيها:
- أرقام البطاقات أو أي بيانات دفع.
- كلمات السر أو الرموز أو مفاتيح الخدمات.
- العنوان الكامل ورقم الهاتف إلا إذا كانت المجموعة مقصورة على من يحتاجهما فعلاً.
تقسيم القنوات
لا ترسل كل شيء إلى مجموعة واحدة، لأن الرسائل تغرق بعضها. اقترح هذا التقسيم:
| المجموعة | ما ترسله | من يتابعها |
|---|---|---|
| الطلبات | طلبات جديدة وتأكيدات الدفع | المبيعات والتشغيل |
| الأعطال | أخطاء الخادم وفشل الدفع | المطوّر أو المسؤول التقني |
| التقييمات | تقييمات منخفضة أو شكاوى | خدمة العملاء |
كل مجموعة لها معرّف خاص. أضف المعرّفات كلها في الإعدادات، وافصل بينها في الكود بأسماء واضحة.
تجنب الإغراق
إذا كان المتجر يستقبل مئات الطلبات يومياً، فإرسال رسالة لكل طلب سيخلق ضجيجاً يتجاهله الفريق. في هذه الحالة أرسل ملخصاً كل ساعة أو كل نصف ساعة، واستثنِ الطلبات العادية، وأرسل فقط الحالات التي تتطلب تدخلاً.
رسالة اختبار قبل الإطلاق
أرسل رسالة اختبار بنص قصير، ثم أدخل طلباً تجريبياً في المتجر أو النموذج وراقب وصول التنبيه. إذا وصلت الرسالة الأولى دون الثانية، فالخلل في الربط بين الموقع والدالة، وليس في البوت. وإذا وصلت الرسالتان لكن بشكل مختلف، فراجع ترميز النص العربي وتأكد من أن الإرسال يتم بصيغة JSON كما في المثال. اختبر أيضاً حالة فشل مقصودة، بإدخال رمز خاطئ في بيئة تجريبية، لتتأكد أن الموقع يكمل عمله دون توقف.
عند تغيّر الخادم أو الدومين
التنبيه يعتمد على الخادم الذي ينفذ الدالة، لذلك إذا نقلت الموقع إلى استضافة جديدة فتأكد من أن متغيرات الرمز والمعرّف موجودة هناك أيضاً. كثيراً ما يعمل الموقع بعد النقل بينما تتوقف التنبيهات بصمت، لأن الإعدادات بقيت على الخادم القديم. أضف إلى قائمة فحص النقل بنداً واضحاً عنها، وأرسل تنبيه اختبار فور اكتمال النقل.
تسجيل الأخطاء دون تسريب
الخطأ الذي يتكرر أكثر من مرة في اليوم نفسه يستحق تنبيهاً واحداً فقط، لا عشرة. اجمع الأخطاء المتشابهة في سطر واحد مع عددها، حتى لا تغرق المجموعة في تكرار لا يضيف معلومة جديدة.
عندما يفشل الإرسال، اكتب في السجل رقم الطلب ونوع الخطأ ورمز الاستجابة فقط، ولا تكتب الرمز الكامل ولا نص الاستجابة كاملاً إن كان يتضمن الرابط. هذا يكفي لتشخيص المشكلة دون أن يصبح السجل مخزناً للأسرار. وإذا كانت منصة الاستضافة تعرض السجلات لأكثر من شخص، فاجعل هذه القاعدة مكتوبة في الفريق. ولا تنسَ أن تحذف رسائل الاختبار التي تحمل رمزاً أو معرّفاً حقيقياً من المجموعة بعد الانتهاء.
قائمة تحقق
- ☐ البوت أُنشئ من BotFather، والرمز محفوظ في إعدادات الخادم وليس في الكود.
- ☐ كل مجموعة لها معرّف مسجل، والبوت مضاف إليها.
- ☐ الرسالة لا تحمل بيانات دفع أو كلمات سر.
- ☐ فشل الإرسال يُسجل ولا يوقف الطلب.
- ☐ القنوات مقسمة بين الطلبات والأعطال والتقييمات.
أسئلة شائعة
هل تيليجرام مناسب للمتاجر الكبيرة؟
يصلح تنبيهاً داخلياً للفريق، لكنه ليس نظام إدارة طلبات. للمتاجر الكبيرة يُفضل أن تبقى الإدارة في لوحة مخصصة، ويكون تيليجرام قناة إشعار إضافية.
هل يرى الزبائن هذه الرسائل؟
لا، إذا كان البوت يرسل إلى مجموعة خاصة بالفريق. لكن تأكد أن المجموعة مقصورة على الأعضاء المقصودين، لأن أي عضو فيها يرى الرسائل كلها.
ماذا أفعل إذا توقف البوت فجأة؟
تحقق أولاً من أن الرمز لم يُلغَ أو يتغير، ثم من أن البوت ما زال عضواً في المجموعة وله صلاحية الكتابة. ثم راجع سجل الخادم لمعرفة سبب الخطأ الفعلي.
هل أحتاج مبرمجاً لهذا الإعداد؟
الإنشاء والإعداد الأولي لا يحتاجان برمجة. إضافة الإرسال من الموقع تحتاج شخصاً يعرف كيف يضيف دالة إلى خادم المتجر، وهذه خطوة قصيرة لمرة واحدة.
إذا أردت أن نجهز التنبيهات لمتجرك ونختبرها مع فريقك قبل الاعتماد عليها، فابدأ من صفحة التواصل.