ماذا يفعل الـ Webhook
يرسل الـ Webhook تفاصيل حدث في متجرك إلى مكان آخر لحظة وقوعه. تختار الحدث والوجهة:
- واجهة برمجة التطبيقات: يرسل Storeep بيانات الحدث إلى عنوان ويب (URL) لخادمك، أو نظام CRM، أو سيناريو Zapier أو Make، أو أداة تتبع الإعلانات.
- البريد الإلكتروني: يرسل Storeep بيانات الحدث إلى عنوان بريد إلكتروني، مثلًا لتستقبل بريدًا لكل طلب جديد.
افتح الإعدادات ← Webhooks. تحتاج إلى صلاحية الإعدادات.
لكثير من الأدوات تطبيق جاهز، وهو أسهل: Google Sheets، وشبكات التوصيل، وبكسلات الإعلانات. اطّلع على سوق التطبيقات أولًا.
إنشاء Webhook
انقر على إضافة webhook جديد، واملأ النموذج، وانقر على إضافة.
- تفعيل: محدد افتراضيًا. عند تحديده تُرسل الأحداث فورًا. ألغِ تحديده لإبقاء الـ Webhook مع إيقافه مؤقتًا.
- الاسم: تسمية لقائمتك، مثل "طلبات CRM الجديدة".
- النوع: واجهة برمجة التطبيقات أو البريد الإلكتروني.
- الحدث:
- تم إنشاء الطلب: يقدّم عميل طلبًا جديدًا.
- تم تحديث الطلب: تتغير حالة الطلب أو تفاصيله.
- تم إنشاء الجلسة: يصل زائر جديد إلى متجرك. لنوع API فقط.
- التنسيق: Json.
- الرابط (نوع API): العنوان الذي يُرسل إليه. يُضاف الجزء
https://تلقائيًا، فاكتب الباقي، مثلapi.example.com/orders. - عنوان البريد الإلكتروني (نوع البريد الإلكتروني): وجهة البريد.
الـ Webhook من نوع البريد الإلكتروني يرسل أحداث الطلبات فقط. إذا اخترت البريد الإلكتروني مع تم إنشاء الجلسة، فلن يُرسل شيء.
وضع بيانات الطلب في الرابط
يمكنك وضع أي حقل من بيانات الحدث داخل الرابط بين قوسين معقوفين مزدوجين، {{field_name}}. مثلًا:
example.com/postback?cid={{fbclid}}&payout={{order_total}}
هذا يرسل معرّف النقرة من Facebook وإجمالي الطلب إلى منصة تتبع إعلانات أو تسويق بالعمولة، دون خادم إضافي. الحقل غير الموجود يصبح فارغًا. لمعرفة أسماء الحقول، أنشئ Webhook من نوع البريد الإلكتروني للحدث نفسه واطّلع على البيانات التي تصلك.
قائمة الـ Webhooks
يعرض كل صف الاسم، وعنوان URL/البريد الإلكتروني، والنوع، والحدث، والتنسيق، والحالة (مفعل أو غير مفعل). انقر على صف لتعديله. حدّد الصفوف واختر حذف الـ webhooks لإزالتها نهائيًا. هناك حد أقصى لعدد الـ Webhooks في كل متجر، وتظهر رسالة عند بلوغه.
يمكنك إنشاء عدة Webhooks للحدث نفسه، مثلًا واحد إلى نظام CRM وآخر إلى أداة تتبع الإعلانات.
عندما يفشل الإرسال
- يجب أن يرد خادمك بسرعة برمز نجاح (2xx). الرد البطيء يُعدّ فشلًا.
- إذا كان خادمك متوقفًا أو مشغولًا (رد 5xx أو 429، أو عدم الرد)، يعيد Storeep المحاولة عدة مرات خلال الدقائق التالية. لا يُعاد إلا إرسال الـ Webhooks التي فشلت، فلا تصل نسخ مكررة إلى الأخرى.
- إذا رفض خادمك الطلب (رد 4xx مثل 404 أو 403)، لا يعيد Storeep المحاولة، لأن العنوان أو إعدادات أمانه خاطئة.
- عندما يفشل Webhook عدة مرات متتالية، يتلقى مالك المتجر بريدًا واحدًا: "إجراء مطلوب: الـ Webhook الخاص بك في Storeep يفشل"، مع اسم الـ Webhook وعنوانه وحدثه وآخر رمز خطأ. بعد أن يعود الـ Webhook للعمل، قد تؤدي مشكلة لاحقة إلى إرسال تحذير جديد. يمكنك إيقاف هذا البريد من الإشعارات.
- الـ Webhooks من نوع البريد الإلكتروني تُرسل مرة واحدة، دون إعادة محاولة.
Webhooks متوقفة بسبب رصيد غير مدفوع
إذا كان على متجرك مبلغ مستحق غير مدفوع ولا تكفي محفظتك لتغطيته، تنتظر الـ Webhooks. وتُرسل بعد أن تضيف رصيدًا ويُسدَّد المبلغ. راجع المحفظة والفواتير.
نصائح
- إذا كان خادمك يحتاج إلى كلمة مرور أو مفتاح، فضعه في استعلام الرابط، مثل
?key=yoursecret. - يعمل تم إنشاء الجلسة مع كل زائر، وقد يكون ذلك كثيرًا في متجر مزدحم. لا تستخدمه إلا إذا كان خادمك يتحمل ذلك.
- لتسمح لأداة بقراءة طلباتك ومنتجاتك متى شاءت، استخدم رمز وصول بدلًا من ذلك.