مرجع الـ Payload
كل تسليم webhook يستخدم هذا الهيكل. الحقول المشتركة متسقة عبر المنصات. الحقول الخاصة بكل منصة موثقة أدناه.
الحقول المشتركة (جميع المنصات)
| الحقل | النوع | الوصف |
|---|---|---|
platform | string | "facebook" | "instagram" | "whatsapp" |
event | string | "message.received" | "conversation.started" | "status.update" |
timestamp | number | طابع زمني Unix (بالثواني) لوقت وقوع الحدث |
webhook_id | string | معرف إعداد webhook الخاص بك في SocialHook |
conversation_id | string | معرف ثابت لخيط المحادثة |
message | object | كائن محتوى الرسالة (يتفاوت حسب المنصة والنوع) |
WhatsAppحقول خاصة بـ
| الحقل | النوع | الوصف |
|---|---|---|
from | string | رقم هاتف المرسل بتنسيق E.164 (+15550001234) |
profile.name | string | الاسم المعروض في WhatsApp للمرسل |
message.type | string | "text" | "image" | "audio" | "video" | "document" | "location" | "sticker" |
message.body | string | نص الرسالة (لـ type="text") |
message.media_url | string | رابط لتنزيل الوسائط (للصور/الصوت/الفيديو/المستندات) |
Facebookحقول خاصة بـ
| الحقل | النوع | الوصف |
|---|---|---|
from.id | string | معرف مستخدم Facebook للمرسل (PSID) |
from.name | string | الاسم المعروض في Facebook للمرسل |
page_id | string | معرف صفحة Facebook التي استقبلت الرسالة |
message.text | string | محتوى نص الرسالة |
message.attachments | array | مصفوفة كائنات المرفقات للصور والفيديوهات وغيرها |
Instagramحقول خاصة بـ
| الحقل | النوع | الوصف |
|---|---|---|
from.id | string | معرف مستخدم Instagram للمرسل |
from.username | string | @username المرسل |
account_id | string | معرف حساب Instagram Business |
message.text | string | محتوى نص الرسالة المباشرة |
story_id | string | معرف القصة عندما تكون الرسالة ردًا على قصة (اختياري) |