Webhooks

بدل أن يسأل برنامجك متجرك باستمرار «هل هناك طلب جديد؟»، يرسل المتجر الخبر إلى برنامجك لحظة وقوعه: طلب جديد، أو تغيّر حالة، أو منتج، أو عميل.

المتطلبات

• الميزة متاحة في باقة برو فقط.
• إنشاء الـ webhook متاح لصاحب المتجر. والشرح الكامل، ومعه إنشاء مفتاح الربط، في مقال «مفاتيح الربط (API) وWebhooks».

الخطوات

1. من لوحة التحكم افتح صفحة الإعدادات، ثم اضغط بطاقة Webhooks.
2. اكتب عنوان https الذي يستقبل الأحداث، واختر الأحداث المطلوبة، ثم اضغط إضافة.
3. انسخ المفتاح السري فورًا، فهو يظهر مرة واحدة، واستخدمه في برنامجك للتحقق من توقيع كل حدث.
4. اضغط إرسال تجربة، فتظهر لك نتيجة وصول الحدث أو تعذّره.

ملاحظات

• ينبغي أن يرد برنامجك بسرعة بنجاح (رد من فئة 2xx)، وأن يتجاهل الحدث إذا وصله مرتين، لأن الحدث نفسه قد يُعاد إرساله إذا لم يصل في المرة الأولى.
• إذا استمر الفشل 24 ساعة يتوقف الـ webhook تلقائيًا، فأصلح العنوان وشغّله من جديد.