🔗 دليل الويب هوكس

الويب هوكس تتيح لك استقبال أحداث واتساب فوراً على خادمك أو على خدمة مثل n8n.

ما هو الويب هوك؟

عند حدوث حدث (مثل استقبال رسالة أو تغيّر حالة الجلسة)، يرسل Omdaa طلب HTTP POST إلى الرابط (URL) الذي تحدّده. بهذا يمكنك معالجة الرسائل، تشغيل سيناريوهات n8n، أو تحديث قاعدة البيانات دون轮询.

إعداد رابط الويب هوك

يمكن تعيين رابط الويب هوك لكل جلسة عبر API أو من لوحة التحكم. مثال عبر API:

POST https://omdaa.com/api/v1/webhooks
Authorization: Bearer YOUR_JWT_TOKEN
Content-Type: application/json

{
  "sessionId": "sess_xxxxxxxx",
  "url": "https://yourserver.com/webhook/omdaa",
  "events": ["message:received", "message:send", "session:open", "session:close"]
}

أحداث شائعة

شكل الطلب (Payload)

يُرسل Omdaa طلب POST مع Content-Type: application/json. الجسم يحتوي على الحقل event (نوع الحدث) وdata (تفاصيل الحدث). مثال لرسالة واردة:

{
  "event": "message:received",
  "sessionId": "sess_xxx",
  "data": {
    "messageId": "...",
    "from": "966501234567",
    "body": "نص الرسالة",
    "type": "chat",
    ...
  }
}

التكامل مع N8N

ضع رابط ويب هوك عقدة Webhook في n8n كـ url في إعدادات Omdaa. عند استقبال رسالة سيصل الطلب إلى n8n ويمكنك تشغيل الذكاء الاصطناعي أو أي workflow. للرد الفوري، استخدم نمط N8N Bot مع Respond to Webhook في n8n. راجع توثيق N8N Bot ودليل أتمتة الرد بالذكاء الاصطناعي.

← كل الأدلة · الويب هوكس في التوثيق