Ошибки email-рассылок
На этой странице перечислены коды ошибок, которые Pushwoosh может вернуть при отправке email-сообщения, сгруппированные по причинам их возникновения. Каждая запись объясняет, что означает ошибка и как ее устранить.
Аккаунт и лимиты отправки
Anchor link toЭти ошибки означают, что ваш аккаунт или набор конфигураций достиг лимита отправки, приостановлен или заблокирован — с самим сообщением все в порядке.
| Ошибка | Описание | Что делать |
|---|---|---|
| AccountDailyQuotaExceeded | Ваш аккаунт достиг дневной квоты на отправку email-сообщений. | Подождите, пока квота сбросится, или свяжитесь со службой поддержки Pushwoosh, чтобы запросить увеличение квоты. |
| AccountSendingPaused / AccountSendingPausedException / ConfigurationSetSendingPaused / ConfigurationSetSendingPausedException | Отправка email-сообщений была приостановлена для вашего аккаунта или набора конфигураций, обычно из-за высокого процента отказов или жалоб. | Проверьте показатели отказов и жалоб и свяжитесь со службой поддержки Pushwoosh, чтобы возобновить отправку. |
| AccountSuspended | Возможность отправки email-сообщений для вашего аккаунта была приостановлена. | Свяжитесь со службой поддержки Pushwoosh, чтобы выяснить причину и узнать, как восстановить отправку. |
| AccountThrottled | За короткий период было отправлено слишком много email-сообщений, и лимит скорости отправки был превышен. | Снизьте скорость отправки или свяжитесь со службой поддержки Pushwoosh, чтобы запросить увеличение лимита скорости. |
Конфигурация отправителя и домена
Anchor link toЭти ошибки указывают на проблему с настройкой и верификацией вашего домена-отправителя или адреса в поле «От кого».
| Ошибка | Описание | Что делать |
|---|---|---|
| CannotGetCredentials | Pushwoosh не удалось получить учетные данные, необходимые для отправки email-сообщения. | Убедитесь, что ваш домен-отправитель подтвержден и активен. |
| FromEmailAddressNotVerifiedException | Адрес отправителя не подтвержден и не может быть использован для отправки этого email-сообщения. | Подтвердите домен и email-адрес отправителя и попробуйте снова. |
| FromEmailMissing | Email-адрес в поле «От кого» отсутствует или недействителен. | Укажите действительный, подтвержденный email-адрес в поле «От кого» в конфигурации email-платформы или в настройках сообщения. |
| FromNameMissing | «Имя отправителя» для email-сообщения отсутствует или недействительно. | Укажите действительное «Имя отправителя» в конфигурации email-платформы или в настройках сообщения. |
| MailFromDomainNotVerified / MailFromDomainNotVerifiedException | Сообщение не может быть отправлено, так как Pushwoosh не удалось найти необходимую MX-запись для домена-отправителя. | Проверьте записи DNS/DKIM для вашего домена-отправителя и убедитесь, что они опубликованы корректно. |
| InvalidTrackingOptionsException | Пользовательский домен для отслеживания, настроенный для отслеживания открытий/кликов, недействителен. | Проверьте настройки вашего пользовательского домена для отслеживания. |
Проблемы с адресом получателя
Anchor link toЭти ошибки вызваны самим email-адресом получателя — его форматом или историей отказов и жалоб, — а не вашим аккаунтом или шаблоном.
| Ошибка | Описание | Что делать |
|---|---|---|
| AddressContainsControlOrWhitespace | Email-адрес содержит управляющие символы или лишние пробелы. | Удалите все скрытые символы или пробелы из email-адреса и попробуйте снова. |
| EmailComplaint | Получатель ранее пометил ваше сообщение как спам. | Удалите этого получателя из будущих рассылок, чтобы защитить свою репутацию отправителя. |
| EmailIsBounced | Сообщение не было отправлено, так как по этому email-адресу уже был зафиксирован отказ. | Используйте действительный, активный email-адрес или удалите этого получателя из вашего списка рассылки. |
| IllegalEmailAddress | Email-адрес получателя имеет неверный формат. | Проверьте и исправьте email-адрес получателя. |
| UnableToParseEmailBCC | Поле BCC содержит неверное значение. | Проверьте формат адресов в поле BCC. |
Ошибки доставки SMTP
Anchor link toЭти ошибки возникают, когда Pushwoosh доставляет сообщение по SMTP, и могут быть вызваны чем угодно: от отсутствующей конфигурации до сбоя соединения.
| Ошибка | Описание | Что делать |
|---|---|---|
| SMTPCannotProcessData | Pushwoosh не удалось собрать email-сообщение для доставки по SMTP. | Проверьте настройки шаблона email-сообщения. |
| SMTPCannotProcessFrom | Поле SMTP «FROM» пусто. | Укажите действительный email-адрес в поле «От кого» для сообщения. |
| SMTPCannotProcessRcpt | Поле SMTP «RCPT» (получатель) пусто. | Убедитесь, что email-адрес получателя указан правильно. |
| SMTPCannotProcessSending | Произошла внутренняя ошибка при отправке сообщения через SMTP. | Попробуйте отправить сообщение позже. Если ошибка не исчезнет, свяжитесь со службой поддержки Pushwoosh. |
| SMTPIsNotConfigured | SMTP не настроен для этого аккаунта. | Свяжитесь со службой поддержки Pushwoosh, чтобы настроить отправку по SMTP. |
| SMTPUnableToCreateConnection | Pushwoosh не удалось установить SMTP-соединение. | Проверьте настройки и учетные данные вашего SMTP-сервера, затем попробуйте снова. |
| SMTPUnableToSignDKIM | Pushwoosh не удалось подписать сообщение с помощью DKIM. | Проверьте конфигурацию DKIM для вашего домена-отправителя. |
| SMTPUnknownError | Произошла неуточненная ошибка SMTP. | Попробуйте отправить сообщение еще раз. Если ошибка не исчезнет, свяжитесь со службой поддержки Pushwoosh. |
Ошибки шаблона и контента
Anchor link toЭти ошибки возникают, когда Pushwoosh собирает или отображает email-сообщение — отсутствует шаблон, неверные данные плейсхолдера или некорректный HTML.
| Ошибка | Описание | Что делать |
|---|---|---|
| CannotGetEmailPlaceholders | Pushwoosh не удалось получить плейсхолдеры, используемые в шаблоне email-сообщения. | Проверьте плейсхолдеры Dynamic Content в шаблоне email-сообщения. |
| CannotGetTemplateBindings | Pushwoosh не удалось получить привязки данных, необходимые для отображения шаблона. | Проверьте настройки Dynamic Content и Liquid Templates, используемые в шаблоне. |
| CannotNormalizeHTML | Не удалось подготовить контент email-сообщения к отправке. | Проверьте HTML-контент шаблона email-сообщения на наличие ошибок. |
| CannotProcessEmailTemplateFromRepo | Не удалось загрузить и обработать шаблон email-сообщения. | Проверьте настройки шаблона email-сообщения и попробуйте снова. |
| EmailCannotGetEmailTemplateCode | Не удалось получить email_template_code или он пуст. | Убедитесь, что платформа настроена правильно, и попробуйте снова. |
| EmailCannotGetEmailTemplateFromRepo | Не удалось получить шаблон email-сообщения по email_template_code. | Убедитесь, что платформа настроена правильно, и попробуйте снова. |
| InvalidRenderingParameterException | Одно из значений, используемых для заполнения шаблона, недействительно, часто из-за некорректного JSON. | Проверьте данные Dynamic Content, передаваемые в шаблон. |
| InvalidTemplateException | Указанный шаблон email-сообщения не может быть отображен. | Проверьте шаблон email-сообщения на наличие ошибок и попробуйте снова. |
| MissingRenderingAttributeException | Значение, на которое ссылается плейсхолдер в шаблоне, не было предоставлено. | Убедитесь, что все плейсхолдеры, используемые в шаблоне, имеют соответствующие значения. |
| TemplateDoesNotExistException | Указанный шаблон email-сообщения не существует. | Убедитесь, что шаблон email-сообщения настроен правильно и не был удален. |
| TooDeepTemplateInsertion | Шаблоны слишком глубоко вложены друг в друга. | Уменьшите количество вложенных вставок шаблонов в контенте email-сообщения. |
| UnableToBuildEmailAttachments | Не удалось собрать одно или несколько вложений. | Проверьте вложения, добавленные к email-сообщению, и попробуйте снова. |
| UnableToBuildHTML | Не удалось скомпилировать шаблон email-сообщения. Скорее всего, шаблон содержит ошибку, связанную с плейсхолдерами Dynamic Content или Liquid Templates. | Проверьте настройки шаблона email-сообщения. |
| UnableToCreateHTML | Pushwoosh не удалось сгенерировать окончательный HTML для email-сообщения. | Проверьте настройки шаблона email-сообщения. |
| UnableToInsertTemplate | Pushwoosh не удалось вставить шаблон, на который есть ссылка, в email-сообщение. | Проверьте ссылку на вставленный/вложенный шаблон в контенте email-сообщения. |
| UnableToMinifyHTML | Pushwoosh не удалось минимизировать HTML-контент email-сообщения. | Проверьте HTML-код шаблона email-сообщения на наличие некорректной разметки. |
Шаблоны Liquid и Connected Content
Anchor link toЭти ошибки специфичны для синтаксиса Liquid и запросов Connected Content, используемых для получения персонализированных данных.
| Ошибка | Описание | Что делать |
|---|---|---|
| ConnectedContentInvalidJSON | Эндпоинт Connected Content вернул невалидный JSON. | Убедитесь, что ваш бэкенд возвращает валидный JSON для запроса Connected Content. |
| ConnectedContentInvalidParameters | Количество параметров, переданных в Connected Content, не соответствует шаблону. | Сверьте параметры, переданные в теге Connected Content, с вашим шаблоном. |
| ConnectedContentInvalidTemplate | Тег Connected Content содержит невалидный шаблон Liquid. | Проверьте синтаксис Liquid, используемый внутри тега Connected Content. |
| ConnectedContentInvalidURL | Pushwoosh не удалось получить доступ к URL, указанному в Connected Content. | Убедитесь, что URL-адрес Connected Content указан правильно и доступен. |
| ConnectedContentInvalidVarExpression | Выражение ${} , используемое в Connected Content, невалидно. | Проверьте синтаксис ${} , используемый в теге Connected Content. |
| InvalidLiquidTemplate | Email-сообщение содержит невалидный шаблон Liquid. | Проверьте синтаксис Liquid Templates, используемый в email-сообщении. |
| LiquidTemplateInvalidParsing | Шаблон Liquid не может быть разобран из-за синтаксической ошибки. | Проверьте синтаксис Liquid Templates, используемый в email-сообщении. |
| LiquidTemplateInvalidRendering | Шаблон Liquid не может быть отображен с доступными данными. | Убедитесь, что переменные, используемые в Liquid Templates, соответствуют данным, доступным для получателя. |
| LiquidTemplateInvalidTimezone | В шаблоне Liquid был использован неверный часовой пояс с фильтром даты. | Проверьте значение часового пояса, используемое с фильтром даты в ваших Liquid Templates. |
Ошибки доставки и инфраструктуры
Anchor link toЭти ошибки исходят от самой инфраструктуры отправки email-сообщений. Большинство из них являются временными или внутренними, а некоторые требуют расследования со стороны службы поддержки Pushwoosh.
| Ошибка | Описание | Что делать |
|---|---|---|
| CannotConnect | Pushwoosh не удалось подключиться к шлюзу отправки email-сообщений. | Попробуйте отправить сообщение позже. Если ошибка не исчезнет, свяжитесь со службой поддержки Pushwoosh. |
| CannotGetDeviceAPIURL | Pushwoosh не удалось определить URL-адрес API, необходимый для отправки email-сообщения. | Свяжитесь со службой поддержки Pushwoosh. |
| CannotSend | Не удалось отправить email-сообщение. | Попробуйте отправить сообщение позже. Если ошибка не исчезнет, свяжитесь со службой поддержки Pushwoosh. |
| EmailSESInvalidParameterValue | Один из параметров, переданных в Amazon, неверен. | Проверьте переданные параметры и попробуйте снова. |
| Failed | Сообщение не может быть отправлено по внутренней причине. | Попробуйте отправить сообщение еще раз. Если ошибка не исчезнет, свяжитесь со службой поддержки Pushwoosh. |
| MessageRejected | Amazon отклонил сообщение, и оно не было отправлено. | Проверьте контент сообщения и адрес получателя, затем попробуйте снова. |
| RequestTimeout | Время ожидания запроса к сервису отправки email-сообщений истекло. | Попробуйте отправить сообщение позже. |
| SpamDetected | Сообщение было помечено как спам и не было отправлено. | Проверьте ваш контент на наличие признаков спама и свяжитесь со службой поддержки Pushwoosh, если считаете, что это ошибка. |
| TransientFailure | Произошел временный сбой на стороне Amazon при отправке сообщения. | Попробуйте отправить сообщение позже. |
| UnableToUnmarshalMetaData | Pushwoosh не удалось обработать метаданные, прикрепленные к email-сообщению. | Свяжитесь со службой поддержки Pushwoosh, указав ID сообщения. |
| UnknownError | Произошла неуточненная ошибка отправки. | Свяжитесь со службой поддержки Pushwoosh, указав ID сообщения для расследования. |
Ошибки конфигурации Amazon SES
Anchor link toЭти ошибки исходят от внутренней инфраструктуры отправки Pushwoosh на базе Amazon SES, а не от контента вашего сообщения или настроек аккаунта.
| Ошибка | Описание | Что делать |
|---|---|---|
Ошибки конфигурации Amazon SES
| Внутренняя ошибка в инфраструктуре отправки Pushwoosh на базе Amazon SES. Она не вызвана контентом вашего сообщения или настройками аккаунта. | Свяжитесь со службой поддержки Pushwoosh, указав точное название ошибки и время отправки сообщения. |