تخطَّ إلى المحتوى

تلقَّ الإشعارات عبر Webhooks

أرسل رسالة موقّعة إلى تطبيق آخر كلما أُصدرت فاتورة، أو رُحّلت دفعة، أو انخفض المخزون، وغير ذلك.

قراءة في 5 دقيقة شاشات حقيقية، وبيانات نموذجية وهمية تم التحديث 22 أكتوبر 2026

في هذه الصفحة

Webhook هو رسالة نرسلها بطريقة POST إلى عنوان تطبيقك عندما يحدث شيء في شركتك، فلا يضطر التطبيق الآخر إلى السؤال باستمرار.

  1. الخطوة 1: أضف نقطة نهاية

    في الإدارة → الإعدادات → API و Webhooks، ضمن Webhooks، انقر على إضافة نقطة نهاية.

  2. الخطوة 2: أدخل العنوان

    املأ عنوان URL لنقطة النهاية (يجب أن يكون عنوانًا عامًا يبدأ بـ https://) والوصف اختياريًا.

  3. الخطوة 3: اختر الأحداث

    ضمن الأحداث، حدّد ما تحتاجه، أو جميع الأحداث، بما فيها التي تُضاف لاحقًا.

  4. الخطوة 4: انسخ سر التوقيع

    بعد الحفظ، يظهر سر التوقيع مرة واحدة. انسخه إلى التطبيق المستقبِل ليتمكن من التحقق من أن كل رسالة جاءت منا فعلًا.

  5. الخطوة 5: اختبره

    انقر على إرسال حدث تجريبي وتحقق من سجل التسليم.

الأحداث المتاحة

  • جهات الاتصال: تم إنشاء جهة اتصال أو تحديثها.
  • الفواتير: مُصدرة، مدفوعة بالكامل، مُبطلة. عروض الأسعار: مقبولة.
  • المدفوعات: تم ترحيل دفعة أو مقبوض.
  • فواتير الموردين: مستلمة (مرحّلة)، مدفوعة بالكامل. المصروفات: تم تسجيل مصروف.
  • المخزون: انخفض صنف إلى مستوى إعادة الطلب أو أقل منه.
  • الإجازات: تم إنشاء طلب إجازة.

التسليم وإعادة المحاولة

  • يجب أن يرد تطبيقك بحالة 2xx خلال 10 ثوانٍ. وأي رد آخر يُعد فشلًا.
  • تُعاد محاولة عمليات التسليم الفاشلة تلقائيًا، حتى ست محاولات على مدى عدة ساعات، مع فترات انتظار أطول في كل مرة.
  • افتح نقطة نهاية باستخدام إدارة لعرض سجل التسليم: كل حدث مع المحتوى والرد من خادمك وحالة تم التسليم أو فشلت أو قيد الانتظار. انقر على إعادة الإرسال لإرسال أحدها مرة أخرى.
  • ألغِ تحديد إرسال الأحداث إلى نقطة النهاية هذه لإيقافها مؤقتًا، أو انقر على إزالة لحذفها. وتُعطَّل نقطة النهاية التي تستمر في الفشل لفترة طويلة تلقائيًا.

تحقق من التوقيع

يحمل كل تسليم الترويسة X-Webhook-Signature: t=<timestamp>,v1=<signature>. احسب HMAC-SHA256 لـ “<timestamp>.<raw body>” باستخدام سر التوقيع وقارنه بـ v1؛ وارفض الطوابع الزمنية الأقدم من 5 دقائق. تبقى X-Webhook-Id كما هي عبر إعادة المحاولات، لذا استخدمها لتجاهل التكرارات.

اسأل عن المنتج

اسأل عما يمكن للبرنامج فعله، أو كيف تتم مهمة ما، أو الدول واللغات التي يدعمها. تأتي الإجابات من هذه الأدلة.

جارٍ التفكير…

مساعد الذكاء الاصطناعي غير متاح الآن. ابحث في الأدلة أو تحدّث مع فريقنا. تواصل مع الدعم

قد يخطئ الذكاء الاصطناعي. تحقق من الأدلة المرتبطة.

هل ما زلت تحتاج إلى مساعدة؟

يقرأ فريق الدعم كل رسالة ويجيب بلغة واضحة.

تواصل مع الدعم
تحدّث مع الذكاء الاصطناعي