---
title: "Webhook"
description: "Webhook هو طلب HTTP ترسله المنصة إلى عنوان URL تحدده أنت عند وقوع حدث ما، مثل تسليم رسالة أو قراءتها أو فشلها، أو وصول رد من العميل، بحيث يعلم نظامك بذلك فوراً دون الحاجة إلى الاستعلام الدوري (polling)."
canonical: "https://omnichannels.ai/ar/glossary/webhook/"
language: "ar"
updated: "2026-10-10"
publisher: "BroadNet Technologies"
brand: "OmniChannels.ai"
---

# Webhook

Canonical: https://omnichannels.ai/ar/glossary/webhook/
Language: ar
Publisher: OmniChannels.ai by BroadNet Technologies

**التعريف:** Webhook هو طلب HTTP ترسله المنصة إلى عنوان URL تحدده أنت عند وقوع حدث ما، مثل تسليم رسالة أو قراءتها أو فشلها، أو وصول رد من العميل، بحيث يعلم نظامك بذلك فوراً دون الحاجة إلى الاستعلام الدوري (polling).

تسجّل نقطة نهاية (مثل https://example.com/hooks/messaging). وعند وقوع حدث، ترسل المنصة طلب POST بمتن JSON يصف الحدث: معرّف الرسالة، والحالة، والطابع الزمني، والقناة، وتفاصيل الخطأ. وينبغي أن يستجيب خادمك بسرعة برمز 2xx وأن يعالج الحدث بشكل غير متزامن.

صمّم نظامك ليتعامل مع ظروف التسليم الفعلية: فقد تصل طلبات Webhook متأخرة أو بغير ترتيبها أو أكثر من مرة. استخدم معرّف الرسالة والحالة لإزالة التكرار، ولا تُرجع الحالة إلى الوراء أبداً (مثلاً من READ إلى DELIVERED)، واجعل المعالج آمناً عند إعادة المحاولة وغير قابل للتكرار (idempotent).

الأمان: اقبل HTTPS فقط، وتحقّق من التوقيع أو السر المشترك في كل طلب، ولا تثق بالحمولة قبل التحقق منها. وتصف أعراف القطاع، مثل مواصفة Standard Webhooks، أنماطاً شائعة للتوقيع وإعادة المحاولة.

في مجال المراسلة، تغذّي طلبات Webhook تقارير التسليم، ومعدلات القراءة، والردود الواردة، وطلبات إلغاء الاشتراك، وقرارات التحويل الاحتياطي بين القنوات.

ترسل OmniChannels.ai طلبات Webhook لحالات التسليم (SUBMITTED وSENT وDELIVERED وREAD وFAILED وREJECTED)، بصيغة موحدة عبر جميع القنوات.

## مثال

```
{"messageId":"msg_123","channel":"whatsapp","status":"DELIVERED","timestamp":"2026-10-10T09:15:02Z"}
```

## المصادر

- [Standard Webhooks specification](https://www.standardwebhooks.com/)