دليل جديد: كيف تُسخّن عنوان IP مخصصًا دون الإضرار بسمعتك. اقرأ الآن →
MigoSMTP
Webhooks والأحداث

اعرف لحظة حدوث أي شيء

استقبل أحداثًا موقّعة لكل عملية تسليم وارتداد وفتح ونقر وشكوى، وأعد تشغيل ما فاتك.

يلخّص الذكاء الاصطناعي تدفقات الأحداث وينبّه إلى أنماط الارتداد غير المعتادة فور ظهورها.

إضافة نقطة نهاية
URL
https://example.com/hook
السر
••••••••••
حفظ
أُضيفت نقطة النهاية
HTTPS فقط
تم التحقق
أضف نقطة نهاية HTTPSزوّدنا بعنوان URL يستطيع استقبال طلبات POST. نتأكد من استجابته قبل إرسال أي حدث فعلي.
الأحداث المشترك بها
deliveredقُبلت الرسالة
bouncedدائم ومؤقت
complainedبلاغات البريد المزعج
clickedنشاط الروابط
لكل حدث
لكل تدفق
اختر الأحداث التي تريدهااشترك فيما تتصرف بناءً عليه فقط: delivered وbounced وcomplained وopened وclicked.
أحداث التسليم
أحداث موقّعة
/hooks/mail
200 OK
التحليلات
200 OK
مزامنة CRM
200 OK
في الوقت الفعلي
نقاط نهاية متعددة
تتوزع الأحداث في الوقت الفعلييُرسَل كل حدث إلى كل نقطة نهاية مشتركة به، فتبقى التحليلات وCRM والتنبيهات متزامنة.
الحمولة
{ "event": "delivered" }
رأس التوقيع
sha256=9f2c41…
السر المشترك
مختوم بالوقت
مقارنة بزمن ثابت
ارفض كل ما يفشل في التحقق
HMAC-SHA256
آمن ضد إعادة التشغيل
تحقق من كل طلبيحمل كل طلب توقيع HMAC مبنيًا بسرّك، فتستطيع إثبات أنه صدر عنا.
سلامة نقطة النهاية · /hooks/mail
AI
قبل ساعة
الآن
الأخطاء في ازديادمعظم الإخفاقات من نوع 502 بعد آخر نشر لديك.
المقترح: ضع الأحداث في طابور، ثم أعد تشغيلها بعد تعافي /hooks/mail
يجمّع الإخفاقات
إيقاف مؤقت أو إعادة تشغيل
يكتشف الذكاء الاصطناعي تعطل نقطة النهاية مبكرًابدلًا من الانتظار حتى تنفد إعادات المحاولة، يلاحظ الذكاء الاصطناعي ارتفاع معدل الأخطاء في نقطة نهايتك ويجمّع الإخفاقات حسب السبب. ويقترح حلًا ويستطيع إيقاف الحدث المسبب للضجيج مؤقتًا.
معالج webhook
Node
Python
PHP
Go
PHP
app.post("/hook", (req, res) => {
verify(req, SECRET)
res.sendStatus(200)
})
200 OK
أكّد الاستلام سريعًا
متكرر الأمان
معالج في بضعة أسطرتحقق من التوقيع، وأكّد الاستلام سريعًا، وعالج لاحقًا. هذا كل ما يحتاج إليه مستهلك موثوق.
نقطة النهاية
الأحداث
التوزيع
التوقيع
فرز بالذكاء الاصطناعي
المعالج
ترحيل SMTPREST APIWebhooksعناوين IP مخصصةتوقيع DKIMتحليل البريد الواردالقوالبالتحليلاتقوائم الحظرمراقبة السمعةالتحقق من البريد الإلكترونيأدوار الفريق وسجل التدقيقترحيل SMTPREST APIWebhooksعناوين IP مخصصةتوقيع DKIMتحليل البريد الواردالقوالبالتحليلاتقوائم الحظرمراقبة السمعةالتحقق من البريد الإلكترونيأدوار الفريق وسجل التدقيق
الإمكانات

تسليم موثوق للأحداث

كل نتيجة

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

حمولات موقّعة

تحقق من أن كل طلب صدر عن MigoSMTP.

إعادة محاولة مع تأخير تصاعدي

تُعاد محاولة عمليات التسليم الفاشلة تلقائيًا.

إعادة التشغيل

أعد إرسال الأحداث من السجل بعد انقطاع.

عوامل تصفية الأحداث

اشترك في الأحداث التي تحتاج إليها فقط.

سجلات التسليم

اطّلع على الطلب والاستجابة والحالة لكل محاولة.

كيف يعمل

يقع الحدثتُسلَّم رسالة، أو تُؤجَّل، أو ترتد، أو تُفتح، أو يُنقر عليها، أو يُبلَّغ عنها كبريد مزعج.
يوقّع MigoSMTP ويرسليُغلَّف الحدث في حمولة JSON موقّعة ويُرسَل إلى نقطة نهاية HTTPS لديك.
تتحقق نقطة نهايتكيفحص معالجك التوقيع، ثم يؤكد الاستلام باستجابة 2xx.
إعادة المحاولة وإعادة التشغيلتُعاد محاولة عمليات التسليم الفاشلة، ويمكنك إعادة تشغيل الأحداث من السجل بعد انقطاع.
الخطوة 1

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

أدخل عنوان HTTPS الخاص بك واختر الأحداث.

الخطوة 2

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

افحص رأس التوقيع في كل طلب.

الخطوة 3

عالج وأكّد الاستلام

أعد استجابة 2xx لتأكيد الاستلام.

شاهده قيد العمل

منصة واحدة من أول إرسال إلى الوارد

تنقّل بين المراحل لترى ما تتحكم به في كل خطوة. واجهة توضيحية. جميع الأرقام والعناوين المعروضة بيانات نموذجية.

app.migosmtp.com / sendبيانات نموذجية
في الطابور
184,320
المرسل اليوم
6,418,905
المعدل
412/s
مقبولةرسالة إلى you@example.com
مقبولةرسالة إلى team@example.com
في الطابوردفعة من 25,000 مستلم
مقبولةرسالة إلى ops@example.com
العمليات

أبقِ أنظمتك متزامنة مع بريدك

حدّث قاعدة بياناتك، وشغّل سير العمل، ونبّه فريقك دون استطلاع دوري.

  • اختيار الأحداث لكل نقطة نهاية
  • إعادة محاولة تلقائية وإعادة تشغيل يدوية
  • سجلات كاملة للطلبات والاستجابات
  • أسرار يمكنك تدويرها
نظرة سريعة
النقلHTTPS POST
الصيغةJSON
الأمانرأس التوقيع
إعادة المحاولةتلقائية، مع تأخير تصاعدي
نظرة عامة

ما هي webhooks والأحداث؟

webhooks البريد هي استدعاءات HTTP تُعلم تطبيقك عندما يحدث شيء لرسالة أرسلتها. يرسل MigoSMTP حمولة JSON موقّعة إلى نقطة نهاية HTTPS لديك عن أحداث مثل التسليم والتأجيل والارتداد والفتح والنقر والشكوى وإلغاء الاشتراك. يتفاعل نظامك فورًا بدلًا من سؤال الـ API مرارًا عن الحالة. تحمل الحمولات معرّف الرسالة والمستلم ونوع الحدث والوقت، وفي حالات الإخفاق السبب الذي أعاده الخادم المستلم. وتتيح هذه الحقول مطابقة الأحداث بسجلاتك دون عمليات بحث إضافية أو تخمين.

تسجّل نقطة نهاية، وتختار الأحداث التي ينبغي أن تستقبلها، وتتحقق من رأس التوقيع في كل طلب. أعد استجابة 2xx لتأكيد الاستلام. وإذا فشلت نقطة نهايتك، تُعاد محاولة التسليم مع تأخير تصاعدي، ويمكنك إعادة تشغيل الأحداث من السجل بعد انقطاع. تُحفظ تفاصيل الطلب والاستجابة لكل محاولة لتصحّح الأخطاء بسرعة. يمكن تدوير الأسرار، وتُبقي عوامل تصفية الأحداث كل نقطة نهاية مركّزة. وتعرض المحاولات الفاشلة الطلب والاستجابة والوقت، مما يجعل تصحيح أخطاء المعالج سريعًا ومستندًا إلى الأدلة.

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

حالات الاستخدام

حالات استخدام شائعة لـ webhooks والأحداث

إبقاء قاعدة بياناتك متزامنة

علّم الطلبات بأنها أُخطرت عند التسليم، وعلّم جهات الاتصال عند وصول ارتداد دائم. تلغي webhooks الحاجة إلى مهام الاستطلاع وتُبقي حالة التطبيق دقيقة.

معالجة الحظر تلقائيًا

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

تنبيه فرق الدعم

أرسل تنبيهًا إلى Slack أو تذكرة عندما ترتد رسالة إعادة تعيين كلمة المرور. يستطيع الدعم حينها التواصل مع العميل بقناة أخرى قبل أن يستسلم. يوفر ذلك ساعات من العمل اليدوي.

التعافي بعد التوقف

إذا كانت نقطة نهايتك متوقفة أثناء عملية نشر، فأعد تشغيل الأحداث الفائتة من السجل وأعد سجلاتك إلى الحالة الصحيحة. لا يضيع شيء في الأثناء.

تحديث حالة الطلبات والتذاكر

علّم الطلب بأنه أُخطر أو التذكرة بأنها أُجيبت فور وصول حدث التسليم.

تغذية مستودع بياناتك

مرّر الأحداث إلى تحليلاتك الخاصة لتجاور نتائج البريد بيانات المنتج والإيرادات.

اختيار الطريقة

webhooks أم استطلاع الـ API؟

كلاهما يمنحك بيانات الأحداث. ويناسب كل منهما حالات مختلفة.

Webhooksاستطلاع الـ API
كيف يعملنحن ندفع الأحداث إلى نقطة نهايتكشيفرتك تسأل وفق جدول
السرعةشبه فوريةتعتمد على فترة الاستطلاع لديك
الحملفقط عند حدوث شيءطلبات متواصلة، فارغة في معظمها
الموثوقيةإعادة المحاولة وإعادة التشغيل تغطيان الانقطاعاتعليك تتبع ما قرأته
الأنسب لـالحالة المباشرة والأتمتةاستكمال البيانات الفائتة والتقارير المجدولة

تستخدم فرق كثيرة webhooks للتحديثات المباشرة والـ API لاستكمال ما فاتها.

ميزات الذكاء الاصطناعي

webhooks والأحداث بمساعدة الذكاء الاصطناعي

المساعد

ملخصات تدفق الأحداث

يختصر المساعد الذكي آلاف الأحداث في موجز قصير، مثل أي مزود يؤجّل وأي حملة تتسبب في الشكاوى، مع روابط إلى الرسائل التي تقف وراء كل نقطة.

تنبؤي

اكتشاف الشذوذ في الأحداث

تتعلم النماذج معدلات الارتداد والشكاوى والتأجيل المعتادة وتنبّهك عندما يخرج تدفق عنها. وأنت تحدد من يتلقى الإشعار وهل تعمل أي أتمتة.

مساعدة

مساعد تصحيح أخطاء الحمولة

الصق سجل تسليم فاشلًا فيشرح المساعد السبب المرجح، مثل عدم تطابق التوقيع أو انتهاء المهلة، ويقترح حلًا لتجربته. وأنت من يجري التغيير.

جاهز للوكلاء

وصول إلى الأحداث جاهز للوكلاء

عبر خادم MCP، يستطيع وكلاء الذكاء الاصطناعي قراءة سجل الأحداث وسجلات التسليم بصلاحيات للقراءة فقط. وتتطلب إجراءات الكتابة صلاحيات صريحة، وموافقة بشرية إن شئت.

ميزات الذكاء الاصطناعي مساعدة: تلخّص وتنبّه، وأي إجراء آلي يضبطه فريقك ويوافق عليه.

أفضل الممارسات

أفضل ممارسات webhooks والأحداث

تحقق من التوقيع في كل مرة

ارفض الطلبات التي لا يطابق رأس التوقيع فيها. دوّر السر دوريًا، وفورًا إذا احتُمل انكشافه.

استجب بسرعة وعالج بشكل غير متزامن

أكّد الاستلام باستجابة 2xx فور تخزين الحمولة بأمان، ثم عالجها من طابور. تتسبب المعالجات البطيئة في انتهاء المهلة وإعادة محاولات مكررة.

صمّم للتكرار واختلال الترتيب

قد تتكرر عمليات التسليم وتصل بترتيب مختلف. استخدم معرّف الرسالة والوقت لإزالة التكرار وتجاهل تغييرات الحالة القديمة.

اشترك فيما تستخدمه فقط

صفّ الأحداث لكل نقطة نهاية. الطلبات غير ذات الصلة الأقل تعني حملًا أخف على خوادمك ومراقبة أبسط. أبقِ عمليات الدمج رشيقة وسهلة التصحيح.

راقب نقطة نهايتك

نبّه عند تكرار الإخفاقات في سجل التسليم. الانقطاع الصامت يعني انحرافًا صامتًا في البيانات إلى أن يعيد أحد تشغيل الفجوة.

أكّد الاستلام بسرعة وعالج لاحقًا

أعد استجابة 2xx بسرعة وانقل العمل الثقيل إلى طابور، حتى لا تؤدي المعالجات البطيئة إلى إعادة المحاولة.

الأسئلة الشائعة

webhooks والأحداث: الأسئلة الشائعة

تحتاج إلى مساعدة في ربط نقطة نهاية؟ يستطيع فريقنا مراجعتها معك قبل الإطلاق.

ما هي webhook البريد؟

webhook البريد طلب HTTP يرسله مزود بريدك إلى خادمك عند وقوع حدث، مثل تسليم رسالة أو ارتدادها. يتيح لتطبيقك التفاعل في الوقت الفعلي دون فحص الـ API مرارًا. وهذا يحل محل مهام الاستطلاع ويُبقي سجلاتك محدّثة.

كيف أتحقق من توقيع webhook؟

يتضمن كل طلب رأس توقيع مولّدًا بسر نقطة نهايتك. أعد حساب التوقيع من جسم الطلب الخام لديك وقارنه. ارفض الطلب إن اختلفا. تتضمن الوثائق نماذج شيفرة.

ما الأحداث التي يمكنني استقبالها؟

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

ماذا يحدث إذا تعطلت نقطة نهايتي؟

تُعاد محاولة عمليات التسليم الفاشلة مع تأخير تصاعدي، ويمكنك إعادة تشغيل الأحداث من السجل بعد التعافي. تُسجَّل كل محاولة مع الطلب والاستجابة لتعرف ما الذي فشل. تأكد من أن معالجك يستجيب بسرعة ويسجّل الإخفاقات.

هل تُسلَّم أحداث webhook بالترتيب؟

لا تعتمد على ترتيب صارم. ابنِ معالجات تتحمل الأحداث المكررة وغير المرتبة باستخدام معرّف الرسالة والوقت. قد يختلف ترتيب الأحداث بين المزودين وإعادات المحاولة، وقد تولّد رسالة واحدة عدة أحداث.

ما هي عمليات الفتح الآلية (bot opens)؟

تجلب بعض أنظمة البريد الصور تلقائيًا، فيُسجَّل ذلك كفتح حتى لو لم يقرأ أحد الرسالة. نفصلها عن عمليات الفتح البشرية حيثما استطعنا، لكن تتبع الفتح يبقى تقديريًا. تعامل مع الفتح كمؤشر تقريبي. واعتبر النقرات والردود إشارات أقوى على التفاعل.

كيف أختبر نقطة نهاية webhook؟

أرسل حدثًا تجريبيًا من لوحة التحكم إلى عنوان URL لديك وتأكد من أن معالجك يتحقق من التوقيع ويعيد استجابة 2xx. راجع سجل التسليم لترى الطلب واستجابتك. استخدم نقطة نهاية في بيئة الاختبار بسر تجريبي قبل الإنتاج. شغّل ذلك قبل توجيه الإنتاج إلى نقطة النهاية.

كيف يعمل الذكاء الاصطناعي مع webhooks والأحداث؟

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

كيف أختبر نقطة نهاية؟

أرسل حدثًا تجريبيًا من لوحة التحكم.

هل الترتيب مضمون؟

ابنِ معالجات تتحمل الأحداث المكررة وغير المرتبة، باستخدام معرّف الرسالة والوقت لإزالة التكرار.

ابدأ الإرسال خلال دقائق.

أنشئ حساباً، وأضف نطاقك، وأرسل أول رسالة بريد إلكتروني.