استكشاف أخطاء البريد الإلكتروني وإصلاحها
تسرد هذه الصفحة رموز الأخطاء التي يمكن أن يعيدها Pushwoosh عند إرسال بريد إلكتروني، مجمعة حسب سببها. يشرح كل إدخال معنى الخطأ وكيفية حله.
حدود الحساب والإرسال
Anchor link toتعني هذه الأخطاء أن حسابك أو مجموعة التكوين الخاصة بك قد وصلت إلى حد أقصى للإرسال أو إيقاف مؤقت أو تعليق — لا يوجد خطأ في الرسالة نفسها.
| الخطأ | الوصف | ما يجب فعله |
|---|---|---|
| AccountDailyQuotaExceeded | لقد وصل حسابك إلى حصته اليومية لإرسال البريد الإلكتروني. | انتظر حتى تتم إعادة تعيين الحصة، أو اتصل بـ دعم Pushwoosh لطلب حصة أعلى. |
| AccountSendingPaused / AccountSendingPausedException / ConfigurationSetSendingPaused / ConfigurationSetSendingPausedException | تم إيقاف إرسال البريد الإلكتروني مؤقتًا لحسابك أو مجموعة التكوين الخاصة بك، عادةً بسبب ارتفاع معدل الارتداد أو الشكاوى. | راجع معدلات الارتداد والشكاوى واتصل بـ دعم Pushwoosh لاستئناف الإرسال. |
| AccountSuspended | تم تعليق قدرة حسابك على إرسال رسائل البريد الإلكتروني. | اتصل بـ دعم Pushwoosh لمعرفة السبب وكيفية استعادة الإرسال. |
| AccountThrottled | تم إرسال عدد كبير جدًا من رسائل البريد الإلكتروني في فترة قصيرة، وتم تجاوز حد معدل الإرسال. | قلل من معدل الإرسال الخاص بك، أو اتصل بـ دعم Pushwoosh لطلب حد أعلى لمعدل الإرسال. |
تكوين المرسل والنطاق
Anchor link toتشير هذه الأخطاء إلى وجود مشكلة في كيفية إعداد نطاق الإرسال أو عنوان “من” والتحقق منه.
| الخطأ | الوصف | ما يجب فعله |
|---|---|---|
| CannotGetCredentials | لم يتمكن Pushwoosh من الحصول على بيانات الاعتماد اللازمة لإرسال البريد الإلكتروني. | تحقق من أن نطاق المرسل الخاص بك قد تم التحقق منه وهو نشط. |
| FromEmailAddressNotVerifiedException | لم يتم التحقق من عنوان المرسل ولا يمكن استخدامه لإرسال هذا البريد الإلكتروني. | تحقق من نطاق المرسل وعنوان بريده الإلكتروني وحاول مرة أخرى. |
| From email domain is not verified (1296) | لم يكمل نطاق “من” التحقق من DNS، لذا لا يمكن إنشاء الرسالة (بما في ذلك رسائل البريد الإلكتروني الاختبارية). | تحقق من حالة النطاق في نطاقات المرسل الخاصة بك وأضف أي سجلات لا تزال تحمل علامة معلق. |
| Reply email domain is not verified (1297) | لم يكمل نطاق الرد على التحقق من DNS، لذا لا يمكن إنشاء الرسالة (بما في ذلك رسائل البريد الإلكتروني الاختبارية). | تحقق من حالة النطاق في نطاقات المرسل الخاصة بك وأضف أي سجلات لا تزال تحمل علامة معلق. |
| FromEmailMissing | عنوان البريد الإلكتروني “من” مفقود أو غير صالح. | قم بتعيين عنوان بريد إلكتروني “من” صالح ومُتحقق منه في تكوين منصة البريد الإلكتروني أو في إعدادات الرسالة. |
| FromNameMissing | ”اسم المرسل” للبريد الإلكتروني مفقود أو غير صالح. | قم بتعيين “اسم مرسل” صالح في تكوين منصة البريد الإلكتروني أو في إعدادات الرسالة. |
| MailFromDomainNotVerified / MailFromDomainNotVerifiedException | تعذر إرسال الرسالة لأن Pushwoosh لم يتمكن من العثور على سجل MX المطلوب لنطاق الإرسال. | تحقق من سجلات DNS/DKIM لنطاق الإرسال الخاص بك وتأكد من نشرها بشكل صحيح. |
| InvalidTrackingOptionsException | نطاق التتبع المخصص الذي تم تكوينه لتتبع الفتح/النقر غير صالح. | تحقق من إعدادات نطاق التتبع المخصص. |
مشكلات عنوان المستلم
Anchor link toتحدث هذه الأخطاء بسبب عنوان البريد الإلكتروني للمستلم نفسه — تنسيقه، أو سجل ارتداده وشكاويه — وليس بسبب حسابك أو قالبك.
| الخطأ | الوصف | ما يجب فعله |
|---|---|---|
| AddressContainsControlOrWhitespace | يحتوي عنوان البريد الإلكتروني على أحرف تحكم أو مسافات بيضاء إضافية. | قم بإزالة أي أحرف مخفية أو مسافات بيضاء من عنوان البريد الإلكتروني وحاول مرة أخرى. |
| EmailComplaint | قام المستلم سابقًا بوضع علامة على رسالة منك كرسالة غير مرغوب فيها. | قم بإزالة هذا المستلم من عمليات الإرسال المستقبلية لحماية سمعة المرسل الخاصة بك. |
| EmailIsBounced | لم يتم إرسال الرسالة لأن عنوان البريد الإلكتروني هذا قد ارتد بالفعل. | استخدم عنوان بريد إلكتروني صالحًا ونشطًا، أو قم بإزالة هذا المستلم من قائمة بريدك. |
| IllegalEmailAddress | عنوان البريد الإلكتروني للمستلم له تنسيق غير صالح. | تحقق من عنوان البريد الإلكتروني للمستلم وصححه. |
| UnableToParseEmailBCC | يحتوي حقل نسخة مخفية الوجهة (BCC) على قيمة غير صالحة. | تحقق من تنسيق العناوين في حقل نسخة مخفية الوجهة (BCC). |
أخطاء تسليم SMTP
Anchor link toتحدث هذه الأخطاء أثناء تسليم Pushwoosh للرسالة عبر SMTP، من تكوين مفقود إلى اتصال فاشل.
| الخطأ | الوصف | ما يجب فعله |
|---|---|---|
| SMTPCannotProcessData | لم يتمكن Pushwoosh من بناء البريد الإلكتروني لتسليم SMTP. | تحقق من إعدادات قالب البريد الإلكتروني. |
| SMTPCannotProcessFrom | حقل SMTP “FROM” فارغ. | قم بتعيين عنوان بريد إلكتروني “من” صالح للرسالة. |
| SMTPCannotProcessRcpt | حقل SMTP “RCPT” (المستلم) فارغ. | تحقق من أن عنوان البريد الإلكتروني للمستلم قد تم تعيينه بشكل صحيح. |
| SMTPCannotProcessSending | حدث خطأ داخلي أثناء إرسال الرسالة عبر SMTP. | حاول إرسال الرسالة مرة أخرى لاحقًا. إذا استمر الخطأ، اتصل بـ دعم Pushwoosh. |
| SMTPIsNotConfigured | لم يتم إعداد SMTP لهذا الحساب. | اتصل بـ دعم Pushwoosh لتكوين إرسال SMTP. |
| SMTPProviderBlocked (1138) | أوقف Pushwoosh الإرسال إلى مزود البريد الإلكتروني لهذا المستلم من حسابك بعد عدد كبير جدًا من الارتدادات والأخطاء في فترة قصيرة. | انتظر حتى يستأنف الإرسال، أو اتصل بـ دعم Pushwoosh إذا استمر هذا. |
| SMTPUnableToCreateConnection | لم يتمكن Pushwoosh من إنشاء اتصال SMTP. | تحقق من إعدادات خادم SMTP وبيانات الاعتماد الخاصة بك، ثم حاول مرة أخرى. |
| SMTPUnableToSignDKIM | لم يتمكن Pushwoosh من توقيع الرسالة باستخدام DKIM. | تحقق من تكوين DKIM لنطاق الإرسال الخاص بك. |
| SMTPUnknownError | حدث خطأ SMTP غير محدد. | حاول إرسال الرسالة مرة أخرى. إذا استمر الخطأ، اتصل بـ دعم Pushwoosh. |
| SMTPUnknownProvider (1139) | لم يتمكن Pushwoosh من تحديد مزود البريد الإلكتروني لعنوان المستلم. | تحقق من أن عنوان البريد الإلكتروني للمستلم منسق بشكل صحيح، أو اتصل بـ دعم Pushwoosh إذا كان العنوان يبدو صحيحًا. |
أخطاء القالب والمحتوى
Anchor link toتحدث هذه الأخطاء أثناء قيام Pushwoosh ببناء أو عرض البريد الإلكتروني — قالب مفقود، أو بيانات عنصر نائب غير صالحة، أو HTML مشوه.
| الخطأ | الوصف | ما يجب فعله |
|---|---|---|
| CannotGetEmailPlaceholders | لم يتمكن Pushwoosh من جلب العناصر النائبة المستخدمة في قالب البريد الإلكتروني. | تحقق من العناصر النائبة لـ المحتوى الديناميكي في قالب البريد الإلكتروني. |
| CannotGetTemplateBindings | لم يتمكن Pushwoosh من جلب روابط البيانات المطلوبة لعرض القالب. | تحقق من إعدادات المحتوى الديناميكي و قوالب Liquid المستخدمة في القالب. |
| CannotNormalizeHTML | تعذر تحضير محتوى البريد الإلكتروني للإرسال. | تحقق من محتوى HTML لقالب البريد الإلكتروني بحثًا عن أخطاء. |
| CannotProcessEmailTemplateFromRepo | تعذر تحميل ومعالجة قالب البريد الإلكتروني. | تحقق من إعدادات قالب البريد الإلكتروني وحاول مرة أخرى. |
| EmailCannotGetEmailTemplateCode | فشل في الحصول على email_template_code أو أنه فارغ. | تحقق من أن المنصة مكونة بشكل صحيح وحاول مرة أخرى. |
| EmailCannotGetEmailTemplateFromRepo | فشل في الحصول على قالب البريد الإلكتروني بواسطة email_template_code. | تحقق من أن المنصة مكونة بشكل صحيح وحاول مرة أخرى. |
| InvalidRenderingParameterException | إحدى القيم المستخدمة لملء القالب غير صالحة، غالبًا بسبب JSON مشوه. | تحقق من بيانات المحتوى الديناميكي التي تم تمريرها إلى القالب. |
| InvalidTemplateException | تعذر عرض قالب البريد الإلكتروني المحدد. | تحقق من قالب البريد الإلكتروني بحثًا عن أخطاء وحاول مرة أخرى. |
| MissingRenderingAttributeException | لم يتم توفير قيمة مشار إليها بواسطة عنصر نائب في القالب. | تأكد من أن جميع العناصر النائبة المستخدمة في القالب لها قيم مطابقة. |
| TemplateDoesNotExistException | قالب البريد الإلكتروني المحدد غير موجود. | تحقق من أن قالب البريد الإلكتروني مكون بشكل صحيح ولم يتم حذفه. |
| TooDeepTemplateInsertion | القوالب متداخلة بعمق شديد داخل بعضها البعض. | قلل من عدد إدخالات القوالب المتداخلة في محتوى البريد الإلكتروني. |
| UnableToBuildEmailAttachments | تعذر بناء مرفق واحد أو أكثر. | تحقق من المرفقات المضافة إلى البريد الإلكتروني وحاول مرة أخرى. |
| UnableToBuildHTML | فشل في تجميع قالب البريد الإلكتروني. على الأرجح، يحتوي القالب على خطأ يتعلق بـ عناصر المحتوى الديناميكي النائبة أو قوالب Liquid. | تحقق من إعدادات قالب البريد الإلكتروني. |
| UnableToCreateHTML | لم يتمكن Pushwoosh من إنشاء HTML النهائي للبريد الإلكتروني. | تحقق من إعدادات قالب البريد الإلكتروني. |
| UnableToInsertTemplate | لم يتمكن Pushwoosh من إدراج قالب مشار إليه في البريد الإلكتروني. | تحقق من مرجع القالب المدرج/المتداخل في محتوى البريد الإلكتروني. |
| UnableToMinifyHTML | لم يتمكن Pushwoosh من تصغير محتوى HTML للبريد الإلكتروني. | تحقق من HTML قالب البريد الإلكتروني بحثًا عن ترميز مشوه. |
قوالب Liquid والمحتوى المتصل
Anchor link toهذه الأخطاء خاصة ببناء جملة Liquid وطلبات المحتوى المتصل المستخدمة لسحب البيانات المخصصة.
| الخطأ | الوصف | ما يجب فعله |
|---|---|---|
| ConnectedContentInvalidJSON | أعادت نقطة نهاية المحتوى المتصل JSON غير صالح. | تحقق من أن الواجهة الخلفية الخاصة بك تعيد JSON صالحًا لطلب المحتوى المتصل. |
| ConnectedContentInvalidParameters | عدد المعلمات التي تم تمريرها إلى المحتوى المتصل لا يتطابق مع القالب. | تحقق من المعلمات التي تم تمريرها في علامة المحتوى المتصل مقابل القالب الخاص بك. |
| ConnectedContentInvalidTemplate | تحتوي علامة المحتوى المتصل على قالب Liquid غير صالح. | تحقق من بناء جملة Liquid المستخدم داخل علامة المحتوى المتصل. |
| ConnectedContentInvalidURL | لم يتمكن Pushwoosh من جلب عنوان URL المحدد في المحتوى المتصل. | تحقق من أن عنوان URL للمحتوى المتصل صحيح ويمكن الوصول إليه. |
| ConnectedContentInvalidVarExpression | تعبير ${} المستخدم في المحتوى المتصل غير صالح. | تحقق من بناء جملة ${} المستخدم في علامة المحتوى المتصل. |
| InvalidLiquidTemplate | يحتوي البريد الإلكتروني على قالب Liquid غير صالح. | تحقق من بناء جملة قوالب Liquid المستخدم في البريد الإلكتروني. |
| LiquidTemplateInvalidParsing | تعذر تحليل قالب Liquid بسبب خطأ في بناء الجملة. | تحقق من بناء جملة قوالب Liquid المستخدم في البريد الإلكتروني. |
| LiquidTemplateInvalidRendering | تعذر عرض قالب Liquid بالبيانات المتاحة. | تحقق من أن المتغيرات المستخدمة في قوالب Liquid تتطابق مع البيانات المتاحة للمستلم. |
| LiquidTemplateInvalidTimezone | تم استخدام منطقة زمنية غير صالحة مع مرشح تاريخ في قالب Liquid. | تحقق من قيمة المنطقة الزمنية المستخدمة مع مرشح التاريخ في قوالب Liquid الخاصة بك. |
أخطاء التسليم والبنية التحتية
Anchor link toتأتي هذه الأخطاء من البنية التحتية لإرسال البريد الإلكتروني نفسها. معظمها عابر أو داخلي، والعديد منها يتطلب من دعم Pushwoosh التحقيق فيها.
| الخطأ | الوصف | ما يجب فعله |
|---|---|---|
| CannotConnect | لم يتمكن Pushwoosh من الاتصال ببوابة إرسال البريد الإلكتروني. | حاول إرسال الرسالة مرة أخرى لاحقًا. إذا استمر الخطأ، اتصل بـ دعم Pushwoosh. |
| CannotGetDeviceAPIURL | لم يتمكن Pushwoosh من تحديد عنوان URL لواجهة برمجة التطبيقات (API) المطلوب لإرسال البريد الإلكتروني. | اتصل بـ دعم Pushwoosh. |
| CannotSend | تعذر إرسال البريد الإلكتروني. | حاول إرسال الرسالة مرة أخرى لاحقًا. إذا استمر الخطأ، اتصل بـ دعم Pushwoosh. |
| EmailSESInvalidParameterValue | إحدى المعلمات التي تم تمريرها إلى Amazon غير صحيحة. | تحقق من المعلمات التي تم تمريرها وحاول مرة أخرى. |
| Failed | تعذر إرسال الرسالة لسبب داخلي. | حاول إرسال الرسالة مرة أخرى. إذا استمر الخطأ، اتصل بـ دعم Pushwoosh. |
| MessageRejected | رفضت Amazon الرسالة، ولم يتم إرسالها. | تحقق من محتوى الرسالة وعنوان المستلم، ثم حاول مرة أخرى. |
| RequestTimeout | انتهت مهلة الطلب إلى خدمة إرسال البريد الإلكتروني. | حاول إرسال الرسالة مرة أخرى لاحقًا. |
| SpamDetected | تم وضع علامة على الرسالة كرسالة غير مرغوب فيها ولم يتم إرسالها. | راجع المحتوى الخاص بك بحثًا عن خصائص تشبه البريد العشوائي واتصل بـ دعم Pushwoosh إذا كنت تعتقد أن هذا خطأ. |
| TransientFailure | حدث فشل مؤقت من جانب Amazon أثناء إرسال الرسالة. | حاول إرسال الرسالة مرة أخرى لاحقًا. |
| UnableToUnmarshalMetaData | لم يتمكن Pushwoosh من معالجة البيانات الوصفية المرفقة بالبريد الإلكتروني. | اتصل بـ دعم Pushwoosh مع معرف الرسالة. |
| UnknownError | حدث خطأ إرسال غير محدد. | اتصل بـ دعم Pushwoosh مع معرف الرسالة للتحقيق. |
أخطاء تكوين Amazon SES
Anchor link toتأتي هذه الأخطاء من البنية التحتية الداخلية لإرسال Amazon SES في Pushwoosh، وليس من محتوى رسالتك أو إعدادات حسابك.
| الخطأ | الوصف | ما يجب فعله |
|---|---|---|
أخطاء تكوين Amazon SES
| خطأ داخلي في البنية التحتية لإرسال Amazon SES في Pushwoosh. هذا ليس بسبب محتوى رسالتك أو إعدادات حسابك. | اتصل بـ دعم Pushwoosh مع اسم الخطأ الدقيق ووقت إرسال الرسالة. |