이메일 오류 문제 해결

이 페이지에는 Pushwoosh가 이메일을 보낼 때 반환할 수 있는 오류 코드가 원인별로 그룹화되어 나열되어 있습니다. 각 항목은 오류의 의미와 해결 방법을 설명합니다.

계정 및 전송 한도

이러한 오류는 계정 또는 구성 세트가 전송 한도, 일시 중지 또는 정지에 도달했음을 의미하며, 메시지 자체에는 문제가 없습니다.

오류	설명	조치 방법
AccountDailyQuotaExceeded	계정이 일일 이메일 전송 할당량을 초과했습니다.	할당량이 재설정될 때까지 기다리거나 Pushwoosh 지원팀에 문의하여 더 높은 할당량을 요청하십시오.
AccountSendingPaused / AccountSendingPausedException / ConfigurationSetSendingPaused / ConfigurationSetSendingPausedException	일반적으로 높은 반송률 또는 불만 제기율로 인해 계정 또는 구성 세트의 이메일 전송이 일시 중지되었습니다.	반송 및 불만 제기율을 검토하고 Pushwoosh 지원팀에 문의하여 전송을 재개하십시오.
AccountSuspended	계정의 이메일 전송 기능이 정지되었습니다.	Pushwoosh 지원팀에 문의하여 원인과 전송 복원 방법을 알아보십시오.
AccountThrottled	짧은 기간에 너무 많은 이메일이 전송되어 전송 속도 제한을 초과했습니다.	전송 속도를 줄이거나 Pushwoosh 지원팀에 문의하여 더 높은 속도 제한을 요청하십시오.

발신자 및 도메인 구성

이러한 오류는 발신 도메인 또는 “보낸 사람” 주소가 설정되고 확인되는 방식에 문제가 있음을 나타냅니다.

오류	설명	조치 방법
CannotGetCredentials	Pushwoosh가 이메일을 보내는 데 필요한 자격 증명을 가져올 수 없었습니다.	발신 도메인이 확인되고 활성 상태인지 확인하십시오.
FromEmailAddressNotVerifiedException	발신자 주소가 확인되지 않아 이 이메일을 보내는 데 사용할 수 없습니다.	발신자의 도메인 및 이메일 주소를 확인한 후 다시 시도하십시오.
FromEmailMissing	”보낸 사람” 이메일 주소가 누락되었거나 유효하지 않습니다.	이메일 플랫폼 구성 또는 메시지 설정에서 유효하고 확인된 “보낸 사람” 이메일 주소를 설정하십시오.
FromNameMissing	이메일의 “보낸 사람 이름”이 누락되었거나 유효하지 않습니다.	이메일 플랫폼 구성 또는 메시지 설정에서 유효한 “보낸 사람 이름”을 설정하십시오.
MailFromDomainNotVerified / MailFromDomainNotVerifiedException	Pushwoosh가 발신 도메인에 필요한 MX 레코드를 찾을 수 없어 메시지를 보낼 수 없었습니다.	발신 도메인의 DNS/DKIM 레코드를 확인하고 올바르게 게시되었는지 확인하십시오.
InvalidTrackingOptionsException	오픈/클릭 추적을 위해 구성된 사용자 지정 추적 도메인이 유효하지 않습니다.	사용자 지정 추적 도메인 설정을 확인하십시오.

수신자 주소 문제

이러한 오류는 계정이나 템플릿이 아닌 수신자 이메일 주소 자체(형식, 반송 및 불만 제기 기록)로 인해 발생합니다.

오류	설명	조치 방법
AddressContainsControlOrWhitespace	이메일 주소에 제어 문자나 추가 공백이 포함되어 있습니다.	이메일 주소에서 숨겨진 문자나 공백을 제거하고 다시 시도하십시오.
EmailComplaint	수신자가 이전에 귀하의 메시지를 스팸으로 표시했습니다.	발신자 평판을 보호하기 위해 향후 발송에서 이 수신자를 제거하십시오.
EmailIsBounced	이 이메일 주소는 이미 반송되었기 때문에 메시지가 전송되지 않았습니다.	유효하고 활성 상태인 이메일 주소를 사용하거나 메일링 리스트에서 이 수신자를 제거하십시오.
IllegalEmailAddress	수신자의 이메일 주소 형식이 유효하지 않습니다.	수신자의 이메일 주소를 확인하고 수정하십시오.
UnableToParseEmailBCC	BCC 필드에 유효하지 않은 값이 포함되어 있습니다.	BCC 필드에 있는 주소의 형식을 확인하십시오.

SMTP 전송 오류

이러한 오류는 Pushwoosh가 SMTP를 통해 메시지를 전달하는 동안 발생하며, 구성 누락에서 연결 실패에 이르기까지 다양합니다.

오류	설명	조치 방법
SMTPCannotProcessData	Pushwoosh가 SMTP 전송을 위해 이메일을 빌드할 수 없었습니다.	이메일 템플릿 설정을 확인하십시오.
SMTPCannotProcessFrom	SMTP “FROM” 필드가 비어 있습니다.	메시지에 유효한 “보낸 사람” 이메일 주소를 설정하십시오.
SMTPCannotProcessRcpt	SMTP “RCPT”(수신자) 필드가 비어 있습니다.	수신자의 이메일 주소가 올바르게 설정되었는지 확인하십시오.
SMTPCannotProcessSending	SMTP를 통해 메시지를 보내는 동안 내부 오류가 발생했습니다.	나중에 메시지를 다시 보내보십시오. 오류가 지속되면 Pushwoosh 지원팀에 문의하십시오.
SMTPIsNotConfigured	이 계정에 SMTP가 설정되지 않았습니다.	Pushwoosh 지원팀에 문의하여 SMTP 전송을 구성하십시오.
SMTPUnableToCreateConnection	Pushwoosh가 SMTP 연결을 설정할 수 없었습니다.	SMTP 서버 설정과 자격 증명을 확인한 후 다시 시도하십시오.
SMTPUnableToSignDKIM	Pushwoosh가 DKIM으로 메시지에 서명할 수 없었습니다.	발신 도메인의 DKIM 구성을 확인하십시오.
SMTPUnknownError	지정되지 않은 SMTP 오류가 발생했습니다.	메시지를 다시 보내보십시오. 오류가 지속되면 Pushwoosh 지원팀에 문의하십시오.

템플릿 및 콘텐츠 오류

이러한 오류는 Pushwoosh가 이메일을 빌드하거나 렌더링하는 동안 발생하며, 템플릿 누락, 잘못된 플레이스홀더 데이터 또는 잘못된 형식의 HTML 등이 원인입니다.

오류	설명	조치 방법
CannotGetEmailPlaceholders	Pushwoosh가 이메일 템플릿에 사용된 플레이스홀더를 가져올 수 없었습니다.	이메일 템플릿의 Dynamic Content 플레이스홀더를 확인하십시오.
CannotGetTemplateBindings	Pushwoosh가 템플릿을 렌더링하는 데 필요한 데이터 바인딩을 가져올 수 없었습니다.	템플릿에 사용된 Dynamic Content 및 Liquid Templates 설정을 확인하십시오.
CannotNormalizeHTML	전송을 위해 이메일 콘텐츠를 준비할 수 없었습니다.	이메일 템플릿의 HTML 콘텐츠에 오류가 있는지 확인하십시오.
CannotProcessEmailTemplateFromRepo	이메일 템플릿을 로드하고 처리할 수 없었습니다.	이메일 템플릿 설정을 확인하고 다시 시도하십시오.
EmailCannotGetEmailTemplateCode	email_template_code를 가져오지 못했거나 비어 있습니다.	플랫폼이 올바르게 구성되었는지 확인하고 다시 시도하십시오.
EmailCannotGetEmailTemplateFromRepo	email_template_code로 이메일 템플릿을 가져오지 못했습니다.	플랫폼이 올바르게 구성되었는지 확인하고 다시 시도하십시오.
InvalidRenderingParameterException	템플릿을 채우는 데 사용된 값 중 하나가 유효하지 않습니다. 종종 잘못된 형식의 JSON 때문입니다.	템플릿에 전달된 Dynamic Content 데이터를 확인하십시오.
InvalidTemplateException	지정된 이메일 템플릿을 렌더링할 수 없었습니다.	이메일 템플릿에 오류가 있는지 확인하고 다시 시도하십시오.
MissingRenderingAttributeException	템플릿의 플레이스홀더에서 참조하는 값이 제공되지 않았습니다.	템플릿에 사용된 모든 플레이스홀더에 일치하는 값이 있는지 확인하십시오.
TemplateDoesNotExistException	지정된 이메일 템플릿이 존재하지 않습니다.	이메일 템플릿이 올바르게 구성되었고 삭제되지 않았는지 확인하십시오.
TooDeepTemplateInsertion	템플릿이 서로 너무 깊게 중첩되어 있습니다.	이메일 콘텐츠에서 중첩된 템플릿 삽입 수를 줄이십시오.
UnableToBuildEmailAttachments	하나 이상의 첨부 파일을 빌드할 수 없었습니다.	이메일에 추가된 첨부 파일을 확인하고 다시 시도하십시오.
UnableToBuildHTML	이메일 템플릿을 컴파일하지 못했습니다. 대부분의 경우 템플릿에 Dynamic Content 플레이스홀더 또는 Liquid Templates와 관련된 오류가 포함되어 있습니다.	이메일 템플릿 설정을 확인하십시오.
UnableToCreateHTML	Pushwoosh가 이메일의 최종 HTML을 생성할 수 없었습니다.	이메일 템플릿 설정을 확인하십시오.
UnableToInsertTemplate	Pushwoosh가 참조된 템플릿을 이메일에 삽입할 수 없었습니다.	이메일 콘텐츠에서 삽입/중첩된 템플릿 참조를 확인하십시오.
UnableToMinifyHTML	Pushwoosh가 이메일의 HTML 콘텐츠를 축소할 수 없었습니다.	이메일 템플릿의 HTML에 잘못된 마크업이 있는지 확인하십시오.

Liquid 템플릿 및 Connected Content

이러한 오류는 Liquid 구문 및 개인화된 데이터를 가져오는 데 사용되는 Connected Content 요청에만 해당됩니다.

오류	설명	조치 방법
ConnectedContentInvalidJSON	Connected Content 엔드포인트가 유효하지 않은 JSON을 반환했습니다.	백엔드가 Connected Content 요청에 대해 유효한 JSON을 반환하는지 확인하십시오.
ConnectedContentInvalidParameters	Connected Content에 전달된 매개변수 수가 템플릿과 일치하지 않습니다.	Connected Content 태그에 전달된 매개변수를 템플릿과 비교하여 확인하십시오.
ConnectedContentInvalidTemplate	Connected Content 태그에 유효하지 않은 Liquid 템플릿이 포함되어 있습니다.	Connected Content 태그 내에서 사용된 Liquid 구문을 확인하십시오.
ConnectedContentInvalidURL	Pushwoosh가 Connected Content에 지정된 URL을 가져올 수 없었습니다.	Connected Content URL이 올바르고 연결 가능한지 확인하십시오.
ConnectedContentInvalidVarExpression	Connected Content에 사용된 ${} 표현식이 유효하지 않습니다.	Connected Content 태그에 사용된 ${} 구문을 확인하십시오.
InvalidLiquidTemplate	이메일에 유효하지 않은 Liquid 템플릿이 포함되어 있습니다.	이메일에 사용된 Liquid Templates 구문을 확인하십시오.
LiquidTemplateInvalidParsing	구문 오류로 인해 Liquid 템플릿을 구문 분석할 수 없었습니다.	이메일에 사용된 Liquid Templates 구문을 확인하십시오.
LiquidTemplateInvalidRendering	사용 가능한 데이터로 Liquid 템플릿을 렌더링할 수 없었습니다.	Liquid Templates에 사용된 변수가 수신자에게 사용 가능한 데이터와 일치하는지 확인하십시오.
LiquidTemplateInvalidTimezone	Liquid 템플릿의 날짜 필터에 유효하지 않은 시간대가 사용되었습니다.	Liquid Templates의 날짜 필터에 사용된 시간대 값을 확인하십시오.

전송 및 인프라 오류

이러한 오류는 이메일 전송 인프라 자체에서 발생합니다. 대부분은 일시적이거나 내부적인 오류이며, 일부는 Pushwoosh 지원팀의 조사가 필요합니다.

오류	설명	조치 방법
CannotConnect	Pushwoosh가 이메일 전송 게이트웨이에 연결할 수 없었습니다.	나중에 메시지를 다시 보내보십시오. 오류가 지속되면 Pushwoosh 지원팀에 문의하십시오.
CannotGetDeviceAPIURL	Pushwoosh가 이메일을 보내는 데 필요한 API URL을 확인할 수 없었습니다.	Pushwoosh 지원팀에 문의하십시오.
CannotSend	이메일을 보낼 수 없었습니다.	나중에 메시지를 다시 보내보십시오. 오류가 지속되면 Pushwoosh 지원팀에 문의하십시오.
EmailSESInvalidParameterValue	Amazon에 전달된 매개변수 중 하나가 잘못되었습니다.	전달된 매개변수를 확인하고 다시 시도하십시오.
Failed	내부적인 이유로 메시지를 보낼 수 없었습니다.	메시지를 다시 보내보십시오. 오류가 지속되면 Pushwoosh 지원팀에 문의하십시오.
MessageRejected	Amazon이 메시지를 거부하여 전송되지 않았습니다.	메시지 내용과 수신자 주소를 확인한 후 다시 시도하십시오.
RequestTimeout	이메일 전송 서비스에 대한 요청 시간이 초과되었습니다.	나중에 메시지를 다시 보내보십시오.
SpamDetected	메시지가 스팸으로 플래그 지정되어 전송되지 않았습니다.	콘텐츠에 스팸과 유사한 특성이 있는지 검토하고, 이것이 실수라고 생각되면 Pushwoosh 지원팀에 문의하십시오.
TransientFailure	메시지를 보내는 동안 Amazon 측에서 일시적인 오류가 발생했습니다.	나중에 메시지를 다시 보내보십시오.
UnableToUnmarshalMetaData	Pushwoosh가 이메일에 첨부된 메타데이터를 처리할 수 없었습니다.	메시지 ID와 함께 Pushwoosh 지원팀에 문의하십시오.
UnknownError	지정되지 않은 전송 오류가 발생했습니다.	조사를 위해 메시지 ID와 함께 Pushwoosh 지원팀에 문의하십시오.

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 지원팀에 문의하십시오.