أخطاء البريد الإلكتروني
تسرد هذه الصفحة رموز الأخطاء التي يمكن أن يعيدها 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 | حقل 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 من جلب العناصر النائبة المستخدمة في قالب البريد الإلكتروني. | تحقق من العناصر النائبة لـ المحتوى الديناميكي (Dynamic Content) في قالب البريد الإلكتروني. |
| CannotGetTemplateBindings | لم يتمكن Pushwoosh من جلب روابط البيانات المطلوبة لعرض القالب. | تحقق من إعدادات المحتوى الديناميكي (Dynamic Content) و قوالب Liquid المستخدمة في القالب. |
| CannotNormalizeHTML | تعذر تحضير محتوى البريد الإلكتروني للإرسال. | تحقق من محتوى HTML لقالب البريد الإلكتروني بحثًا عن أخطاء. |
| CannotProcessEmailTemplateFromRepo | تعذر تحميل ومعالجة قالب البريد الإلكتروني. | تحقق من إعدادات قالب البريد الإلكتروني وحاول مرة أخرى. |
| EmailCannotGetEmailTemplateCode | فشل في الحصول على email_template_code أو أنه فارغ. | تحقق من أن المنصة تم تكوينها بشكل صحيح وحاول مرة أخرى. |
| EmailCannotGetEmailTemplateFromRepo | فشل في الحصول على قالب البريد الإلكتروني بواسطة email_template_code. | تحقق من أن المنصة تم تكوينها بشكل صحيح وحاول مرة أخرى. |
| InvalidRenderingParameterException | إحدى القيم المستخدمة لملء القالب غير صالحة، غالبًا بسبب JSON مشوه. | تحقق من بيانات المحتوى الديناميكي (Dynamic Content) التي تم تمريرها إلى القالب. |
| InvalidTemplateException | تعذر عرض قالب البريد الإلكتروني المحدد. | تحقق من قالب البريد الإلكتروني بحثًا عن أخطاء وحاول مرة أخرى. |
| MissingRenderingAttributeException | لم يتم توفير قيمة مشار إليها بواسطة عنصر نائب في القالب. | تأكد من أن جميع العناصر النائبة المستخدمة في القالب لها قيم مطابقة. |
| TemplateDoesNotExistException | قالب البريد الإلكتروني المحدد غير موجود. | تحقق من أن قالب البريد الإلكتروني تم تكوينه بشكل صحيح ولم يتم حذفه. |
| TooDeepTemplateInsertion | القوالب متداخلة بعمق شديد داخل بعضها البعض. | قلل من عدد إدراجات القوالب المتداخلة في محتوى البريد الإلكتروني. |
| UnableToBuildEmailAttachments | تعذر بناء مرفق واحد أو أكثر. | تحقق من المرفقات المضافة إلى البريد الإلكتروني وحاول مرة أخرى. |
| UnableToBuildHTML | فشل في تجميع قالب البريد الإلكتروني. على الأرجح، يحتوي القالب على خطأ متعلق بـ العناصر النائبة للمحتوى الديناميكي (Dynamic Content) أو قوالب Liquid. | تحقق من إعدادات قالب البريد الإلكتروني. |
| UnableToCreateHTML | لم يتمكن Pushwoosh من إنشاء HTML النهائي للبريد الإلكتروني. | تحقق من إعدادات قالب البريد الإلكتروني. |
| UnableToInsertTemplate | لم يتمكن Pushwoosh من إدراج قالب مشار إليه في البريد الإلكتروني. | تحقق من مرجع القالب المدرج/المتداخل في محتوى البريد الإلكتروني. |
| UnableToMinifyHTML | لم يتمكن Pushwoosh من تصغير محتوى HTML للبريد الإلكتروني. | تحقق من HTML الخاص بقالب البريد الإلكتروني بحثًا عن ترميز مشوه. |
قوالب Liquid والمحتوى المتصل (Connected Content)
Anchor link toهذه الأخطاء خاصة ببناء جملة Liquid وطلبات المحتوى المتصل (Connected Content) المستخدمة لسحب البيانات المخصصة.
| الخطأ | الوصف | ماذا تفعل |
|---|---|---|
| ConnectedContentInvalidJSON | أعادت نقطة نهاية المحتوى المتصل (Connected Content) JSON غير صالح. | تحقق من أن الواجهة الخلفية الخاصة بك تعيد JSON صالحًا لطلب المحتوى المتصل. |
| ConnectedContentInvalidParameters | عدد المعلمات التي تم تمريرها إلى المحتوى المتصل (Connected Content) لا يتطابق مع القالب. | تحقق من المعلمات التي تم تمريرها في علامة المحتوى المتصل مقابل قالبك. |
| ConnectedContentInvalidTemplate | تحتوي علامة المحتوى المتصل (Connected Content) على قالب Liquid غير صالح. | تحقق من بناء جملة Liquid المستخدم داخل علامة المحتوى المتصل. |
| ConnectedContentInvalidURL | لم يتمكن Pushwoosh من جلب عنوان URL المحدد في المحتوى المتصل (Connected Content). | تحقق من أن عنوان URL للمحتوى المتصل صحيح ويمكن الوصول إليه. |
| ConnectedContentInvalidVarExpression | تعبير ${} المستخدم في المحتوى المتصل (Connected Content) غير صالح. | تحقق من بناء جملة ${} المستخدم في علامة المحتوى المتصل. |
| 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 مع ذكر اسم الخطأ الدقيق ووقت إرسال الرسالة. |