الأحداث (Webhooks)
أضف اشتراكًا من شاشة Webhooks: الرابط، الأحداث، وطريقة المصادقة. قبل التفعيل نرسل حدث webhook.verification ويجب أن يرد نظامك بـ 2xx.
الأحداث
social.connection.updated | تغيرت حالة الاتصال أو الأذونات |
social.connection.expiring | الاتصال يقترب من الانتهاء |
social.post.published | نُشر على حساب |
social.post.partially_published | نُشر على بعض الحسابات وفشل على غيرها |
social.post.failed | فشل النشر |
social.comment.created | تعليق جديد |
social.comment.updated | تعديل أو إخفاء تعليق |
social.comment.deleted | حذف تعليق |
social.comment.replied | تم الرد من خلال المنصة |
شكل الحدث
POST /your/endpoint
Content-Type: application/json
X-Webhook-Id: evt_0192f0c4...
X-Webhook-Timestamp: 1790426650
X-Webhook-Signature: sha256=5d41402abc4b2a76b9719d911017c592...
X-Webhook-Version: 1.0
X-Webhook-Event: social.comment.created
X-Correlation-Id: CRM-REQUEST-773
{
"id": "evt_0192f0c4...",
"type": "social.comment.created",
"version": "1.0",
"occurredAt": "2026-09-26T10:15:02Z",
"tenantId": "0192...",
"correlationId": "CRM-REQUEST-773",
"externalReference": null,
"data": { "comment": { ... }, "socialAccount": { ... }, "postId": "0192..." }
}
التسليم
- أي رد 2xx يعني نجاحًا. 5xx أو 408 أو 429 أو انقطاع الشبكة يعاد بتأخير متزايد.
- رد 4xx آخر يعتبر رفضًا نهائيًا ولا يعاد تلقائيًا؛ يمكن إعادة إرساله يدويًا من السجل.
- قد يصل نفس الحدث أكثر من مرة: استخدم X-Webhook-Id لتجاهل المكرر.
- بعد عدد قابل للتهيئة من الفشل المتتالي يتوقف الاشتراك مؤقتًا، والأحداث تنتظر حتى تستأنفه.