انتقل إلى المحتوى
تجربة مجانية 14 يومًا، بلا بطاقة9 لغات176 نوع عمل · 50 تطبيقًا
AR· USD
جرّب عرضًا حيًاابدأ التجربة المجانية

Webhooks الصادرة: كيف يعمل

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

الدرس 3 من 9 · كيف يعمل

  • حوالي 3 دقيقة
  • System → Integrations → Integrations & API

كيف يعمل

  1. في «System → Integrations → Integrations & API» اضغط «Add endpoint» في لوحة «Webhook endpoints». أدخل اسمًا والعنوان، ثم حدّد «All events» أو اختر أحداثًا مفردة من القائمة.

  2. بعد الحفظ يُعرض «Webhook signing secret» مرة واحدة. انسخه إلى النظام المستقبِل، الذي يستخدمه ليتأكد أن الإرسال قادم فعلًا من موقعك.

  3. عندما يقع حدث مشترَك فيه، يرسل النظام التفاصيل إلى العنوان فورًا. على المستقبِل أن يردّ بالنجاح خلال 10 ثوانٍ.

  4. الإرسال الذي يفشل يُعاد بعد دقيقة واحدة، ثم 5 دقائق، ثم 30 دقيقة، ثم ساعتين، ثم 12 ساعة، ثم 24 ساعة. بعد ذلك يُعلَّم كفاشل.

  5. نقطة الاستقبال التي تفشل 25 مرة متتالية يوقفها النظام، وتعرض لوحة التحكم مهمة مطلوبًا تنفيذها. اضغط «Enable» في صفها بعد أن يعود المستقبِل إلى العمل.

  6. «Test» في الصف، أو «Send test event» في صفحة نقطة الاستقبال، يرسل رسالة اختبار. صفحة نقطة الاستقبال تعرض أيضًا آخر الإرسالات إليها وتتيح لك استبدال السر بزر «Rotate secret».

  7. «Delivery log» يسرد كل إرسال مع حالته ونقطة الاستقبال والحدث، والمحتوى الذي أُرسل والرد الذي وصل. «Retry now» يرسل الإرسال الفاشل من جديد. الصفوف تُحفظ 30 يومًا.

أين تجده

إعدادات تغيّره

قائمة التحقق

قبل أن تنتقل، تأكد أنك تستطيع:

  • فتح System → Integrations → Integrations & API
  • في System → Integrations → Integrations & API اضغط Add endpoint في لوحة Webhook endpoints.
  • بعد الحفظ يُعرض Webhook signing secret مرة واحدة.
  • عندما يقع حدث مشترَك فيه، يرسل النظام التفاصيل إلى العنوان فورًا.
  • الإرسال الذي يفشل يُعاد بعد دقيقة واحدة، ثم 5 دقائق، ثم 30 دقيقة، ثم ساعتين، ثم 12 ساعة، ثم 24 ساعة.

نصائح وأخطاء شائعة

  • لا يصل شيء؟ افتح سجل الإرسال واقرأ الرد في الصف الفاشل. الأسباب المعتادة عنوان خاطئ أو مستقبِل يستغرق أكثر من 10 ثوانٍ.
  • الإرسال نفسه قد يصل أكثر من مرة بعد إعادة المحاولة. على النظام المستقبِل أن يستخدم معرّف الإرسال لتجاهل المكرر.
  • بعد «Rotate secret» يُوقَّع الإرسال التالي مباشرة بالسر الجديد، لذلك حدّث النظام المستقبِل في اللحظة نفسها.
  • إعادة المحاولات يرسلها عامل الخلفية. ما دام متوقفًا، لا تُعاد محاولة الإرسالات الفاشلة.