Skip to main content
صورة غلاف Webhook
توفر Webhooks إشعارات فورية عند وقوع أحداث محددة في حسابك على Dodo Payments. استخدم Webhooks لأتمتة سير العمل، وتحديث قاعدة بياناتك، وإرسال الإشعارات، والحفاظ على مزامنة أنظمتك.
يتبع تنفيذ Webhook لدينا مواصفة Standard Webhooks، مما يضمن التوافق مع أفضل ممارسات المجال ومكتبات Webhook الحالية.

الميزات الرئيسية

Real-time Delivery

تلقَّ إشعارات فورية عند وقوع الأحداث

Secure by Default

يتضمن التحقق من التوقيع باستخدام HMAC SHA256

Automatic Retries

منطق إعادة محاولة مضمّن مع تأخير أُسّي

Event Filtering

اشترك فقط في الأحداث التي تحتاج إليها

البدء

تمت إعادة بناء بوابة webhooks الخاصة بـ Dodo Payments لتوفير تجربة لوحة تحكم أصلية. لم تتغير نقاط النهاية الحالية أو أسرار التوقيع أو التحقق من التوقيع أو أسماء الأحداث أو حمولات webhook. لا يلزم إجراء أي عمل على التكامل.
أماكن وجود الميزات.
  • ضمن Developer → Webhooks — علامات التبويب Endpoints وEvent catalog وLogs وActivity وSettings.
  • ضمن نقطة نهاية فردية — علامة التبويب Overview، التي تتضمن إحصاءات التسليم وسر التوقيع وReplay history، بالإضافة إلى علامتي التبويب Testing وAdvanced وإجراءات إعادة التشغيل المجمّعة.
  • ضمن رسالة — تُفتح من علامة التبويب Logs، حيث يمكن إعادة تشغيل كل محاولة تسليم على حدة دون فتح نقطة النهاية.
1

Access Webhook Settings

انتقل إلى لوحة تحكم Dodo Payments ثم إلى Developer → Webhooks.
2

Create Webhook Endpoint

انقر على Add endpoint لفتح اللوحة الجانبية لإنشاء نقطة نهاية.
3

Enter Endpoint URL or Choose Integration

أدخل عنوان URL الذي تريد استقبال أحداث webhook عليه، أو حدد موصل تكامل لتوجيه الأحداث إلى خدمة تابعة لجهة خارجية (Slack وDiscord وZapier وResend وغير ذلك).
4

Select Events to Receive

اختر الأحداث المحددة التي يجب أن تستمع إليها نقطة النهاية. تُنظّم الأحداث في شجرة قابلة للبحث ومجمّعة حسب المورد. يمكنك تحديد أحداث فردية أو مورداً رئيسياً لاستقبال جميع الأحداث المرتبطة به.
ستؤدي الأحداث المحددة فقط إلى تشغيل webhooks لنقطة النهاية، مما يساعدك على تجنب حركة المرور والمعالجة غير الضروريتين.
5

Create Endpoint

انقر على Create endpoint لحفظ إعداداتك.
6

Get Secret Key

يظهر سر توقيع webhook الخاص بك في علامة التبويب Overview لنقطة النهاية. ستستخدمه للتحقق من صحة webhooks المستلمة.
احرص على أمان مفتاح سر webhook ولا تكشفه مطلقاً في التعليمات البرمجية من جهة العميل أو المستودعات العامة.
7

Rotate Secret (Optional)

عند الحاجة، يمكنك تدوير سر webhook لتعزيز الأمان. انقر على Rotate secret بجانب السر في علامة التبويب Overview.
سيؤدي تدوير السر إلى إبطال السر الحالي واستبداله بآخر جديد. سيظل السر القديم صالحاً خلال الساعات الأربع والعشرين التالية فقط. بعد ذلك، سيفشل التحقق باستخدام السر القديم.
استخدم تدوير السر بشكل دوري أو فوراً إذا اشتبهت في تعرض سرك الحالي للاختراق.

موصلات التكامل

بدلاً من إنشاء مستقبِل webhook خاص بك، يمكنك توجيه أحداث webhook مباشرةً إلى خدمات تابعة لجهات خارجية باستخدام موصلات التكامل. يلغي ذلك الحاجة إلى كتابة معالجات webhook مخصصة للمنصات الشائعة وصيانتها.

آلية عمل الموصلات

ينفذ الموصل عملية تحويل تغيّر حدث Dodo Payments إلى الصيغة التي تتوقعها الوجهة. وتختلف التفاصيل التي تقدمها حسب الوجهة: يعرض محدد الموصلات في لوحة التحكم المجموعة الكاملة المتاحة حالياً لنشاطك التجاري، لذا تعامل مع الجدول أعلاه على أنه الوجهات التي تتوفر لها تعليمات إعداد خطوة بخطوة، وليس قائمة شاملة. راجع External Integrations لمعرفة ما يمكن لكل وجهة فعله بعد وصول الأحداث إليها.

إعداد موصل

اختر موصلاً أثناء إنشاء نقطة نهاية أو تعديلها، وستعرض اللوحة الجانبية تعليمات إعداد مخصصة لتلك الوجهة — مثل كيفية إنشاء عنوان URL لـ Incoming webhook في Slack أو مكان العثور على مفتاح Resend API. قبل الحفظ، شغّل اختبار تحويل الموصل للتأكد من تحويل الحدث بشكل صحيح للوجهة.
استخدم موصلاً للوصول إلى وجهة مدعومة دون كتابة تعليمات برمجية. إذا كنت تحتاج إلى منطق مخصص، فاستخدم نقطة نهاية قياسية مع transformation بدلاً من ذلك.

إعداد الأحداث المشترك فيها

يمكنك إعداد الأحداث المحددة التي يجب أن تستقبلها كل نقطة نهاية webhook.
1

Navigate to Webhook Endpoints

انتقل إلى لوحة تحكم Dodo Payments ثم إلى Developer → Webhooks.
2

Select Your Endpoint

انقر على نقطة نهاية webhook التي تريد إعدادها.
3

Open Event Configuration

انقر على Edit لفتح اللوحة الجانبية لإعداد نقطة النهاية.
4

Browse Event Types

يعرض محدد نوع الحدث جميع أحداث webhook المتاحة في شجرة قابلة للبحث ومجمّعة حسب المورد (مثل payment وsubscription وdispute). استخدم شريط البحث للعثور سريعاً على أحداث محددة بالاسم أو الكلمة المفتاحية.
5

Select Events

حدد المربعات بجانب الأحداث التي تريد استقبالها. يمكنك:
  • تحديد أحداث فردية (مثل payment.succeeded وpayment.failed)
  • تحديد مورداً رئيسياً لاستقبال جميع الأحداث المرتبطة به
  • الجمع بين أحداث محددة وفقاً لاحتياجاتك
6

Save Configuration

انقر على Save لتطبيق تغييراتك، أو Cancel لتجاهل التعديلات.
إذا ألغيت تحديد جميع الأحداث، فلن تستقبل نقطة نهاية webhook أي إشعارات. احرص على تحديد الأحداث التي يحتاج إليها تطبيقك للعمل بشكل صحيح على الأقل.

كتالوج الأحداث

انتقل إلى Developer → Webhooks وافتح علامة التبويب Event catalog. تسرد هذه العلامة كل نوع من الأحداث التي يمكن لـ Dodo Payments إرسالها، حتى تتمكن من معرفة المتاح قبل اشتراك نقطة نهاية فيه. حدد حدثاً لعرض مخططه ومثال على حمولته، وهي أسرع طريقة للتحقق من بنية حقل تنوي قراءته.

Webhook Events Guide

تصفح الأحداث نفسها بوصفها وثائق مرجعية، مجمّعة حسب المورد.

تسليم webhook

مهلات الانتظار

تملك webhooks نافذة مهلة مدتها 15 ثانية لكل من عمليات الاتصال والقراءة. تأكد من استجابة نقطة النهاية بسرعة لتجنب انتهاء المهلة.
عالج webhooks بشكل غير متزامن عبر تأكيد الاستلام فوراً باستخدام رمز الحالة 200، ثم نفّذ المعالجة الفعلية في الخلفية.

عمليات إعادة المحاولة التلقائية

عند فشل تسليم webhook، يعيد Dodo Payments المحاولة تلقائياً باستخدام تأخير أُسّي لتجنب إغراق نظامك.
حد أقصى 8 محاولات إعادة لكل حدث webhook. على سبيل المثال، إذا فشل webhook ثلاث مرات قبل نجاحه، فسيكون إجمالي وقت التسليم نحو 35 دقيقة و5 ثوانٍ من المحاولة الأولى.
استخدم لوحة تحكم Dodo Payments لإعادة محاولة رسائل فردية يدوياً أو استرداد جميع الرسائل الفاشلة بشكل مجمّع في أي وقت.

Idempotency

يتضمن كل حدث webhook ترويسة webhook-id فريدة. استخدم هذا المعرّف لتنفيذ idempotency ومنع المعالجة المكررة.
نفّذ دائماً عمليات التحقق من idempotency. بسبب عمليات إعادة المحاولة، قد تستقبل الحدث نفسه عدة مرات.

ترتيب الأحداث

قد تصل أحداث webhook بترتيب مختلف بسبب عمليات إعادة المحاولة أو ظروف الشبكة. صمّم نظامك للتعامل مع الأحداث بأي تسلسل.
ستتلقى أحدث حمولة وقت التسليم، بغض النظر عن وقت إصدار حدث webhook الأصلي.

تأمين webhooks

لضمان أمان webhooks، تحقّق دائماً من صحة الحمولات واستخدم HTTPS.

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

يتضمن كل طلب webhook ترويسة webhook-signature، وهي توقيع HMAC SHA256 لحمولة webhook والطابع الزمني، وموقّعة باستخدام مفتاحك السري.

التحقق باستخدام SDK (موصى به)

تتضمن جميع SDKs الرسمية أدوات مساعدة مدمجة للتحقق الآمن من صحة webhooks الواردة وتحليلها. تتوفر طريقتان:
  • unwrap(): يتحقق من التوقيعات باستخدام مفتاح سر webhook
  • unsafe_unwrap(): يحلل الحمولات دون التحقق
أدخل سر webhook عبر DODO_PAYMENTS_WEBHOOK_KEY عند تهيئة عميل Dodo Payments.

التحقق اليدوي (بديل)

إذا لم تكن تستخدم SDK، يمكنك التحقق من التوقيعات بنفسك باتباع مواصفات Standard Webhooks:
  1. أنشئ الرسالة الموقّعة عبر ربط webhook-id وwebhook-timestamp والسلسلة الخام الدقيقة الممثلة نصياً لـ payload، مع الفصل بينها بنقاط (.).
  2. احسب HMAC SHA256 لهذه السلسلة باستخدام مفتاح سر webhook من لوحة التحكم.
  3. قارن التوقيع المحسوب بترويسة webhook-signature. إذا تطابقا، يكون webhook صحيحاً.
نتبع مواصفات Standard Webhooks. يمكنك استخدام مكتباتهم للتحقق من التوقيعات: https://github.com/standard-webhooks/standard-webhooks/tree/main/libraries. لمعرفة تنسيقات حمولات الأحداث، راجع Webhook Payload.

عناوين IP المصدر

يُعد التحقق من التوقيع الطريقة المدعومة لمصادقة webhook. فهو يثبت أن الطلب وُقّع باستخدام سر webhook الخاص بك، وهو أمر لا يمكن لفحص على مستوى الشبكة إثباته. تُرسل عمليات تسليم webhook من مجموعة من عناوين IP المصدر التي تنتمي إلى بنية التسليم التحتية لدينا. تتغير هذه المجموعة من وقت لآخر، لذا تعامل مع العناوين باعتبارها تفاصيل تشغيلية وليست خاصية ثابتة للتكامل.
لا تستخدم قائمة سماح لعناوين IP المصدر كآلية للمصادقة. فقائمة السماح توضح فقط مصدر الطلب، ولا تثبت أنه حقيقي أو لم يتم تعديله — تحقّق من header webhook-signature في كل طلب، كما هو موضح في التحقق من التوقيعات.
إذا كانت بنيتك التحتية خلف جدار حماية يتطلب قائمة سماح صريحة، فضع الأمور التالية في الاعتبار:
  • لا تُضمّن العناوين في الشيفرة بشكل دائم. تُضاف النطاقات وتُزال بمرور الوقت، وقد تؤدي قاعدة قديمة إلى حظر عمليات التسليم دون إشعار.
  • اطلب النطاقات الحالية من support@dodopayments.com قبل تقييد جدار الحماية، لضمان استخدامك قائمة محدثة.
  • راقب إشعارات التغيير. عند تغيير عناوين التسليم، نُخطر التجار المتأثرين عبر البريد الإلكتروني — طبّق هذه التحديثات قبل التاريخ المحدد لتجنب فقدان عمليات التسليم.
  • أبقِ التحقق من التوقيع مفعّلًا بغض النظر عن أي قواعد شبكة تضيفها.
في منصات serverless والاستضافة المُدارة، غالبًا ما تكون تصفية IP الواردة غير متاحة أو غير عملية للصيانة. ويُعد التحقق من التوقيع عنصر التحكم الصحيح في هذه البيئات، ولا تكون هناك حاجة إلى قائمة سماح.
يُعامل التسليم المحظور مثل أي فشل آخر، وتتم إعادة محاولته وفق الجدول الموضح في إعادة المحاولات التلقائية. إذا تسببت قواعد جدار الحماية في فشل عمليات التسليم، يمكنك إعادة إرسالها بعد إصلاح القواعد — راجع إعادة تشغيل الرسائل واستردادها.

الاستجابة إلى Webhooks

  • يجب أن يعيد معالج webhook الخاص بك 2xx status code للإقرار باستلام الحدث.
  • ستُعامل أي استجابة أخرى على أنها فشل، وستتم إعادة محاولة webhook.

أفضل الممارسات

استخدم دائمًا عناوين HTTPS URL لنقاط نهاية webhook. تكون نقاط نهاية HTTP عرضة لهجمات الرجل في الوسط وتكشف بيانات webhook الخاصة بك.
أعد رمز الحالة 200 فورًا عند استلام webhook. عالج الحدث بشكل غير متزامن لتجنب انتهاء المهلة.
طبّق idempotency باستخدام header webhook-id لمعالجة الحدث نفسه عدة مرات بأمان دون آثار جانبية.
خزّن سر webhook بأمان باستخدام environment variables أو مدير أسرار. لا تُودع الأسرار أبدًا في نظام التحكم بالإصدارات.

بنية Payload الخاص بـ Webhook

يساعدك فهم بنية payload الخاص بـ webhook على تحليل الأحداث ومعالجتها بشكل صحيح.

تنسيق الطلب

Headers

string
مطلوب
معرّف فريد لحدث webhook هذا. استخدمه لإجراء فحوصات idempotency.
string
مطلوب
توقيع HMAC SHA256 للتحقق من صحة webhook.
string
مطلوب
طابع زمني Unix (بالثواني) يوضح وقت إرسال webhook.

نص الطلب

string
مطلوب
معرّف نشاطك التجاري في Dodo Payments.
string
مطلوب
نوع الحدث الذي أدى إلى تشغيل webhook هذا (مثل payment.succeeded أو subscription.active).
string
مطلوب
طابع زمني منسق وفق ISO 8601 يوضح وقت وقوع الحدث.
object
مطلوب
Payload خاص بالحدث، ويحتوي على معلومات تفصيلية عنه.

Payload نموذجي

Event Types

تصفّح جميع أنواع أحداث webhook المتاحة

Event Payloads

اعرض مخططات payload التفصيلية لكل حدث

Handle Payment Failures

استجب إلى payment.failed واسترد المدفوعات المرفوضة

اختبار Webhooks

يمكنك اختبار تكامل webhook مباشرةً من لوحة تحكم Dodo Payments للتأكد من أن نقطة النهاية تعمل بشكل صحيح قبل بدء التشغيل الفعلي.
1

Navigate to Webhooks

انتقل إلى لوحة تحكم Dodo Payments، ثم انتقل إلى Developer → Webhooks.
2

Select Your Endpoint

انقر على نقطة نهاية webhook للوصول إلى صفحة تفاصيلها.
3

Open Testing Tab

انقر على علامة تبويب Testing للوصول إلى واجهة اختبار webhook.

إرسال حدث نموذجي

ترسل علامة تبويب Testing payload نموذجيًا إلى نقطة النهاية هذه حتى تتمكن من التحقق من مستقبلك.
1

Select Event Type

استخدم Select an event type لاختيار الحدث الذي تريد اختباره، مثل payment.succeeded أو payment.failed.
2

Send Example

انقر على Send example. يُسلّم payload النموذجي إلى عنوان URL لنقطة النهاية تمامًا مثل الحدث الحقيقي، ويُوقّع بالطريقة نفسها.
لا تتم إعادة محاولة الرسائل الفاشلة المُرسلة من علامة تبويب Testing. استخدمها للتحقق من مستقبلك، وليس لاختبار جدول إعادة المحاولات.
3

Check Your Endpoint

تسجل علامة التبويب وقت إرسال Last example sent. تأكد من وصول الحدث، ومن نجاح التحقق من التوقيع، ومن إعادتك رمز الحالة 2xx.

مثال على التنفيذ

إليك تنفيذًا كاملًا باستخدام Express.js يوضح التحقق من webhook ومعالجته:
اختبر معالج webhook بشكل شامل باستخدام واجهة الاختبار في لوحة التحكم قبل معالجة أحداث الإنتاج. يساعد ذلك على تحديد المشكلات وإصلاحها مبكرًا.

اختبار Webhooks باستخدام CLI

يوفر Dodo Payments CLI أمرين لاختبار webhooks أثناء التطوير المحلي، دون الحاجة إلى مغادرة الطرفية.

الاستماع إلى Webhooks المباشرة محليًا

أعد توجيه أحداث webhook الحقيقية من حساب وضع الاختبار إلى خادم التطوير المحلي في الوقت الفعلي:
يفتح CLI اتصال WebSocket بـ Dodo Payments ويعيد توجيه كل حدث webhook إلى نقطة النهاية المحلية (مثل http://localhost:3000/webhook)، مع الحفاظ على جميع Headers، بما فيها Headers الخاصة بالتوقيع لاختبار التحقق.
يعمل المستمع فقط مع مفاتيح API الخاصة بـ test mode. شغّل dodo login واختر Test Mode قبل استخدام هذا الأمر.

تشغيل أحداث Webhook وهمية

أرسل payloads وهمية لـ webhook إلى أي نقطة نهاية دون إنشاء معاملات حقيقية:
تتيح لك هذه الأداة التفاعلية اختيار نوع حدث وإرسال payload وهمي واقعي إلى نقطة النهاية الخاصة بك. وتستمر في حلقة حتى تتمكن من اختبار أحداث متعددة في جلسة واحدة. يغطي أمر التشغيل جميع أنواع الأحداث البالغ عددها 47 التي يسلّمها Dodo Payments، بما في ذلك عائلات الاشتراكات والمدفوعات والمبالغ المستردة والنزاعات ومفاتيح الترخيص وعمليات الدفع والائتمانات وعمليات الدفع المتروكة والتحصيل والمنح الخاصة بالاستحقاقات — راجع أحداث Webhook المدعومة للاطلاع على القائمة الدقيقة.
إن payloads الوهمية لـ webhook من dodo wh trigger غير موقّعة. استخدم unsafe_unwrap() بدلًا من unwrap() في معالج webhook الخاص بك أثناء الاختبار فقط.

CLI Webhook Testing Docs

راجع وثائق اختبار webhook الكاملة الخاصة بـ CLI

الإعدادات المتقدمة

توفر علامة تبويب Advanced خيارات تكوين إضافية لضبط سلوك نقطة نهاية webhook بدقة.

تحديد معدل الإرسال (Throttling)

تحكم في معدل تسليم أحداث webhook إلى نقطة النهاية لمنع إرهاق نظامك.
1

Open Advanced Tab

من صفحة تفاصيل نقطة النهاية، انقر على علامة تبويب Advanced.
2

Configure Rate Limit

في قسم “Rate Limit (throttling)”، انقر على Edit لتعديل إعدادات حد المعدل.
لا يتم تطبيق حد معدل على webhooks افتراضيًا، ما يعني أن الأحداث تُسلّم فور وقوعها.
3

Set Your Limit

اضبط حد المعدل المطلوب للتحكم في وتيرة تسليم webhook ومنع زيادة الحمل على النظام.
استخدم تحديد معدل الإرسال عندما يحتاج معالج webhook إلى وقت لمعالجة الأحداث أو عندما تريد تجميع عدة أحداث معًا.

Headers مخصصة

أضف Headers مخصصة إلى جميع طلبات webhook المُرسلة إلى نقطة النهاية. يفيد ذلك في المصادقة أو التوجيه أو إضافة البيانات الوصفية.
1

Add Headers

في قسم “Custom Headers”، أدخل Key وValue لكل Header مخصص.
2

Add Multiple Headers

انقر على زر + لإضافة Headers مخصصة إضافية حسب الحاجة.
تُضمّن Headers المخصصة في جميع طلبات webhook إلى نقطة النهاية هذه.

التحويلات

تتيح لك التحويلات تعديل payload الخاص بـ webhook وإعادة توجيهه اختياريًا إلى عنوان URL مختلف. وتمكّنك هذه الميزة القوية من:
  • تعديل بنية payload قبل المعالجة
  • توجيه webhooks إلى نقاط نهاية مختلفة استنادًا إلى المحتوى
  • إضافة الحقول إلى payload أو إزالتها
  • تحويل تنسيقات البيانات
1

Enable Transformations

بدّل مفتاح Enabled لتفعيل ميزة التحويل.
2

Configure Transformation

انقر على Edit transformation لتعريف قواعد التحويل باستخدام JavaScript.
3

Test Transformation

استخدم واجهة اختبار التحويل للتحقق من عمل التحويل بشكل صحيح قبل بدء التشغيل الفعلي.
قد تؤثر التحويلات في أداء تسليم webhook. اختبرها بشكل شامل وحافظ على بساطة منطق التحويل وكفاءته.
تكون التحويلات مفيدة بشكل خاص في:
  • التحويل بين تنسيقات بيانات مختلفة
  • تصفية الأحداث استنادًا إلى معايير محددة
  • إضافة حقول محسوبة إلى payload
  • توجيه الأحداث إلى microservices مختلفة

مراقبة سجلات Webhook

توفر علامة تبويب Logs رؤية شاملة لحالة تسليم webhook، ما يتيح لك مراقبة أحداث webhook وتصحيح أخطائها وإدارتها بفعالية.
1

Navigate to Logs Tab

انتقل إلى Developer → Webhooks وافتح علامة تبويب Logs.
2

Browse Delivery History

اعرض جدولًا يضم جميع محاولات تسليم webhook، مع أعمدة لنوع الحدث، ومعرّف الرسالة، ومعرّف الحدث، ووقت الإرسال، ووقت المحاولة، ورمز الاستجابة، والمدة.
3

Search and Filter

استخدم شريط البحث للعثور على رسائل محددة حسب المعرّف أو نوع الحدث. ويمكنك التصفية حسب الحالة (Succeeded أو Failed أو Pending وما إلى ذلك) للتركيز على الأحداث التي تحتاج إلى التحقيق فيها.
4

View Message Details

انقر على أي رسالة لفتح صفحة تفاصيل الرسالة، التي تعرض:
  • Payload الكامل لـ webhook
  • كل محاولة تسليم مع رمز الاستجابة والمدة
  • الطابع الزمني لكل محاولة
  • أي رسائل خطأ من نقطة النهاية الخاصة بك
تتضمن كل محاولة إجراء Replay، حتى تتمكن من إعادة دفع تلك الرسالة دون مغادرة الصفحة.

مراقبة النشاط

انتقل إلى Developer → Webhooks وافتح علامة تبويب Activity لعرض أداء التسليم عبر نقاط النهاية الخاصة بك. يعرض Delivery activity المحاولات بمرور الوقت، مجمّعةً في Attempts per 5 minutes أو Attempts per hour أو Attempts per day وفقًا للإطار الزمني. ينقسم كل شريط حسب النتيجة، ويؤدي تمرير المؤشر فوق مقطع إلى عرض الحالة وعدد المحاولات ونسبته من الإجمالي. وفي نقطة النهاية، تلخص Delivery stats (last 24h) في علامة تبويب Overview المعلومات نفسها لليوم الماضي.
يوضح عمود Error rate (24h) في علامة تبويب Endpoints بسرعة نقاط النهاية التي تحتاج إلى اهتمام، قبل فتح أي منها.

إعادة تشغيل الرسائل واستردادها

تعتمد طريقة إعادة دفع الرسالة على عدد الرسائل التي تحتاج إليها:
  • رسالة واحدة — افتحها من علامة تبويب Logs واستخدم إجراء Replay على المحاولة. لا حاجة إلى فتح نقطة النهاية.
  • نطاق من الرسائل — افتح نقطة النهاية، إذ تعمل أوضاع المعالجة المجمعة على نقطة نهاية واحدة في كل مرة.

إعادة التشغيل بشكل مجمع

افتح نقطة النهاية من Developer → Webhooks. تتوفر ثلاثة أوضاع، يعمل كل منها على نقطة النهاية وحدها. يعتمد النطاق الذي تحدده على الوضع:
1

Open More Actions

في نقطة النهاية، افتح More actions واختر أحد الأوضاع الثلاثة أعلاه.
2

Set the Range

أدخل النطاق الذي يطلبه الوضع، كما هو مذكور في الجدول.
3

Start the Run

انقر على Recover أو Replay، وفقًا للوضع الذي اخترته.
يظهر كل تشغيل ضمن Replay history في علامة تبويب Overview الخاصة بنقطة النهاية، مع وضعه ونطاقه الزمني وحالته وعدد الرسائل التي أُعيد إرسالها.

تنبيهات البريد الإلكتروني

استلم إشعارًا عبر البريد الإلكتروني عند فشل عمليات تسليم webhook إلى نقطة نهاية، حتى تتمكن من معالجة المشكلات قبل تحولها إلى تراكمات.
1

Navigate to Settings Tab

انتقل إلى Developer → Webhooks وافتح علامة تبويب Settings.
2

Find Email Alerting

حدّد بطاقة Email alerting.
3

Configure Email Addresses

أدخل العناوين التي ينبغي أن تتلقى التنبيهات. افصل بين العناوين المتعددة بفواصل، واترك الحقل فارغًا لإيقاف التنبيهات.
4

Save

انقر على Save لتطبيق تغييراتك.
فعّل تنبيهات البريد الإلكتروني لاكتشاف مشكلات تسليم webhook مبكرًا والحفاظ على تكاملات موثوقة.

النشر على المنصات السحابية

هل أنت مستعد لنشر معالج webhook في بيئة الإنتاج؟ نوفر أدلة خاصة بالمنصات لمساعدتك على نشر webhooks لدى موفري الخدمات السحابية الشائعين، مع أفضل الممارسات لكل منصة.

Vercel

انشر webhooks على Vercel باستخدام serverless functions

Cloudflare Workers

شغّل webhooks على شبكة Cloudflare الطرفية

Supabase Edge Functions

ادمج webhooks مع Supabase

Netlify Functions

انشر webhooks كـ Netlify serverless functions
يتضمن كل دليل خاص بمنصة إعداد البيئة والتحقق من التوقيع وخطوات النشر الخاصة بموفر الخدمة.

مرجع API ذي الصلة

Create Webhook

مرجع API لإنشاء نقاط نهاية webhook وتهيئتها برمجيًا

List Webhooks

مرجع API لاسترداد نقاط نهاية webhook وإدارتها
آخر تعديل في ٢١ أغسطس ٢٠٢٦