Webhook صادر

الـ Webhook الصادر لـبوابة رسايل خاصة بيك: مثلًا n8n، أو مزود واتساب غير Meta، أو سيستم داخلي. PropDrop بيبعت للرابط بتاعك طلب POST فيه JSON موقّع، وبوابتك هي اللي توصّل الرسالة للعميل أو تعمل اللي عايزه بالحدث.

الصفحة دي للشخص التقني اللي بيجهّز البوابة. متاح في كل الباقات.

مين يقدر يظبطه: المالك والمدير.

التفعيلانسخ لينك القسم

لو قفلت المفتاح، الرابط بيتمسح («تم إيقاف الـ Webhook الخارجي») وأي طلب كان مستني إعادة محاولة بيتعلّم «فشل».

بنبعت إمتى؟انسخ لينك القسم

كل طلب ليه حدث في الهيدر X-PropDrop-Event:

lead.qualified و viewing.requested و handoff بيتبعتوا لكل المحادثات، من أي قناة، طول ما الرابط متحط.

شكل الطلبانسخ لينك القسم

POST https://gateway.example.com/propdrop
Content-Type: application/json
User-Agent: PropDrop-Webhooks/1.0
X-PropDrop-Event: message.created
Idempotency-Key: 9b2e…
X-PropDrop-Signature: sha256=<hex HMAC-SHA256(secret, body)>

الجسم دايمًا نفس الغلاف:

{
  "event": "message.created",
  "id": "9b2e…",
  "agency_id": "…",
  "created_at": "2026-10-09T12:00:00.000Z",
  "data": { }
}

id هو نفس قيمة Idempotency-Key.

محتوى data لكل حدثانسخ لينك القسم

{
  "message_id": "…",
  "conversation_id": "…",
  "channel": "whatsapp",
  "sender": "ai",
  "text": "أهلاً يا أحمد! عندنا شقق 3 غرف في التجمع تبدأ من …",
  "contact": { "name": "Ahmed Ali", "phone": "+201001234567", "instagram": null }
}

{
  "message_id": "…",
  "conversation_id": "…",
  "channel": "whatsapp",
  "sender": "agent",
  "text": "…",
  "contact": { "name": "Ahmed Ali", "phone": "+201001234567", "instagram": null }
}

التحقق من التوقيعانسخ لينك القسم

X-PropDrop-Signature = sha256= + HMAC-SHA256 بالمفتاح السري على جسم الطلب زي ما هو (raw body)، بصيغة hex. احسب نفس التوقيع وقارنه، وارفض أي طلب مختلف:

import { createHmac, timingSafeEqual } from "node:crypto";

function isFromPropDrop(rawBody, header, secret) {
  if (!header?.startsWith("sha256=")) return false;
  const expected = createHmac("sha256", secret).update(rawBody, "utf8").digest("hex");
  const got = header.slice(7);
  return got.length === expected.length && timingSafeEqual(Buffer.from(got, "hex"), Buffer.from(expected, "hex"));
}

الرد وإعادة المحاولةانسخ لينك القسم

• رد بأي كود 2xx خلال 8 ثواني عشان الطلب يتحسب «اتسلم».
• لو مردتش، أو رديت بكود غير 2xx، أو رديت بتحويل (3xx، مش بنتبع التحويلات)، بنعيد المحاولة بعد حوالي دقيقة، وبعدها بحوالي 5 دقايق. يعني 3 محاولات إجمالي، وبعدها الطلب بيتعلّم «فشل».
• كل إعادة محاولة بتبعت نفس البايتات بالظبط بنفس التوقيع ونفس Idempotency-Key.

Idempotency-Keyانسخ لينك القسم

ممكن نفس الحدث يوصلك أكتر من مرة (مثلًا ردّيت متأخر وإحنا عيدنا المحاولة). خزّن Idempotency-Key وتجاهل أي طلب بمفتاح شفته قبل كده، عشان ماتبعتش نفس الرسالة للعميل مرتين. ومن ناحيتنا، نفس المفتاح مش بيتحط في الطابور غير مرة واحدة.

«آخر الطلبات المبعوتة»انسخ لينك القسم

تحت الإعدادات هتلاقي آخر 10 طلبات بالحدث والحالة («اتسلم»، «بيعيد المحاولة»، «فشل») وعدد المحاولات. لو فيه «فشل»، اتأكد إن الرابط شغال وبيرد 2xx بسرعة.