List Customer Emails
اقرأ رسائل البريد الإلكتروني المرسلة إلى العميل ونتيجة تسليمها.
Get Email Content
اقرأ رسالة بريد إلكتروني واحدة تمامًا كما أُرسلت.
نظرة عامة
ترسل Dodo Payments رسائل البريد الإلكتروني الخاصة بالمعاملات إلى عملائك نيابةً عنك: الإيصالات، وإشعارات استرداد الأموال، وإشعارات الاشتراكات، ورسائل المطالبة بالدفع والاسترداد، ومنح الاستحقاقات، وروابط تسجيل الدخول إلى Customer Portal. تسجّل علامة التبويب Sent Emails كل رسالة على سجل العميل. ولكل رسالة، يمكنك معرفة ما أُرسل، وإلى أي مرحلة وصل، وسبب عدم وصولها عند فشلها. يمكنك فتح الرسالة التي تلقّاها عميلك، كما يمكنك إرسالها مرة أخرى.
يتم الاحتفاظ برسائل البريد الإلكتروني لمدة 180 يومًا. تأتي حالة التسليم من مزوّد البريد الإلكتروني، وعادةً ما يتم تحديثها خلال ثوانٍ من كل حدث تسليم.
عرض رسائل البريد الإلكتروني الخاصة بالعميل
1
Open the Customer
انتقل إلى Sales → Customers في لوحة التحكم وحدّد العميل.
2
Open the Sent Emails Tab
تسرد علامة التبويب كل رسالة بريد إلكتروني أُرسلت إلى هذا العميل خلال آخر 180 يومًا، بدءًا من الأحدث.
3
Read a Row
يعرض كل صف الموضوع، وأسفله عنوان المرسل والمستلم. وتعرض الأعمدة الأخرى Category وDate & Time وDelivery Status وActions التي يمكنك تنفيذها.
Delivery Status
لكل رسالة بريد إلكتروني إحدى خمس حالات. تُرجع API قيمة الحالة، بينما تعرض لوحة التحكم تصنيفها:Failure Reasons
عندما لا تصل رسالة بريد إلكتروني، يوضّح الصف سبب ذلك حتى تعرف الإجراء المطلوب. أشر إلى الحالة في الصف لقراءة السبب. تُرجع API السبب نفسه فيfailure_reason ورمزًا ثابتًا في failure_code:
تتطلب خمسة من هذه الأسباب استخدام عنوان مختلف عند إعادة الإرسال، لأن العنوان نفسه سيفشل مرة أخرى: صندوق البريد غير موجود، والعنوان مرفوض، والعنوان محجوب بعد حالات فشل سابقة، والرسالة مرفوضة بسبب كبر حجمها، وتصنيف المستلم للرسالة على أنها محتوى غير مرغوب فيه.
Reading an Email
لقراءة رسالة بريد إلكتروني، حدّد Resend في صفها، أو Retry في صف فاشل. تعرض اللوحة التي تفتح نسخة الرسالة المحفوظة ضمن Email Preview، تمامًا كما أُرسلت. وتحمل رسائل الاسترداد والتحصيل التي كتبتها تسمية Written by you.
- رسائل تسجيل الدخول إلى Customer Portal. تتضمن رابط تسجيل دخول صالحًا للاستخدام، لذلك لا يتم عرض المحتوى مطلقًا.
- الرسائل المحظورة. لم تصل مطلقًا إلى المزوّد، لذلك لا توجد نسخة منها.
- الرسائل التي تعذّر تسليمها إلى المزوّد. لم يتم حفظ أي نسخة منها.
- الرسائل الأقدم من 180 يومًا. يمسح المزوّد المحتوى بعد هذه المدة.
Sending an Email Again
لإرسال رسالة بريد إلكتروني مرة أخرى، حدّد Resend في صفها، أو Retry في صف فاشل، ثم أكّد في اللوحة. يوضّح الزر عدد مرات إعادة الإرسال المتبقية للرسالة. يعيد Dodo Payments إنشاء الرسالة من الحدث الأصلي، وليس من النسخة المحفوظة، لذلك يعرض الإيصال الحالة الحالية للدفع. وتحتفظ الرسالة بتاريخ الحدث الأصلي.
Limits
تنطبق هذه الحدود على كل عملية إعادة إرسال:- يمكن إرسال كل رسالة مرة أخرى ثلاث مرات.
- تنتظر عمليات إعادة إرسال الرسالة نفسها إلى العنوان نفسه بين كل محاولة وأخرى: خمس دقائق بعد آخر إرسال وقبل إعادة الإرسال الأولى، وعشر دقائق قبل الثانية، وخمس عشرة دقيقة قبل الثالثة.
- تنتظر إعادة الإرسال إلى أي عنوان حتى مرور خمس دقائق منذ آخر مرة تلقّى فيها ذلك العنوان رسالة منك.
- لا يُحتسب الإرسال الذي لم يصل مطلقًا إلى المزوّد ضمن المرات الثلاث، لكنه يضيف إلى مدة الانتظار.
- يتوفر Resend في لوحة التحكم فقط. أما API فهي للقراءة فقط.
When Resend Is Not Available
لا يوفّر لوحة التحكم إعادة الإرسال، أو ترفضها، في الحالات التالية:تُرسل رسالة تسجيل الدخول إلى Customer Portal دائمًا إلى العنوان الذي طلبها، وتُنشئ كل عملية إعادة إرسال رابط تسجيل دخول جديدًا.
Test Mode
يرسل وضع الاختبار رسائل بريد إلكتروني فعلية، ولذلك يخضع لحد مسموح به: 100 رسالة بريد إلكتروني لكل نشاط تجاري في الأسبوع. وتُخصم عمليات إعادة الإرسال من الحد نفسه. تُرسل كل رسالة بريد إلكتروني في وضع الاختبار إلى المستلم الحقيقي، مع وجود[TEST MODE] في بداية الموضوع.
لإيقاف رسائل البريد الإلكتروني للعملاء في وضع الاختبار، عطّل Test Mode Emails من Settings → Communication → Email (راجع Test Mode Emails). أثناء تعطيله، لا تُرسل أي رسالة بريد إلكتروني إلى العملاء في وضع الاختبار، ولا يُضاف أي صف إلى علامة التبويب، ولا يُستهلك أي جزء من الحد المسموح، وترفض لوحة المعلومات إعادة الإرسال. لا تتأثر رسائل البريد الإلكتروني في الوضع المباشر.
عند استهلاك الحد المسموح، لن يُرسل أي شيء آخر في وضع الاختبار خلال ذلك الأسبوع. يُسجَّل أول بريد إلكتروني يُرفض في ذلك الأسبوع كصف واحد من blocked، ويظهر فيه النص “لم يُرسل: تم استهلاك الحد المسموح لرسائل البريد الإلكتروني في وضع الاختبار لهذا الأسبوع”. لا تضيف حالات الرفض اللاحقة في الأسبوع نفسه أي صفوف. يُعاد تعيين الحد المسموح في بداية كل أسبوع، يوم الاثنين. لا يفرض الوضع المباشر حدًا مماثلًا.
لا تُرسل رسائل تسجيل الدخول إلى Customer Portal مطلقًا في وضع الاختبار، ولا تُخصم من الحد المسموح.
قراءة رسائل البريد الإلكتروني من خلال API
تتوفر القائمة والمحتوى أيضًا باستخدام مفتاح API الخاص بك، بحيث يمكنك عرض حالة التسليم في أدوات الدعم الخاصة بك. تُرجع القائمة 10 رسائل بريد إلكتروني لكل صفحة افتراضيًا. عيّنpage_size لإرجاع ما يصل إلى 100، واستخدم page_number للتنقل بين الصفحات، بدءًا من 0.
client.customers.emails.list() وclient.customers.emails.retrieveBody() (وretrieve_body() في Python).
يحمل كل عنصر email_log_id الخاص به، والذي تمرّره إلى نقطة نهاية المحتوى، بالإضافة إلى status الخاص به. كما يحمل failure_code وfailure_reason عند فشل الإرسال، وhas_preview لتحديد ما إذا كان المحتوى المخزّن موجودًا. تُرجع نقطة نهاية المحتوى 422 عندما لا يحتوي البريد الإلكتروني على محتوى لعرضه. ويحمل كل عنصر أيضًا كائن policies يوضّح ما يمكنك فعله بالصف:
اقرأ
policies بدلًا من اشتقاق الأهلية بنفسك. يطبّق الخادم القواعد المذكورة أعلاه.
Customer Management
إدارة العملاء وسجل المشتريات وإمكانية الوصول للخدمة الذاتية.
Communication Preferences
اختيار رسائل البريد الإلكتروني التي يرسلها Dodo Payments نيابةً عنك.