دليل عملي لاستقبال Webhooks وإعادة توجيهها ومعالجة الأعطال.

البدء

أنشئ حساباً من زر بدء التجربة المجانية، أكّد بريدك الإلكتروني، سجّل الدخول، ثم افتح لوحة العميل. تحتوي القائمة الجانبية على Overview للاستخدام والفوترة، وEndpoint health لصحة الوجهات، وSecurity للأسرار والنشاط، وDestinations للوجهات، وDeliveries لسجل الأحداث، وAlert settings للتنبيهات، وBilling للباقات والفواتير، وCustomization لبوابة العميل. [screenshot: القائمة الجانبية في اللوحة]

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

Endpoints وWebhooks

يظهر Endpoint في لوحة العميل كرابط Webhook. استخدم Copy لنسخه، أرسل طلب POST، ثم راقب ظهور الحدث في Deliveries. تصل الأحداث إلى الوجهات النشطة المطابقة. أوقف الوجهة مؤقتاً أو عطّلها عند الحاجة، واحذفها فقط إذا لم تعد تحتاج إعداداتها. [screenshot: رابط Endpoint وزر النسخ]

• يُقبل الإدخال قبل بدء محاولات التسليم.
• قد تُرفض الحالات المنتهية أو غير المسموحة قبل إنشاء الحدث.
• تصف الشارة الحالة الحالية ولا تضمن صحة الخدمة البعيدة.

الوجهات

افتح Destinations لإضافة URL، واختيار فلاتر الأحداث، وضبط المهلة وعدد المحاولات، ثم احفظ. استخدم Test this destination قبل اعتماد الوجهة. يمكنك تعديلها أو تعطيلها دون حذف سجلها. إذا كانت الخدمة البعيدة متوقفة، يسجل RawNak الاستجابة أو الخطأ ويعيد المحاولات المؤهلة ويعرضها في Deliveries. [screenshot: نموذج الوجهة]

• استخدم HTTPS للوجهات الإنتاجية.
• فشل الوجهة لا يحذف الحدث المستلم.
• أصلح الخدمة ثم استخدم Retry delivery لمحاولة مؤهلة أو Replay event لتشغيل جديد.

الأحداث وتدفق الحدث

تعرض Deliveries الأحداث ونتيجة إعادة توجيهها. استخدم الفلاتر حسب الحالة ورمز الاستجابة واسم الحدث والوجهة والتاريخ. افتح الحدث لرؤية Payload والاستجابة وتسلسل المحاولات. يعرض عمود Attempt بالشكل attempt_number / max_attempts مثل 1/3. يواصل Retry delivery محاولة قابلة للإعادة، بينما ينشئ Replay event تشغيل تسليم جديداً. [screenshot: جدول التسليم والمفتش]

API keys والأسرار

يستخدم RawNak سر توقيع Webhook للمصادقة على الطلبات وتوكن جلسة للوحة. يظهر السر الأولي عبر مسار كشف لمرة واحدة فقط؛ انسخه فوراً إلى مدير أسرار على الخادم. دوّر السر من Security عند احتمال انكشافه. السر الملغى أو المستبدل لا يصلح للتوقيعات الجديدة بعد التغيير. [screenshot: صفحة Security]

• لا ترسل الأسرار بالبريد ولا تحفظها في Git.
• إذا فقدت السر الأولي استخدم مسار التدوير المدعوم.
• يمكن إبطال جلسات اللوحة من خلال تسجيل الخروج من كل الجلسات.

الإعلانات والتنبيهات

تظهر الإعلانات في شريط أعلى لوحة العميل وعلى جميع التبويبات. اقرأ الرسالة باللغة المختارة وأغلقها من زر الإغلاق. تختفي الإعلانات المعطلة بعد التحديث التالي. تضبط Alert settings تنبيهات التسليم والفوترة عندما تكون الميزة متاحة في الباقة. [screenshot: شريط الإعلان]

الحساب والأمان

غيّر كلمة المرور من صفحة أمان الحساب باستخدام كلمة المرور الحالية وكلمة جديدة قوية. فعّل المصادقة الثنائية من مسار أمان الأدمن عندما تكون مخولاً. احفظ رموز الاسترداد في مكان غير متصل؛ تظهر مرة واحدة ويمكن إعادة توليدها بعد التحقق. عند فقدان الجهاز استخدم رمزاً محفوظاً أو تواصل مع الدعم بعد إثبات ملكية الحساب. استخدم تسجيل الخروج من كل الجلسات عند الاشتباه باختراق. [screenshot: إعدادات الأمان]

• استخدم كلمة فريدة لا تقل عن 14 حرفاً لحساب الأدمن.
• لا تشارك رموز الاسترداد مع الدعم أو الزملاء.
• تغيير كلمة المرور يبطل الجلسات وفق سياسة أمان الحساب.

الباقات والفوترة

الباقات الحالية هي Free trial بقيمة $0 لمدة 7 أيام، وStarter بسعر $19 شهرياً، وGrowth بسعر $49، وEnterprise بسعر $99. تعرض Billing الباقة والحالة وموعد التجديد أو نهاية التجربة والفواتير وإجراءات الترقية والإلغاء. لا يفتح Checkout إلا للحساب المؤهل. عند انتهاء الباقة قد تصبح بعض المسارات بحاجة إلى فوترة، بينما تبقى السجلات خاضعة لسياسة الاحتفاظ. [screenshot: صفحة Billing]

• التجربة: وجهة واحدة و1,000 حدث شهرياً.
• Starter: 3 وجهات و10,000 حدث شهرياً.
• Growth: 10 وجهات و100,000 حدث شهرياً مع ميزات Growth.
• Enterprise: 50 وجهة و1,000,000 حدث شهرياً مع ميزات Enterprise.
• الاحتفاظ الافتراضي 90 يوماً ضمن سياسة مساحة العمل؛ راجع القيمة المعروضة في Settings.

الحدود والحصص

تعرض Overview استخدام الأحداث والوجهات مقارنة بحدود الباقة. عند بلوغ الحصة يعيد النظام خطأ واضحاً بدلاً من إسقاط البيانات بصمت. خفّض الحركة أو احذف وجهات غير مستخدمة أو انتظر فترة الاستخدام التالية أو قم بالترقية. [screenshot: بطاقات الاستخدام]

التواصل مع الدعم

أرسل إلى [email protected]. أرفق معرّف مساحة العمل، الوقت التقريبي UTC، Endpoint أو الوجهة، رمز HTTP، وevent ID إن وجد، ورسالة خطأ منقحة. لا ترسل كلمات المرور أو الأسرار أو رموز الاسترداد أو بيانات البطاقة. [screenshot: بيانات التواصل]

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

أسئلة العملاء وإجاباتها.

• كم تستمر التجربة؟ — سبعة أيام من التسجيل.
• هل أستخدم Endpoint نفسه لكل الشركات؟ — لا، استخدم الرابط الخاص بالشركة.
• أين أنسخ رابط Webhook؟ — في Overview بجانب Copy.
• لماذا لا يظهر الحدث؟ — راجع الرابط والحالة والفلاتر.
• لماذا فشل التسليم؟ — افتح تفاصيل الحدث وشاهد رمز الاستجابة والخطأ.
• ماذا يعني 1/3؟ — المحاولة الحالية من أصل الحد الأقصى.
• ما هو Retry delivery؟ — إعادة محاولة تسليم مؤهل.
• ما هو Replay event؟ — تشغيل تسليم جديد للحدث.
• هل يحذف الفشل الحدث؟ — لا، يبقى السجل.
• كيف أختبر الوجهة؟ — استخدم Test this destination.
• هل أستطيع إيقاف وجهة؟ — نعم، عطّلها دون حذف السجل.
• لماذا أرى 429؟ — تم بلوغ حد السرعة أو التزامن.
• لماذا أرى 402؟ — تحتاج دورة الحياة أو الفوترة إلى إجراء مسموح.
• أين الإعلانات؟ — أعلى لوحة العميل.
• هل يمكن إغلاق الإعلان؟ — نعم من زر الإغلاق.
• أين الفواتير؟ — في Billing أو رابط البوابة.
• ماذا يحدث بعد الإلغاء؟ — تتبع الصلاحية دورة الاشتراك وتبقى البيانات ضمن الاحتفاظ.
• هل أستطيع تدوير السر؟ — نعم من Security.
• ماذا أفعل عند فقدان رموز الاسترداد؟ — استخدم مسار التوليد المصرح أو تواصل مع الدعم.
• ما الذي أرسله للدعم؟ — مساحة العمل والوقت وevent ID وتشخيصاً منقحاً دون أسرار.