Устранение ошибок при отправке email

На этой странице перечислены коды ошибок, которые Pushwoosh может вернуть при отправке email, сгруппированные по причинам их возникновения. Каждая запись объясняет, что означает ошибка и как ее устранить.

Ограничения аккаунта и отправки

Эти ошибки означают, что ваш аккаунт или набор конфигураций достиг лимита отправки, приостановлен или заблокирован — с самим сообщением все в порядке.

Ошибка	Описание	Что делать
AccountDailyQuotaExceeded	Ваш аккаунт достиг дневной квоты на отправку email.	Подождите, пока квота сбросится, или свяжитесь со службой поддержки Pushwoosh, чтобы запросить увеличение квоты.
AccountSendingPaused / AccountSendingPausedException / ConfigurationSetSendingPaused / ConfigurationSetSendingPausedException	Отправка email была приостановлена для вашего аккаунта или набора конфигураций, обычно из-за высокого процента отказов или жалоб.	Проверьте ваши показатели отказов и жалоб и свяжитесь со службой поддержки Pushwoosh для возобновления отправки.
AccountSuspended	Возможность отправки email для вашего аккаунта была приостановлена.	Свяжитесь со службой поддержки Pushwoosh, чтобы выяснить причину и способ восстановления отправки.
AccountThrottled	За короткий период было отправлено слишком много email, и лимит скорости отправки был превышен.	Снизьте скорость отправки или свяжитесь со службой поддержки Pushwoosh, чтобы запросить увеличение лимита скорости.

Конфигурация отправителя и домена

Эти ошибки указывают на проблему с настройкой и верификацией вашего домена отправки или адреса “От кого”.

Ошибка	Описание	Что делать
CannotGetCredentials	Pushwoosh не удалось получить учетные данные, необходимые для отправки email.	Убедитесь, что ваш домен отправителя верифицирован и активен.
FromEmailAddressNotVerifiedException	Адрес отправителя не верифицирован и не может быть использован для отправки этого email.	Верифицируйте домен и email-адрес отправителя и попробуйте снова.
From email domain is not verified (1296)	Домен в поле “От кого” не прошел верификацию DNS, поэтому сообщение (включая тестовые email) не может быть создано.	Проверьте статус домена в разделе Ваши домены отправителя и добавьте все записи, которые все еще отмечены как Pending.
Reply email domain is not verified (1297)	Домен для ответа не прошел верификацию DNS, поэтому сообщение (включая тестовые email) не может быть создано.	Проверьте статус домена в разделе Ваши домены отправителя и добавьте все записи, которые все еще отмечены как Pending.
FromEmailMissing	Email-адрес в поле “От кого” отсутствует или недействителен.	Укажите действительный, верифицированный email-адрес в поле “От кого” в конфигурации email-платформы или в настройках сообщения.
FromNameMissing	”Имя отправителя” для email отсутствует или недействительно.	Укажите действительное “Имя отправителя” в конфигурации email-платформы или в настройках сообщения.
MailFromDomainNotVerified / MailFromDomainNotVerifiedException	Сообщение не удалось отправить, так как Pushwoosh не смог найти необходимую MX-запись для домена отправки.	Проверьте записи DNS/DKIM для вашего домена отправки и убедитесь, что они опубликованы корректно.
InvalidTrackingOptionsException	Пользовательский домен отслеживания, настроенный для отслеживания открытий/кликов, недействителен.	Проверьте настройки вашего пользовательского домена отслеживания.

Проблемы с адресом получателя

Эти ошибки вызваны самим email-адресом получателя — его форматом или историей отказов и жалоб, — а не вашим аккаунтом или шаблоном.

Ошибка	Описание	Что делать
AddressContainsControlOrWhitespace	Email-адрес содержит управляющие символы или лишние пробелы.	Удалите все скрытые символы или пробелы из email-адреса и попробуйте снова.
EmailComplaint	Получатель ранее пометил сообщение от вас как спам.	Удалите этого получателя из будущих рассылок, чтобы защитить свою репутацию отправителя.
EmailIsBounced	Сообщение не было отправлено, так как по этому email-адресу уже был зафиксирован отказ.	Используйте действительный, активный email-адрес или удалите этого получателя из вашего списка рассылки.
IllegalEmailAddress	Email-адрес получателя имеет неверный формат.	Проверьте email-адрес получателя и исправьте его.
UnableToParseEmailBCC	Поле BCC (скрытая копия) содержит неверное значение.	Проверьте формат адресов в поле BCC.

Ошибки доставки SMTP

Эти ошибки возникают, когда 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, если адрес выглядит корректным.

Ошибки шаблона и контента

Эти ошибки возникают, когда Pushwoosh формирует или отображает email — отсутствует шаблон, неверные данные для плейсхолдеров или некорректный HTML.

Ошибка	Описание	Что делать
CannotGetEmailPlaceholders	Pushwoosh не удалось получить плейсхолдеры, используемые в шаблоне email.	Проверьте плейсхолдеры динамического контента (Dynamic Content) в шаблоне email.
CannotGetTemplateBindings	Pushwoosh не удалось получить привязки данных, необходимые для отображения шаблона.	Проверьте настройки динамического контента (Dynamic Content) и шаблонов Liquid (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 (Liquid Templates).	Проверьте настройки шаблона email.
UnableToCreateHTML	Pushwoosh не удалось сгенерировать окончательный HTML для email.	Проверьте настройки шаблона email.
UnableToInsertTemplate	Pushwoosh не удалось вставить указанный шаблон в email.	Проверьте ссылку на вставленный/вложенный шаблон в контенте email.
UnableToMinifyHTML	Pushwoosh не удалось минимизировать HTML-контент email.	Проверьте HTML шаблона email на наличие некорректной разметки.

Шаблоны Liquid и Connected Content

Эти ошибки специфичны для синтаксиса 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 (Liquid Templates), используемый в email.
LiquidTemplateInvalidParsing	Шаблон Liquid не удалось разобрать из-за синтаксической ошибки.	Проверьте синтаксис шаблонов Liquid (Liquid Templates), используемый в email.
LiquidTemplateInvalidRendering	Шаблон Liquid не удалось отобразить с доступными данными.	Убедитесь, что переменные, используемые в шаблонах Liquid (Liquid Templates), соответствуют данным, доступным для получателя.
LiquidTemplateInvalidTimezone	В шаблоне Liquid был использован недействительный часовой пояс с фильтром даты.	Проверьте значение часового пояса, используемое с фильтром даты в ваших шаблонах Liquid (Liquid Templates).

Ошибки доставки и инфраструктуры

Эти ошибки исходят от самой инфраструктуры отправки 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

Эти ошибки исходят от внутренней инфраструктуры отправки Pushwoosh через Amazon SES, а не от содержимого вашего сообщения или настроек аккаунта.

Ошибка	Описание	Что делать
Ошибки конфигурации Amazon SES ConfigurationSetAlreadyExistsException ConfigurationSetDoesNotExistException EventDestinationAlreadyExistsException EventDestinationDoesNotExistException InvalidCloudWatchDestinationException InvalidConfigurationSetException InvalidDeliveryOptionsException InvalidFirehoseDestinationException InvalidLambdaFunctionException InvalidPolicyException InvalidS3ConfigurationException InvalidSNSDestinationException InvalidSnsTopicException RuleDoesNotExistException RuleSetDoesNotExistException TrackingOptionsAlreadyExistsException TrackingOptionsDoesNotExistException CustomVerificationEmailInvalidContentException CustomVerificationEmailTemplateAlreadyExistsException CustomVerificationEmailTemplateDoesNotExistException LimitExceededException ProductionAccessNotGrantedException AlreadyExistsException CannotDeleteException InvalidSendingPoolName	Внутренняя ошибка в инфраструктуре отправки Pushwoosh через Amazon SES. Она не вызвана содержимым вашего сообщения или настройками аккаунта.	Свяжитесь со службой поддержки Pushwoosh, указав точное название ошибки и время отправки сообщения.