Ошибки 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. |
| SMTPProviderBlocked (1138) | Pushwoosh приостановил отправку провайдеру email этого получателя с вашего аккаунта после слишком большого количества отказов и ошибок за короткий период. | Подождите возобновления отправки или свяжитесь со службой поддержки Pushwoosh, если проблема не исчезнет. |
| SMTPUnableToCreateConnection | Pushwoosh не удалось установить SMTP-соединение. | Проверьте настройки и учетные данные вашего SMTP-сервера, затем попробуйте снова. |
| SMTPUnableToSignDKIM | Pushwoosh не удалось подписать сообщение с помощью DKIM. | Проверьте конфигурацию DKIM для вашего домена отправки. |
| SMTPUnknownError | Произошла неуказанная ошибка SMTP. | Попробуйте отправить сообщение еще раз. Если ошибка не исчезнет, свяжитесь со службой поддержки Pushwoosh. |
| SMTPUnknownProvider (1139) | Pushwoosh не удалось определить email-провайдера для адреса получателя. | Убедитесь, что email-адрес получателя отформатирован правильно, или свяжитесь со службой поддержки 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Эти ошибки исходят от внутренней инфраструктуры отправки Amazon SES в Pushwoosh, а не от содержимого вашего сообщения или настроек аккаунта.
| Ошибка | Описание | Что делать |
|---|---|---|
Ошибки конфигурации Amazon SES
| Внутренняя ошибка в инфраструктуре отправки Amazon SES в Pushwoosh. Она не вызвана содержимым вашего сообщения или настройками аккаунта. | Свяжитесь со службой поддержки Pushwoosh, указав точное название ошибки и время отправки сообщения. |