تخطَّ إلى المحتوى

إدارة وأتمتة بث واتساب

منظومة جونادا للواتساب

بنينا لمشغّل تجارة إلكترونية منظومة بث واتساب وأتمتة قوالب عبر Meta Cloud API، بطابور رسائل يحترم حدود كل عميل وواجهة لإدارة القوالب.

السنة
2025
الدور
خلفية الخدمة وطابور الرسائل وواجهة الإدارة
التصنيف
إدارة وأتمتة بث واتساب
منظومة جونادا للواتساب: منظومة جونادا للواتساب: إدارة وأتمتة بث واتساب

التحدي

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

المنهج

تكامل مباشر مع Meta Cloud API، وطابور Node.js يحترم حدود الإرسال لكل عميل، وواجهة لإدارة القوالب تحاكي مسار موافقة واتساب نفسه ليعرف المسؤول مسبقاً هل ستُقبل المسودة.

النتيجة

منظومة بث تعمل مباشرة مع Meta دون مزوّد رسائل وسيط، مع طابور محدود المعدل ولوحة متابعة لحالة التسليم.

تحت الغطاء

المجال
تجارة إلكترونيّة · CRM · أتمتة تسويق
النوع
منصّة بثّ WhatsApp + CMS دورة حياة القوالب
الفريق
مهندس باك-إند + DevOps + مهندس واجهة إدارة

01

المشكلة الحقيقية

مراسلة WhatsApp بحجم تفرض اختيارًا: تدفع لـTwilio/MessageBird/360dialog رسوم وسيط عن كلّ رسالة فوق أسعار محادثات Meta، تذهب لوسيط يضيف إدارة طوابير + لوحات لكنّه يحجز عملك رهينة لأسعاره. أو تتكامل مع Meta Cloud API مباشرة، ما يعني بناء الطابور، دورة حياة اعتماد القوالب، معالجة إيصال webhook التسليم، الالتزام بمستويات حدود المعدّل، واللوحات بنفسك. اختار المشغّل التكامل المباشر بعد حساب الأرقام بعد السنة الأولى.

02

من فعل ماذا

باك-إند + طابور + واجهة إدارة + تكامل Meta API. لا طبقة SaaS (Twilio، MessageBird، 360dialog) تجلس بين المشغّل وMeta. علاقة مباشرة مع Meta Cloud API تعني الحفاظ على الهامش، تحكّمًا كاملاً بالقوالب، ولا رسوم وسيط لكلّ رسالة.

مهندس باك-إند
Node.js 20 + Fastify. عميل Meta Cloud API مباشر، مستقبل webhook لإيصالات التسليم، مزامنة حالة القوالب.
مهندس طوابير + حدود معدّل
BullMQ على Redis. سلّات حدود معدّل لكلّ عميل تحترم نظام مستويات WhatsApp (250/1k/10k/100k رسالة/يوم حسب درجة الجودة).
مهندس واجهة إدارة
باني قوالب يعكس استمارة الموافقة في Meta، مجدول بثّ، مدير قوائم مستلمين، لوحة معدّل تسليم بتحديثات لحظيّة.
DevOps + مراقبة
PM2، MongoDB Atlas، Sentry لتتبّع الأخطاء، لوحات Grafana لمعدّل التسليم + عمق الطابور.

03

المعمارية

01 — الحافّة

طبقة الحافّة

  • Cloudflare

    CDN · WAF

    يحمي لوحة الإدارة؛ نقطة webhook مسموحة لـIPs Meta فقط

  • Nginx

    بروكسي عكسيّ · TLS

    يوجّه /api → Fastify، /webhooks/meta → عامل webhook مخصّص

02 — التطبيق

طبقة التطبيق (Node.js)

  • Admin API

    Fastify + JWT

    CRUD للمشغّل: قوالب، بثّ، مستلمون، لوحات

  • Meta client

    SDK مخصّص · undici

    تكامل Cloud API مباشر؛ إعادة محاولة مع backoff؛ throttling واعٍ بالمستوى

  • مستقبل webhook

    Fastify · تحقّق توقيع

    تحقّق HMAC-SHA256 قبل أيّ كتابة في قاعدة

  • حاسبة التكلفة

    مصفوفة أسعار + Intl.NumberFormat

    تقدير ما قبل الإرسال دقيق ضمن ±2٪ من فاتورة Meta الفعليّة

03 — اللاتزامن

طبقة اللاتزامن + الطوابير

  • BullMQ

    طابور بـRedis

    طابور لكلّ WABA؛ حدّ معدّل واعٍ بالمستوى؛ إعادة محاولة مع backoff

  • عامل البثّ

    مستهلك BullMQ · 4 عمليّات

    يسحب وظائف، يستدعي Meta، يسجّل ack، يطلق تحديث webhook

  • معالج webhook

    مستهلك BullMQ · idempotent

    إيصالات التسليم → تحديث MongoDB → دفع لحظيّ للوحة الإدارة

04 — البيانات

طبقة البيانات

  • MongoDB Atlas

    قوالب · بثّ · مستلمون

    تخزين بلا مخطّط يناسب تنوّع القوالب؛ فهارس على (waba_id, status)

  • Redis 7

    طابور · كاش · حدّ معدّل

    Redis واحد للطابور + عدّادات سلّة token + كاش جلسة

04

التحديات

  1. 01

    نظام مستويات WhatsApp (250 → 1k → 10k → 100k → بلا حدّ رسالة/يوم حسب درجة الجودة) يتطلّب سلّة token لكلّ عميل تحترم المستوى الحاليّ + تخفض الإيقاع تلقائيًّا عند انخفاض درجة الجودة.

  2. 02

    دورة حياة اعتماد القوالب: مسوّدة → مُرسَلة → قيد المراجعة → معتمَدة/مرفوضة.

  3. 03

    إيصالات التسليم تصل لاتزامنيًّا عبر webhooks لكلّ رسالة — عند 40 ألف رسالة/يوم هذا 40 ألف ضربة webhook. يجب معالجتها كلّها خلال ثانيتين لإبقاء اللوحة حيّة.

  4. 04

    إدارة قوائم المستلمين: WhatsApp يتطلّب تأكيد opt-in لكلّ رقم؛ المنصّة يجب أن تتعقّب حالة الموافقة + تاريخ التسليم لكلّ رقم لتفادي الضرر الصامت لدرجة الجودة من الإرسال إلى أرقام غير مستجيبة.

  5. 05

    شفافيّة التكلفة: المشغّلون يريدون تكلفة كلّ بثّ بعملتهم قبل الإرسال. أسعار Meta تتفاوت حسب بلد المستلم + فئة المحادثة (خدمة، تسويق، مصادقة، خدمة). الحاسبة يجب أن تطابق فواتير Meta ضمن ±2٪.

05

المشكلات الصعبة

  • سلّة حدود معدّل لكلّ عميل

    سلّة token لكلّ حساب WhatsApp Business (WABA)، تعاد التعبئة بمعدّل المستوى الحاليّ. عند خفض المستوى (انخفاض درجة جودة)، تُعاد السلّة فورًا إلى الحدّ الجديد. لا فيضان طابور.

  • واجهة إدارة واعية باعتماد القوالب

    واجهة الإدارة تشغّل مجموعة regex أسباب رفض Meta في الجانب العميل قبل الإرسال. يرى المشغّلون تحذيرات (مثل: «القوالب التسويقيّة لا يمكن أن تحتوي على أرقام هاتف في النصّ») ويعدّلون قبل حرق فتحة إرسال.

  • idempotency لـwebhook

    Meta تعيد محاولة تسليم webhooks الفاشلة حتّى 24 ساعة. قد يصل نفس إيصال التسليم 5 مرّات أو أكثر. مفتاح idempotency على (waba_id + message_id + status) يمنع الحساب المضاعف.

  • محرّك توقّع التكلفة

    مصفوفة أسعار Meta مسبقة التحميل، تُحدَّث يوميًّا. بحث حسب بلد المستلم، تصنيف فئة المحادثة، تحويل عملة وفق العملة الأساس للمشغّل.

06

لماذا هذه التقنيات

  • Node.js + Fastify (باك-إند)

    • بيئة تشغيل event-driven هي التناسب الطبيعيّ لإدخال/إخراج webhook + طابور عالي الإنتاجيّة — 40 ألف إيصال/يوم بـCPU من خانة واحدة.
    • Fastify يتفوّق على Express بـ2-3 أضعاف في إنتاجيّة JSON عند الأحجام الصغيرة لـwebhooks WhatsApp.
    • async/await أصليّ + أنماط Promise.all تجعل التوزيع لكلّ بثّ تافهًا.
  • BullMQ + Redis (طابور)

    • أسماء طوابير لكلّ WABA تعطي عزلًا طبيعيًّا لكلّ عميل دون نسخ Redis منفصلة.
    • إعادة محاولة مع backoff مدمجة تتعامل مع 429s من Meta دون كود مخصّص.
    • أولويّات الوظائف تتيح للرسائل المعاملاتيّة العاجلة قطع الطابور أمام بثّ تسويقيّ كبير.
  • MongoDB (قوالب + بثّ)

    • القوالب ذات بنية شديدة التغيّر (أنواع وسائط الرأس، أعداد الأزرار، تجاوزات اللغة) — تخزين JSON أصليّ يتفادى 5+ هجرات لكلّ ميزة قالب.
    • خطوط aggregation تشغّل لوحة معدّل التسليم دون OLAP جانبيّ.
  • Meta Cloud API مباشر (لا SaaS وسيط)

    • تحكّم كامل بدورة حياة القوالب، ترقيات المستوى، واسترداد درجة الجودة — لا طبقة SaaS تخفي الأذرع.
    • ملكيّة WABA مباشرة تبقى مع المشغّل؛ التحوّل إلى مزوّد آخر لاحقًا يعني تبديل الطابور + اللوحة، لا ترحيل حالة الحساب.

07

ما تعلّمناه

  1. 01

    رسوم الوسيط لكلّ رسالة تتراكم. عند أيّ حجم ذي معنى، امتلاك الوسيط يردّ تكلفته خلال سنة.

  2. 02

    نظام مستويات WhatsApp يكافئ السلوك الجيّد — لكنّه يعاقب الأخطاء بقسوة. استرداد درجة الجودة يستغرق أسابيع. ابنِ واجهة الإدارة لتفادي المسوّدات السيّئة قبل الشحن، لا للتفاعل مع الرفوض فقط.

  3. 03

    idempotency لـwebhook ليس اختياريًّا. Meta ستعيد المحاولة. خطّط له من اليوم الأوّل.

التقنيات

  • Node.js
  • Fastify
  • BullMQ
  • Redis
  • MongoDB
  • Meta Cloud API

أسئلة حول منظومة جونادا للواتساب

من نفّذ منظومة جونادا للواتساب؟

منظومة جونادا للواتساب من تنفيذ شركة علي يوسف، شركة برمجيات في دمشق. نطاق عملنا في المشروع: خلفية الخدمة وطابور الرسائل وواجهة الإدارة.

ما هو منظومة جونادا للواتساب؟

بنينا لمشغّل تجارة إلكترونية منظومة بث واتساب وأتمتة قوالب عبر Meta Cloud API، بطابور رسائل يحترم حدود كل عميل وواجهة لإدارة القوالب.

ما التقنيات المستخدمة في منظومة جونادا للواتساب؟

Node.js، Fastify، BullMQ، Redis، MongoDB، Meta Cloud API.

متى نُفّذ منظومة جونادا للواتساب؟

نُفّذ خلال 2025.

هل يمكن تنفيذ نظام مشابه لـمنظومة جونادا للواتساب لشركتي؟

نعم. نبني أنظمة ERP ونقاط بيع وتطبيقات موبايل ومواقع لعملاء في سوريا ودول الجوار والخليج. للتواصل: info@aliyosef.online.