استكشاف أخطاء البريد الإلكتروني وإصلاحها
تسرد هذه الصفحة رموز الأخطاء التي يمكن أن يعيدها Pushwoosh عند إرسال بريد إلكتروني، مجمعة حسب سببها. يشرح كل إدخال معنى الخطأ وكيفية حله.
قيود الحساب والإرسال
Anchor link toتعني هذه الأخطاء أن حسابك أو مجموعة التكوين الخاصة بك قد وصلت إلى حد أقصى للإرسال، أو توقف مؤقت، أو تعليق — لا يوجد خطأ في الرسالة نفسها.
| الخطأ | الوصف | ما يجب فعله |
|---|---|---|
| AccountDailyQuotaExceeded | لقد وصل حسابك إلى حصته اليومية لإرسال البريد الإلكتروني. | انتظر حتى تتم إعادة تعيين الحصة، أو اتصل بـ دعم Pushwoosh لطلب حصة أعلى. |
| AccountSendingPaused / AccountSendingPausedException / ConfigurationSetSendingPaused / ConfigurationSetSendingPausedException | تم إيقاف إرسال البريد الإلكتروني مؤقتًا لحسابك أو مجموعة التكوين الخاصة بك، عادةً بسبب ارتفاع معدل الارتداد أو الشكاوى. | راجع معدلات الارتداد والشكاوى واتصل بـ دعم Pushwoosh لاستئناف الإرسال. |
| AccountSuspended | تم تعليق قدرة حسابك على إرسال رسائل البريد الإلكتروني. | اتصل بـ دعم Pushwoosh لمعرفة السبب وكيفية استعادة الإرسال. |
| AccountThrottled | تم إرسال عدد كبير جدًا من رسائل البريد الإلكتروني في فترة قصيرة، وتم تجاوز حد معدل الإرسال. | قلل من معدل الإرسال، أو اتصل بـ دعم Pushwoosh لطلب حد أعلى لمعدل الإرسال. |
تكوين المرسل والنطاق
Anchor link toتشير هذه الأخطاء إلى وجود مشكلة في كيفية إعداد نطاق الإرسال أو عنوان “من” والتحقق منه.
| الخطأ | الوصف | ما يجب فعله |
|---|---|---|
| CannotGetCredentials | لم يتمكن Pushwoosh من الحصول على بيانات الاعتماد اللازمة لإرسال البريد الإلكتروني. | تحقق من أن نطاق المرسل الخاص بك قد تم التحقق منه وأنه نشط. |
| FromEmailAddressNotVerifiedException | لم يتم التحقق من عنوان المرسل ولا يمكن استخدامه لإرسال هذا البريد الإلكتروني. | تحقق من نطاق المرسل وعنوان بريده الإلكتروني وحاول مرة أخرى. |
| 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 | حقل “FROM” في SMTP فارغ. | قم بتعيين عنوان بريد إلكتروني “من” صالح للرسالة. |
| SMTPCannotProcessRcpt | حقل “RCPT” (المستلم) في SMTP فارغ. | تحقق من أن عنوان البريد الإلكتروني للمستلم قد تم تعيينه بشكل صحيح. |
| SMTPCannotProcessSending | حدث خطأ داخلي أثناء إرسال الرسالة عبر SMTP. | حاول إرسال الرسالة مرة أخرى لاحقًا. إذا استمر الخطأ، اتصل بـ دعم Pushwoosh. |
| SMTPIsNotConfigured | لم يتم إعداد SMTP لهذا الحساب. | اتصل بـ دعم Pushwoosh لتكوين إرسال SMTP. |
| SMTPUnableToCreateConnection | لم يتمكن Pushwoosh من إنشاء اتصال SMTP. | تحقق من إعدادات خادم SMTP وبيانات الاعتماد الخاصة بك، ثم حاول مرة أخرى. |
| SMTPUnableToSignDKIM | لم يتمكن Pushwoosh من توقيع الرسالة باستخدام DKIM. | تحقق من تكوين DKIM لنطاق الإرسال الخاص بك. |
| SMTPUnknownError | حدث خطأ SMTP غير محدد. | حاول إرسال الرسالة مرة أخرى. إذا استمر الخطأ، اتصل بـ دعم 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 وطلبات المحتوى المتصل (Connected Content) المستخدمة لسحب البيانات المخصصة.
| الخطأ | الوصف | ما يجب فعله |
|---|---|---|
| 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 مع اسم الخطأ الدقيق والوقت الذي تم فيه إرسال الرسالة. |