انتقل للمحتوى
Rasel Mailمركز المساعدة
الأقسام والأدلة
للمطورين

رحلة عملية: تأكيد طلبات متجرك عبر البريد

جهّز مشروعًا وأرسل حدث طلب واحد، ثم اختبر التتبع وإعادة المحاولة.

آخر تحديث تحريري: ٣٠ أكتوبر ٢٠٢٦
في هذا الدليل

قبل الربط

  • اشتراك مدفوع ودومين خاص جاهز للإرسال، لا مجرد إثبات ملكية.
  • حصة إرسال مؤكدة للحساب؛ طلب الدفع وحده لا يفعّلها.
  • خادم تطبيق يحفظ المفتاح وهوية أحداث الطلبات.

١. أنشئ مشروع المتجر

  1. افتح التطبيقات ← إرسال رسائل المواقع. راجع الحصة وتاريخ انتهائها.
  2. اكتب اسم المتجر واختار دومين المرسل، ثم أنشئ مفتاح المشروع.
  3. انسخ المفتاح مرة واحدة إلى أسرار خادمك. لا تضعه في قالب HTML أو JavaScript المتصفح.
إنشاء مشروع إرسال لمتجر ببيانات اختبار.
واجهة عربية توضيحية؛ الحصة والقيم للاختبار، ولا يظهر مفتاح حقيقي. فتح الصورة
  1. راجع دومين المرسل للمشروع.
  2. اسم واضح يميز المتجر.
  3. أنشئ المفتاح واحفظه على الخادم.

٢. اربط الإرسال بحدث عمل واحد

عند تأكيد الطلب رقم 123، احتفظ بمفتاح مثل order-123-confirmation في قاعدة بيانات تطبيقك. نفس الحدث يحتفظ بنفس المفتاح والمحتوى عند إعادة المحاولة. رسالة شحن لاحقة حدث مختلف وتحتاج مفتاحًا آخر. لا تستخدم مفتاحًا عشوائيًا جديدًا عند كل استدعاء.

رسالة اختبار؛ استبدل العناوين
{"from":"orders@example.com","to":["customer@example.net"],"subject":"Order 123 confirmed","text":"We received order 123."}

٣. اختبر ما بعد الإرسال

  1. استخدم المشروع القابل للتنزيل أولًا مع مستلم اختبار تملكه.
  2. احفظ معرف الرسالة وتابع حالتها. queued انتظار، وaccepted قبول مزود وليست تأكيد الوارد.
  3. كرر نفس الحدث بنفس المحتوى والمفتاح لتتأكد من رجوع نفس المعرّف دون حجز آخر.
  4. اختبر عندك التعامل مع نقص الحصة و429 والنتيجة unknown قبل الربط مع طلبات عملائك.

لو الرسالة للتحقق أو استعادة كلمة المرور