← العودة للمقالات التقنية

حل مشكلة تعليق ويب هوك واتساب بزنس وحظر أرقام ميتا وتأخر رسائل OTP في المتاجر والأنظمة السعودية


الخلاصة التنفيذية (BLUF): أثناء مواسم التسوق الكبرى، قد يؤدي تأخر وصول رسائل التحقق والإشعارات إلى زيادة استياء المستخدمين وتراجع إتمام الطلبات. ربط الويب هوك مباشرة بمعالجات ثقيلة وقواعد البيانات يسبب بطء الاستجابة وتكرار إرسال الأحداث من ميتا. الحل المعماري هو الرد الفوري بـ HTTP 200 مع تفريغ الأحداث في طوابير معالجة خلفية غير متزامنة (مثل Redis BullMQ) لمنع تجميد الخوادم وحماية جودة الرقم.

أعراض المشكلة في بيئة الإنتاج وقت الحملات الكبرى

أثناء الضغط العالي في المتاجر الإلكترونية، تظهر التحديات التشغيلية التالية:

  • تأخر وصول الرسائل: تراكم طلبات الإرسال في أوقات الذروة مما يضاعف استهلاك الـ Rate Limit المتاح.
  • أخطاء تعليق الويب هوك (Gateway Timeouts): استقبال مئات الأحداث في الثانية وتمريرها مباشرة لقاعدة البيانات يسبب تجميد خيوط المعالجة.
  • تأثر تقييم جودة الرقم التجاري: تكرار الرسائل وتأخرها يدفع بعض العملاء للإبلاغ عن الرقم مما يهدد سقف الإرسال المتاح.

السبب الجذري للخلل التقني

تتطلب منصة ميتا (Meta) استقبال تأكيد استلام فوري (HTTP 200). معالجة العمليات الثقيلة بشكل متزامن داخل خيط الويب هوك نفسه (مثل استعلامات SQL وتحديثات الأنظمة الخارجية) تؤدي لنفاد موارد الخادم وتراكم الطلبات، مما يدفع خوادم ميتا لإعادة إرسال نفس الحزم.

نموذج كودي توضيحي لفصل استقبال الويب هوك (للاسترشاد - غير مختبر في بيئة حية)

تنبيه هندسي: هذا النموذج كود توضيحي أولي للاسترشاد المعماري فقط لتوضيح فكرة فصل الاستقبال وتفادي إسقاط الرسائل، ولم يتم اعتماده أو اختباره في بيئة إنتاجية حية. يجب تخصيص معالجة الأخطاء وطوابير Dead-Letter Queue (DLQ) قبل اعتماده في بيئة الإنتاج.

import crypto from 'node:crypto';
import express, { Request, Response } from 'express';
import { Queue } from 'bullmq';

const app = express();
const messageQueue = new Queue('whatsapp-inbound-messages', { connection: { host: '127.0.0.1', port: 6379 } });
const statusQueue = new Queue('whatsapp-status-events', { connection: { host: '127.0.0.1', port: 6379 } });

// 1. Secure HMAC signature validation with length check to prevent timingSafeEqual RangeError
function verifyMetaSignature(req: Request, appSecret: string): boolean {
  const signatureHeader = req.headers['x-hub-signature-256'] as string | undefined;
  if (!signatureHeader || !signatureHeader.startsWith('sha256=')) return false;

  const hmac = crypto.createHmac('sha256', appSecret);
  const expectedSignature = 'sha256=' + hmac.update(req.body).digest('hex');

  const sigBuffer = Buffer.from(signatureHeader, 'utf8');
  const expectedBuffer = Buffer.from(expectedSignature, 'utf8');

  if (sigBuffer.byteLength !== expectedBuffer.byteLength) {
    return false;
  }

  return crypto.timingSafeEqual(sigBuffer, expectedBuffer);
}

// 2. Immediate Webhook Ingest Endpoint (Acknowledge before processing)
app.post('/api/webhooks/whatsapp', express.raw({ type: 'application/json' }), async (req: Request, res: Response) => {
  if (!verifyMetaSignature(req, process.env.META_APP_SECRET || '')) {
    return res.status(403).send('Invalid Signature');
  }

  // Acknowledge HTTP 200 immediately to Meta to avoid retry floods
  res.status(200).send('EVENT_RECEIVED');

  try {
    const payload = JSON.parse(req.body.toString('utf8'));

    // Iterate through all entries and changes without dropping batched events
    for (const entry of payload.entry || []) {
      for (const change of entry.changes || []) {
        const val = change.value;
        if (!val) continue;

        if (Array.isArray(val.messages)) {
          for (const msg of val.messages) {
            await messageQueue.add('inbound_message', {
              metadata: val.metadata,
              contact: val.contacts?.[0],
              message: msg,
            }, { priority: 1, attempts: 3, removeOnComplete: 1000 });
          }
        }

        if (Array.isArray(val.statuses)) {
          for (const status of val.statuses) {
            await statusQueue.add('delivery_status', {
              metadata: val.metadata,
              status,
            }, { priority: 10, removeOnComplete: true });
          }
        }
      }
    }
  } catch (err) {
    console.error('Error queuing webhook payload:', err);
  }
});

مؤشرات تشغيلية مقترحة (أمثلة هندسية داخلية)

المقاييس التالية تمثل أمثلة لمؤشرات أداء تشغيلية مقترحة لمراقبة سرعة الاستجابة:

  • whatsapp_webhook_ack_duration_seconds < 0.05 (مثال لمؤشر SLO داخلي): سرعة الرد المبدئي لتفادي تكرار الحزم.
  • whatsapp_queue_lag == 0 (مثال لمؤشر SLO داخلي): مراقبة خلو طوابير المعالجة من التراكم.

استشارات وشراكة هندسة البنية التحتية والمنصات

هل تحتاج مهندس أول لحماية واستقرار وتوسيع منصتك السحابية؟

من خوادم كوبرنيتيس وتالوس لينكس المستقلة وتخفيض فواتير السحابة بشكل جذري، إلى ضبط أداء وقفل بوستجريس وبناء مسارات الذكاء الاصطناعي السيادي، أعمل مباشرة مع الفرق الهندسية لبناء أنظمة مرنة ومملوكة بالكامل.

استكشف خدمات الاستشارات والحلول الهندسية الأسعار ونماذج التعاقد 💬 WhatsApp (+212 697 720 221)
المراكز الهندسية:الدار البيضاء · المغرب•الرياض · السعودية•دبي · الإمارات•الدوحة · قطر•المنامة · البحرين•مسقط · عمان•عن بعد · دوليا•أتمتة n8n•تقليص فواتير السحابة