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

Webhooks: ربط منصتك بـZapier وMake وأنظمتك

يرسل يربح رسالة JSON موقّعة إلى رابطك عند كل شراء أو عميل أو استرداد أو اشتراك، مع المحاولات والإيقاف والتحقق من التوقيع.

ما هي Webhooks؟

عند كل شراء أو عميل جديد أو استرداد أو اشتراك، يرسل يربح رسالة JSON إلى رابط تحدده. استخدمها لربط منصتك بأدوات مثل Zapier وMake وn8n، أو بنظامك الخاص، لإضافة المشترين إلى قائمة بريدية أو جدول أو CRM آخر. الميزة متاحة في خطة الأعمال.

من يستطيع استخدامها؟

متاحة في: الأعمال، ويمكن إضافتها لخطة الاحترافية من متجر التطبيقات. حتى 5 روابط لكل منصة.

إضافة رابط

  1. من القائمة افتح Webhooks.
  2. الصق رابط الاستقبال (يبدأ بـhttps://)، مثل رابط «Catch Hook» في Zapier.
  3. اختر الأحداث، ثم اضغط إضافة الرابط.
  4. انسخ مفتاح التوقيع فورًا، فلن يظهر مرة أخرى.
  5. اضغط إرسال تجربة وتأكد أن الحدث وصل في السجل.

الأحداث

  • purchase.completed: طلب مدفوع، برقمه والعميل والمنتجات والمبالغ.
  • customer.created: أول شراء لعميل جديد.
  • refund.completed: استرداد تم بنجاح.
  • subscription.started وsubscription.ended: بداية العضوية أو الاشتراك أو التقسيط ونهايتها.

المبالغ أرقام صحيحة بأصغر وحدة للعملة (100 = 1.00).

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

كل طلب يحمل الترويسة Yarbah-Signature بالصيغة t=الوقت,v1=التوقيع. التوقيع هو HMAC-SHA256 للنص «الوقت.محتوى الطلب» بمفتاح التوقيع. احسبه في نظامك وقارنه، وارفض الطلب إذا اختلف أو كان أقدم من 5 دقائق. ترويسة Yarbah-Delivery رقم فريد لكل حدث، فاستخدمها لتجاهل التكرار.

إذا فشل الإرسال

يجب أن يرد رابطك بحالة 2xx خلال 10 ثوانٍ. غير ذلك يُعاد الإرسال حتى 8 مرات بفواصل تزيد من دقيقة حتى يوم. إذا فشل 20 حدثًا متتاليًا يُوقف الرابط تلقائيًا، وتعيد تشغيله من صفحة Webhooks بعد الإصلاح. السجل يعرض آخر 50 حدثًا وحالة كل منها.

الأمان

إذا ظننت أن مفتاح التوقيع تسرّب، اضغط مفتاح جديد، فيتوقف القديم فورًا. لا تُرسل Webhooks إلى عناوين yarbah.com أو العناوين الداخلية.

أسئلة شائعة عن هذه الصفحة

آخر تحديث: 19 نوفمبر 2026

هل أفادك هذا المقال؟