Устранение ошибок при отправке 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-платформы или в настройках сообщения. |
| 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Эти ошибки исходят от внутренней инфраструктуры отправки Amazon SES в Pushwoosh, а не от содержимого вашего сообщения или настроек аккаунта.
| Ошибка | Описание | Что делать |
|---|---|---|
Ошибки конфигурации Amazon SES
| Внутренняя ошибка в инфраструктуре отправки Amazon SES в Pushwoosh. Это не вызвано содержимым вашего сообщения или настройками аккаунта. | Свяжитесь со службой поддержки Pushwoosh, указав точное название ошибки и время отправки сообщения. |