فنّي صيانة مصاعد في الإسكندرية طلب قطعة من الموقع صباحاً، وبعد الظهر كتب على واتساب: "الطلب اتشحن ولا لسه؟". لو كان الرد يحتاج موظفاً يفتح لوحة التحكم ويبحث، فسيأتي بعد ساعة. ولو كان يأتي من النظام نفسه، فسيأتي خلال ثوانٍ وصحيحاً.
الإجابة المختصرة: ربط واتساب بنظام شركتك له نصفان. الأول صادر: رسائل حالة تخرج عند أحداث حقيقية، عبر طابور إرسال يحترم موافقة العميل وسرعة الإرسال وقواعد القوالب عند Meta. والثاني وارد: Webhook موثَّق التوقيع يحفظ كل رسالة مرة واحدة، ثم يوجّهها إلى موظف أو إلى بوت لا يرى إلا بيانات المرسل نفسه.
المشكلة من جهة صاحب العمل
في مصر والخليج يعيش العميل على واتساب. البريد الإلكتروني لا يُقرأ، والرسائل النصية SMS صارت عند كثيرين قناة أكواد البنوك فقط. وحين لا يكون لدى الشركة ربط حقيقي بواتساب يتكرر المشهد نفسه: موظف يرد على "طلبي فين؟" من هاتفه الشخصي، وعميل لم يصله أي تحديث يتصل بالمكتب، ولا أحد يعرف لاحقاً ماذا وُعد العميل ومتى.
التكلفة ليست في الرسائل نفسها. التكلفة في ساعات عمل تُصرف على أسئلة إجابتها موجودة أصلاً في قاعدة البيانات، وفي ثقة تضيع حين يُشحن الطلب ولا يعرف العميل إلا عندما يتصل المندوب.
الربط الصحيح يحل ثلاثة أشياء:
- تحديثات استباقية: يصل العميل "تم التأكيد" و"تم الشحن" و"تم التسليم" دون أن يسأل.
- إجابات ذاتية: سؤال "طلبي فين؟" يجيب عنه النظام، حتى في الثانية فجراً.
- سجل محفوظ: كل رسالة في قاعدة بياناتك، مربوطة بالعميل والطلب، ويراها فريقك.
الخيارات: الواجهة الرسمية أم بوابة على خادمك؟
هناك طريقان لربط برنامج بواتساب، والاختيار بينهما أهم من أي ميزة.
| WhatsApp Cloud API (رسمية من Meta) | بوابة مستضافة ذاتياً (مثل WAHA) | |
|---|---|---|
| طريقة العمل | Meta تستضيف الخدمة، وترسل أنت عبر HTTPS برقم أعمال موثّق | تشغّل جلسة WhatsApp Web حقيقية على خادمك، مربوطة بهاتف عبر QR |
| بدء المحادثة | بقوالب معتمدة مسبقاً خارج نافذة الـ 24 ساعة | ممكن تقنياً، لكنه غير مصرّح به من واتساب |
| التكلفة | لكل رسالة مُسلَّمة حسب الفئة والدولة | لا رسوم لـ Meta؛ تتحمل تشغيل الخادم |
| مخاطر الحساب | تحكمها سياسات Meta للأعمال وتقييم جودة الرقم | شروط واتساب تمنع الوصول الآلي غير المصرّح به والرسائل الجماعية أو الآلية، وقد يُعلَّق الحساب |
| الأنسب لـ | رسائل تبدأها الشركة بأعداد كبيرة، والمنصات متعددة الشركات | قنوات محادثة يبدأها العميل، مع حدود صارمة تضعها أنت |
عن التسعير، وقت الكتابة (نوفمبر 2026) تقول صفحة الأسعار الرسمية عند Meta إن التسعير بالمحادثة استُبدل بـ التسعير لكل رسالة منذ 1 يوليو 2025. Meta تحاسب فقط على الرسائل التي ترسلها الشركة وتُسلَّم فعلاً، والسعر يختلف حسب الفئة (تسويق، خدمي Utility، مصادقة، خدمة عملاء) وحسب دولة المستلم. ومنذ 1 أكتوبر 2026 صارت ردود خدمة العملاء والقوالب الخدمية داخل نافذة الـ 24 ساعة مدفوعة من جديد، بعد شريحة مجانية قدرها 1,000 رسالة خدمة شهرياً لكل رقم. الأسعار تتغير أكثر من مرة في السنة، فراجع جدول Meta الحالي قبل أن تحسب ميزانيتك بالجنيه أو بالريال.
أما عن البوابات، فتوثيق WAHA نفسه واضح: هي تشغّل نسخة حقيقية من WhatsApp Web، وتذكر أن واتساب لا يسمح بالبوتات أو العملاء غير الرسميين، لذلك لا ينبغي اعتبارها آمنة تماماً. وشروط خدمة واتساب تسمح بتعطيل الحساب أو تعليقه عند إرسال رسائل جماعية أو آلية، أو الوصول إلى الخدمة "بوسائل آلية". هذه مقايضة يجب أن تقبلها وأنت تعرفها.
وفي الطريقين تبقى الموافقة شرطاً. Meta تشترط أن تحصل الشركة على إذن العميل قبل مراسلته، وأن تذكر اسم الشركة بوضوح في هذا الإذن. ضع هذا داخل المنتج نفسه، لا في صفحة الشروط فقط.
كيف بنيناه في منتجين من منتجات مونترا
ربطنا واتساب في منتجين من منتجاتنا، واختار كل منهما طريقاً مختلفاً لسبب واضح.
سوق مونترا، منصتنا لقطع غيار المصاعد في مصر، تستخدم بوابة WAHA على خادمنا. قناة واتساب هنا قناة محادثة: التجار والعملاء يراسلون مونترا أولاً، ومساعد ذكي يجيب عن أسئلة القطع ويستعلم عن الطلبات، ويستطيع موظف أن يتسلم المحادثة في أي لحظة. الوحدة نحو 30 ملفاً في NestJS، مع اختبارات للتحقق من التوقيع وقواعد الإرسال وأدوات البوت.
مونترا ERP، منصتنا لإدارة عمليات الصيانة، تستخدم WhatsApp Cloud API الرسمية بقوالب معتمدة. المنصة متعددة الشركات، والرسائل تبدأها الشركة: عميل شركة الصيانة يصله "تم تعيين الفني" و"الفني في الطريق" و"الفني وصل" و"تم إنجاز البلاغ". رسائل بهذا الشكل وبهذا الحجم مكانها الواجهة الرسمية، فذهبت إليها.
وكُتب كود السوق بحيث يمكن تغيير وسيلة النقل لاحقاً. كل شيء خلف واجهة برمجية واحدة اسمها WhatsAppProvider؛ WAHA تنفّذها اليوم، ويمكن أن يحل محلها محوّل لـ Cloud API دون لمس صندوق المحادثات أو البوت أو الإشعارات.
لوحة واتساب في الإدارة: قائمة المحادثات، زر التبديل بين البوت والموظف، ومحادثة فيها رد بحالة طلب
من الداخل: مسار الرسالة الواردة
WhatsApp ─► gateway ─► POST /whatsapp/webhook
│ 1. verify HMAC over raw body (else 401)
│ 2. INSERT inbound_event (unique provider key)
│ ok → 200 duplicate → 200 db down → 503
▼
per-chat queue (oldest first)
link code? → opt-out? → human mode? → "موظف"? → AI bot
▼
outbox row (QUEUED) ─► paced sender ─► WhatsApp
التحقق من التوقيع
الـ Webhook لا يحمل جلسة مستخدم، فالتوقيع هو وسيلة التوثيق الوحيدة. WAHA توقّع جسم الطلب الخام بـ HMAC-SHA512 وترسل الناتج بصيغة hex في الترويسة X-Webhook-Hmac. نحن نتحقق على البايتات الخام كما وصلت، لا على JSON أعدنا تحويله، وأي مدخل غير سليم يعيد false بدل أن يرمي خطأ:
export function verifyWebhookHmac(rawBody, header, secret): boolean {
if (!secret || rawBody == null) return false;
const sig = Array.isArray(header) ? header[0] : header;
if (!sig || typeof sig !== 'string') return false;
const given = sig.trim().toLowerCase();
if (!/^[0-9a-f]+$/.test(given)) return false;
const expected = createHmac('sha512', secret).update(rawBody).digest('hex');
if (given.length !== expected.length) return false;
return timingSafeEqual(Buffer.from(given), Buffer.from(expected));
}
فحص الطول ليس تفصيلاً: الدالة timingSafeEqual ترمي خطأ إذا اختلف طول المدخلين، فيتحول توقيع خاطئ إلى خطأ 500. وفي Cloud API الفكرة نفسها بوصفة مختلفة: Meta ترسل الترويسة X-Hub-Signature-256، وهي توقيع SHA-256 بمفتاح App Secret الخاص بتطبيقك.
لا تؤكد الاستلام قبل الحفظ
القاعدة التي تحمي الرسائل من الضياع: لا نرد بـ 200 إلا بعد حفظ الرسالة في قاعدة البيانات. إذا فشل الحفظ نرد بـ 503، فتعيد البوابة الإرسال. أما المعالجة نفسها، أي استدعاء النموذج والرد، فتحدث بعد الاستجابة، فلا يتسبب نموذج بطيء في مهلة منتهية ثم رسالة مكررة.
إعادة الإرسال تعني تكراراً، لذلك لكل رسالة مفتاح فريد: معرّف الرسالة عند المزوّد، أو عند غيابه sha256: متبوعاً ببصمة المحتوى. الرسالة المكررة تصطدم بقيد التفرد فتُقبل دون عمل جديد. وتوثيق Meta يقول الشيء نفسه عن Cloud API: هي تعيد محاولة الـ Webhook الفاشل حتى 36 ساعة، وعلى خادمك أن يزيل التكرار.
الرسائل المحفوظة تُعالج لكل محادثة بترتيب وصولها، فلا تتسابق رسالتان سريعتان. والرسالة التي تفشل تُعاد حتى خمس مرات (بعد 30 ثانية، ثم دقيقة، ثم دقيقتين، ثم أربع)، وتبقى رسائل المحادثة نفسها خلفها. ومهمة تعمل كل دقيقة وعند تشغيل الخادم تلتقط أي شيء تركه انقطاع مفاجئ في منتصف الطريق.
صندوق الصادر: مُرسِل واحد بإيقاع بشري
كل رسالة صادرة، رداً كانت أو إشعاراً، تُكتب أولاً كسطر في قاعدة البيانات. عامل واحد يرسل رسالة واحدة على الأكثر في كل دورة، وكل قواعد الأمان في دالة واحدة مختبرة: فاصل من 4 إلى 7 ثوانٍ بين أي رسالتين، وحد أقصى في الدقيقة (8 افتراضياً)، ومؤشر "يكتب الآن" يطول مع طول الرسالة. وللرسائل الاستباقية قواعد إضافية: لا إرسال بين 11 مساءً و8 صباحاً بتوقيت القاهرة، وحد يومي (150 افتراضياً)، وانتهاء صلاحية بعد 24 ساعة حتى لا يصل "تم الشحن" بعد يومين. وإذا تجمعت عدة إشعارات لمحادثة واحدة خلال ثلاث دقائق تُدمج في رسالة واحدة. والردود تسبق الإشعارات دائماً.
إشعارات حالة الطلب
حالة الطلب في السوق تتغير من أماكن كثيرة: الإدارة، والموردون، وتجميع الطلبات الفرعية، ومراجعة الدفع. بدلاً من التدخل في كل مكان منها، تفحص مهمة كل دقيقة الطلبات المحدَّثة حديثاً للعملاء المربوطين، وتحوّل كل طلب إلى مرحلة: تأكيد، شحن، تسليم، إلغاء، أو تعذّر التسليم. وجدول مفتاحه (orderId, event) يضمن أن كل مرحلة تُعلن مرة واحدة، حتى لو عملت المهمة مرتين.
قاعدتان تحفظان الأدب مع العميل: التغييرات التي حدثت قبل ربط واتساب تُعامل كتاريخ ولا يُرسل عنها شيء. والنظام لا يبدأ محادثة باردة أبداً؛ لا يُجهَّز إشعار إلا لمحادثة راسلت مونترا أولاً.
في مونترا ERP المسار أبسط، لأن الواجهة الرسمية تحمله. عند تغير حالة البلاغ تُرسل مهمة في الخلفية القالب المناسب، مع خمس محاولات وتباعد متزايد بينها:
body: JSON.stringify({
messaging_product: 'whatsapp',
to,
type: 'template',
template: {
name: `montra_job_${update}`, // assigned | on_the_way | arrived | completed
language: { code: locale }, // 'ar' or 'en'
components: [{ type: 'body', parameters: params.map(text => ({ type: 'text', text })) }],
},
}),
والأخطاء مصنفة: 408 و429 وأخطاء 5xx تُعاد محاولتها، وأي رفض آخر من Meta يُعامل كنهائي ولا يُكرر. وكل شركة تفعّل نوع التحديثات الذي تريده من إعداداتها. وقالب "تم الإنجاز" يحمل رابطاً موقَّعاً لصفحة بلاغ للقراءة فقط، فيها تقرير الفني وصور قبل العمل وبعده.
صفحة حالة البلاغ للعميل /r/(token): رقم البلاغ، الاسم الأول للفني، مراحل الحالة، وتقرير الإنجاز بالصور
المساعد الذكي: ما يستطيع وما لا يستطيع
بوت السوق يعمل عبر طبقة LLM متوافقة مع OpenAI (النموذج الافتراضي gpt-4o-mini)، ومعه قاعدة معرفة عربية عن الشركة والقطع وأعطال المصاعد الشائعة. يستطيع أن يبحث عن القطع، ويشرح قطعة، ويعرض الأقسام، ويرسل أدلة الصيانة، ويجهّز رابط سلة جاهزة لإتمام الطلب، ويستعلم عن طلبات المرسل نفسه. ولا يستطيع أن يضيف إلى السلة، أو يقبض مالاً، أو يعدّل طلباً.
الاستعلام عن الطلبات هو المكان الذي تهم فيه الضوابط. رقم واتساب وحده لا يثبت من صاحب أي حساب، لذلك يربط العميل رقمه صراحة: يضغط "ربط واتساب" من صفحة حسابه، فيظهر له كود من 8 خانات (بلا حروف متشابهة مثل 0 وO أو 1 وI)، ويرسله إلى رقم مونترا. الكود ينتهي بعد 15 دقيقة، وخمسة أكواد خاطئة من المرسل نفسه تقفله حتى نهاية المدة.
بعد ذلك تُربط أداة الطلبات بالمحادثة التي تتكلم. النموذج يستطيع أن يمرر رقم طلب، لكنه لا يستطيع أبداً أن يمرر معرّف مستخدم:
async getMyOrders(chatId: string, args: any) {
const customer = await this.link.customerForChat(chatId);
if (!customer) return { linked: false, howToLink: HOW_TO_LINK_AR };
const reference = typeof args?.reference === 'string' ? args.reference.trim().slice(0, 64) : '';
const orders = await this.prisma.order.findMany({
// userId comes from the linked chat, never from the model.
where: { userId: customer.id, ...(reference ? { orderNumber: reference } : {}) },
orderBy: { createdAt: 'desc' },
take: 5,
});
// → reference, status label, total, next step, link
}
حتى لو نجح أحد في خداع النموذج بالكامل، فلن يصل إلى طلبات عميل آخر، لأن الاستعلام لا يأخذ هوية المستخدم من النموذج أصلاً.
بقية الضوابط بسيطة وظاهرة. رسالة نصها "إيقاف" أو "stop" فقط توقف الإشعارات. وكتابة "موظف" أو "خدمة العملاء" تحوّل المحادثة إلى إنسان، ويسكت البوت في هذا الوضع حتى تنتهي مدته (12 ساعة افتراضياً) أو يعيده المشرف. وأكثر من 20 رداً آلياً في ساعة واحدة للمحادثة نفسها يحوّلها إلى موظف تلقائياً. والبوت يحتفظ بآخر ثماني رسائل مع ملخص متجدد لما قبلها، فتبقى المحادثة الطويلة مفهومة دون إرسال التاريخ كله للنموذج في كل مرة. ويستطيع العميل أن يرسل صورة قطعة؛ البوت يقرأ JPEG وPNG وWebP، ويتحقق من النوع من محتوى الملف نفسه، لا من النوع المعلن.
محادثة واتساب يسأل فيها عميل مربوط عن طلبه فيرد البوت بالحالة والخطوة التالية ورابط الطلب
ما تعلمناه
- البوت هو الجزء الأسهل. أغلب الكود في التوصيل: حفظ الوارد، وإزالة التكرار، والترتيب، والإيقاع، وإعادة المحاولة، والإيقاف.
- لا تترك للنموذج اختيار بيانات من يقرأ. اربط كل أداة بالقناة الموثّقة.
- اختر وسيلة النقل حسب من يبدأ المحادثة. عميل يراسلك أولاً مع موظف جاهز يختلف تماماً عن شركة ترسل آلاف التحديثات.
- الإشعارات تحتاج صلاحية ودمجاً. ثلاث رسائل في دقيقة عن طلب واحد تزعج العميل، و"تم الشحن" بعد يوم تربكه.
قائمة تحقق قبل ربط واتساب بنظامك
- اختر بين Cloud API الرسمية والبوابة حسب من يبدأ الرسائل وكم عددها، واقرأ الشروط الحالية لاختيارك.
- اجمع موافقة صريحة تذكر اسم شركتك، واحترم كلمة إيقاف واضحة.
- تحقق من توقيع كل Webhook على الجسم الخام، بمقارنة ثابتة الزمن.
- احفظ الرسالة الواردة قبل الرد بـ 200، ورد بخطأ 5xx إذا تعذر الحفظ.
- أزل التكرار بمعرّف الرسالة عند المزوّد، وبصمة المحتوى كبديل.
- أرسل كل شيء عبر صندوق صادر فيه فاصل زمني وحدود وساعات هدوء وانتهاء صلاحية.
- اجعل الإشعار لا يتكرر لكل طلب وحدث.
- اربط كل أداة في البوت بالحساب المربوط، ولا تقبل معرّف مستخدم من النموذج.
- اجعل الوصول إلى موظف بكلمة واحدة، واجعل وضع الموظف يُسكت البوت.
- احسب الميزانية لكل رسالة من جدول Meta الحالي، بما فيها رسائل الخدمة بعد الشريحة المجانية.
الأسئلة الشائعة
هل استخدام واتساب API غير رسمي آمن؟
البوابات التي تشغّل WhatsApp Web، مثل WAHA، غير مصرّح بها من واتساب، وشروطه تسمح بتعليق الحسابات التي تستخدم الوصول الآلي أو الرسائل الجماعية. إن اخترت هذا الطريق فاجعله للمحادثات التي يبدأها العميل، وبموافقته، وبإيقاع إرسال صارم، وصمّم نظامك بحيث يمكن نقله إلى Cloud API. أما الرسائل التي تبدأها الشركة بأعداد كبيرة فمكانها الواجهة الرسمية.
كم تكلفة WhatsApp Business API؟
وقت الكتابة (نوفمبر 2026)، تحاسب Meta على كل رسالة مُسلَّمة، حسب فئتها ودولة المستلم. ومنذ 1 أكتوبر 2026 صارت رسائل خدمة العملاء مدفوعة بعد 1,000 رسالة مجانية شهرياً لكل رقم. Meta تحدّث الأسعار عدة مرات في السنة، فاعتمد على جدولها الرسمي.
هل يستطيع بوت واتساب معرفة حالة الطلب؟
نعم، إذا كانت لديه أداة تستعلم من نظام الطلبات. والطريقة الآمنة أن يُربط رقم واتساب بحساب العميل أولاً، ثم تعتمد الأداة على هذا الربط، لا على ما يكتبه الذكاء الاصطناعي، لتحديد الطلبات التي يراها.
هل أحتاج قوالب لإرسال إشعارات الطلبات؟
في Cloud API الرسمية نعم، إذا لم يراسلك العميل خلال آخر 24 ساعة. الرسائل التي تبدأها الشركة خارج هذه النافذة يجب أن تكون قوالب معتمدة في WhatsApp Manager، وتحديثات الطلبات تدخل عادة في الفئة الخدمية Utility.
واتساب أم SMS لتحديثات الطلبات؟
في مصر والخليج يقرأ أغلب العملاء واتساب أولاً، وواتساب يسمح بالرد والروابط والمحادثة مع فريقك. وتبقى SMS مفيدة كبديل للأرقام غير المسجلة على واتساب ولأكواد التحقق.
الخطوة التالية
إذا كان فريقك يرد على "طلبي فين؟" يدوياً، فابدأ بكتابة الأحداث الخمسة أو الستة التي يجب أن يعرفها العميل، ومن يحق له الرد في كل حالة. هذه القائمة هي معظم المواصفات. ولمعرفة متى تتوقف إدارة الطلبات عبر واتساب عن مواكبة النمو، اقرأ لماذا يتعطل الطلب عبر واتساب حين يكبر عملك، ولصورة أوسع عن البوتات راجع دليل شات بوت واتساب للأعمال. وحين تكون جاهزاً، اكتب وصفاً مختصراً لمشروعك وسنخبرك أي طريق يناسبه.