للمطورين · Webhooks

Webhooks هيو ميل

استقبل أحداثاً موقّعة على نقطة نهاية HTTPS لديك حين تُسلَّم الرسائل أو تُفتح أو ترتد، وحين تتغير جهات الاتصال، وحين تصل طلبات المتجر.

  • تواقيع HMAC-SHA256
  • حتى 5 محاولات تسليم
  • تدوير السر خلال 24 ساعة
تطبيق يرسل إشعار حدث عبر Webhook إلى خادمك.

نظرة سريعة

ما هي؟

طلبات HTTP POST يرسلها هيو ميل إلى نقطة النهاية لديك حين يحدث شيء، فلا تحتاج أنظمتك إلى السؤال مرة بعد مرة.

لمن هي؟

للمطورين الذين يبقون نظام العملاء أو مستودع البيانات أو تطبيقهم متزامناً مع نتائج البريد وجهات الاتصال وطلبات المتجر.

كم تكلّف؟

الـWebhooks مشمولة في كل الخطط مع واجهة البريد البرمجية.

الأحداث التي تستقبلها

التسليم

الإرسال والتسليم والارتداد والشكوى والفشل، للرسائل التشغيلية ورسائل الحملات.

التفاعل

الفتح والنقر وإلغاء الاشتراك لمستلمي الحملات، وحدث مستقل لكل نقرة.

نتائج الحملة

حدث عند انتهاء الحملة مع أعداد المقبول والفاشل والمحجوب والمتخطى.

جهات الاتصال

حين تُنشأ جهة اتصال أو تتغير عبر الواجهة البرمجية أو ربط متجر.

التحويلات

حين يُسجَّل طلب أو تحويل أو يُعدَّل.

طلبات المتجر

كل حدث طلب، والطلب الجديد، والطلب المدفوع، من متجر مربوط.

أنشئ Webhook

أضف نقطة نهاية

افتح البريد › الأتمتة › Webhooks، واختر «ويب هوك جديد»، وأدخل عنوان HTTPS لديك.

اختر الأحداث

حدّد الأحداث التي تحتاجها فقط، فلا تتلقى نقطة النهاية إلا ما اشتركت فيه.

احفظ السر

يُعرض سر الويب هوك مرة واحدة بعد الحفظ، فاحفظه في مدير الأسرار لديك.

تحقق وأجب

افحص الترويسة HyoNova-Signature، وأجب بـ2xx خلال 10 ثوانٍ، وأنجز العمل الثقيل بعد الرد.

موثوقة في تصميمها

طلبات موقّعة

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

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

حتى 5 محاولات إجمالاً، بعد نحو دقيقة ثم 5 دقائق ثم 15 دقيقة ثم ساعة.

تدوير آمن

خلال 24 ساعة بعد «تدوير السر» تحمل التسليمات توقيعين: بالسر الجديد والقديم.

أسئلة وأجوبة

كيف أتحقق من الطلب؟

احسب HMAC-SHA256 لقيمة t ثم نقطة ثم الجسم الخام بسرّك، وقارنه بقيمة v1 في HyoNova-Signature. وأثناء التدوير اقبل أياً من قيمتي v1.

ما الذي يُعد تسليماً فاشلاً؟

أي حالة غير 2xx، أو عدم الرد خلال 10 ثوانٍ، أو خطأ في الشبكة.

هل أرى التسليمات السابقة؟

نعم. تعرض قائمة التسليمات كل واحد بحدثه وحالته ومحاولاته وحالة HTTP التي ردت بها نقطة النهاية.

هل أحتاج واجهة البريد البرمجية لاستخدام الـWebhooks؟

لا. الـWebhooks تبلغ أيضاً عن مستلمي الحملات وجهات الاتصال وطلبات المتجر، سواء أرسلت عبر الواجهة أم لا.

اربط هيو ميل بأنظمتك

ابدأ مجاناً وأضف أول Webhook من البريد › الأتمتة.