Solução de problemas de erros de e-mail

Esta página lista os códigos de erro que o Pushwoosh pode retornar ao enviar um e-mail, agrupados pela causa. Cada entrada explica o que o erro significa e como resolvê-lo.

Limites de conta e de envio

Esses erros significam que sua conta ou conjunto de configurações atingiu um limite de envio, pausa ou suspensão — não há nada de errado com a mensagem em si.

Erro	Descrição	O que fazer
AccountDailyQuotaExceeded	Sua conta atingiu a cota diária de envio de e-mails.	Aguarde a redefinição da cota ou entre em contato com o Suporte da Pushwoosh para solicitar uma cota maior.
AccountSendingPaused / AccountSendingPausedException / ConfigurationSetSendingPaused / ConfigurationSetSendingPausedException	O envio de e-mails foi pausado para sua conta ou conjunto de configurações, geralmente devido a uma alta taxa de rejeição (bounce) ou reclamação.	Revise suas taxas de rejeição e reclamação e entre em contato com o Suporte da Pushwoosh para retomar o envio.
AccountSuspended	A capacidade da sua conta de enviar e-mails foi suspensa.	Entre em contato com o Suporte da Pushwoosh para descobrir o motivo e como restaurar o envio.
AccountThrottled	Muitos e-mails foram enviados em um curto período, e o limite da taxa de envio foi excedido.	Reduza sua taxa de envio ou entre em contato com o Suporte da Pushwoosh para solicitar um limite de taxa maior.

Configuração do remetente e do domínio

Esses erros indicam um problema na forma como seu domínio de envio ou endereço “De” está configurado e verificado.

Erro	Descrição	O que fazer
CannotGetCredentials	O Pushwoosh não conseguiu obter as credenciais necessárias para enviar o e-mail.	Verifique se o seu domínio de remetente está verificado e ativo.
FromEmailAddressNotVerifiedException	O endereço do remetente não está verificado e não pode ser usado para enviar este e-mail.	Verifique o domínio e o endereço de e-mail do remetente e tente novamente.
From email domain is not verified (1296)	O domínio “De” não concluiu a verificação de DNS, portanto, a mensagem (incluindo e-mails de teste) não pode ser criada.	Verifique o status do domínio em Seus domínios de remetente e adicione quaisquer registros ainda marcados como Pendente.
Reply email domain is not verified (1297)	O domínio de resposta não concluiu a verificação de DNS, portanto, a mensagem (incluindo e-mails de teste) não pode ser criada.	Verifique o status do domínio em Seus domínios de remetente e adicione quaisquer registros ainda marcados como Pendente.
FromEmailMissing	O endereço de e-mail “De” está ausente ou é inválido.	Defina um endereço de e-mail “De” válido e verificado na configuração da plataforma de e-mail ou nas configurações da mensagem.
FromNameMissing	O “Nome do Remetente” do e-mail está ausente ou é inválido.	Defina um “Nome do Remetente” válido na configuração da plataforma de e-mail ou nas configurações da mensagem.
MailFromDomainNotVerified / MailFromDomainNotVerifiedException	A mensagem não pôde ser enviada porque o Pushwoosh não conseguiu encontrar o registro MX necessário para o domínio de envio.	Verifique os registros DNS/DKIM do seu domínio de envio e certifique-se de que estão publicados corretamente.
InvalidTrackingOptionsException	O domínio de rastreamento personalizado configurado para rastreamento de abertura/clique é inválido.	Verifique as configurações do seu domínio de rastreamento personalizado.

Problemas com o endereço do destinatário

Esses erros são causados pelo próprio endereço de e-mail do destinatário — seu formato ou seu histórico de rejeições e reclamações — e não pela sua conta ou modelo.

Erro	Descrição	O que fazer
AddressContainsControlOrWhitespace	O endereço de e-mail contém caracteres de controle ou espaços em branco extras.	Remova quaisquer caracteres ocultos ou espaços em branco do endereço de e-mail e tente novamente.
EmailComplaint	O destinatário marcou anteriormente uma mensagem sua como spam.	Remova este destinatário de envios futuros para proteger sua reputação de remetente.
EmailIsBounced	A mensagem não foi enviada porque este endereço de e-mail já sofreu uma rejeição (bounce).	Use um endereço de e-mail válido e ativo ou remova este destinatário da sua lista de e-mails.
IllegalEmailAddress	O endereço de e-mail do destinatário tem um formato inválido.	Verifique o endereço de e-mail do destinatário e corrija-o.
UnableToParseEmailBCC	O campo Cco (BCC) contém um valor inválido.	Verifique o formato dos endereços no campo Cco.

Erros de entrega SMTP

Esses erros ocorrem enquanto o Pushwoosh entrega a mensagem por SMTP, desde uma configuração ausente até uma falha na conexão.

Erro	Descrição	O que fazer
SMTPCannotProcessData	O Pushwoosh não conseguiu construir o e-mail para entrega SMTP.	Verifique as configurações do modelo de e-mail.
SMTPCannotProcessFrom	O campo “FROM” do SMTP está vazio.	Defina um endereço de e-mail “De” válido para a mensagem.
SMTPCannotProcessRcpt	O campo “RCPT” (destinatário) do SMTP está vazio.	Verifique se o endereço de e-mail do destinatário está definido corretamente.
SMTPCannotProcessSending	Ocorreu um erro interno ao enviar a mensagem via SMTP.	Tente enviar a mensagem novamente mais tarde. Se o erro persistir, entre em contato com o Suporte da Pushwoosh.
SMTPIsNotConfigured	O SMTP não foi configurado para esta conta.	Entre em contato com o Suporte da Pushwoosh para configurar o envio por SMTP.
SMTPProviderBlocked (1138)	O Pushwoosh pausou o envio para o provedor de e-mail deste destinatário a partir da sua conta após muitas rejeições e erros em um curto período.	Aguarde a retomada do envio ou entre em contato com o Suporte da Pushwoosh se o problema persistir.
SMTPUnableToCreateConnection	O Pushwoosh não conseguiu estabelecer uma conexão SMTP.	Verifique as configurações e credenciais do seu servidor SMTP e tente novamente.
SMTPUnableToSignDKIM	O Pushwoosh não conseguiu assinar a mensagem com DKIM.	Verifique a configuração DKIM do seu domínio de envio.
SMTPUnknownError	Ocorreu um erro SMTP não especificado.	Tente enviar a mensagem novamente. Se o erro persistir, entre em contato com o Suporte da Pushwoosh.
SMTPUnknownProvider (1139)	O Pushwoosh não conseguiu determinar o provedor de e-mail para o endereço do destinatário.	Verifique se o endereço de e-mail do destinatário está formatado corretamente ou entre em contato com o Suporte da Pushwoosh se o endereço parecer correto.

Erros de modelo e conteúdo

Esses erros ocorrem enquanto o Pushwoosh constrói ou renderiza o e-mail — um modelo ausente, dados de placeholder inválidos ou HTML malformado.

Erro	Descrição	O que fazer
CannotGetEmailPlaceholders	O Pushwoosh não conseguiu buscar os placeholders usados no modelo de e-mail.	Verifique os placeholders de Conteúdo Dinâmico (Dynamic Content) no modelo de e-mail.
CannotGetTemplateBindings	O Pushwoosh não conseguiu buscar as vinculações de dados necessárias para renderizar o modelo.	Verifique as configurações de Conteúdo Dinâmico (Dynamic Content) e Modelos Liquid (Liquid Templates) usadas no modelo.
CannotNormalizeHTML	O conteúdo do e-mail não pôde ser preparado para o envio.	Verifique se há erros no conteúdo HTML do modelo de e-mail.
CannotProcessEmailTemplateFromRepo	O modelo de e-mail não pôde ser carregado e processado.	Verifique as configurações do modelo de e-mail e tente novamente.
EmailCannotGetEmailTemplateCode	Falha ao obter email_template_code ou ele está vazio.	Verifique se a plataforma está configurada corretamente e tente novamente.
EmailCannotGetEmailTemplateFromRepo	Falha ao obter o modelo de e-mail por email_template_code.	Verifique se a plataforma está configurada corretamente e tente novamente.
InvalidRenderingParameterException	Um dos valores usados para preencher o modelo é inválido, muitas vezes devido a JSON malformado.	Verifique os dados de Conteúdo Dinâmico (Dynamic Content) passados para o modelo.
InvalidTemplateException	O modelo de e-mail especificado não pôde ser renderizado.	Verifique se há erros no modelo de e-mail e tente novamente.
MissingRenderingAttributeException	Um valor referenciado por um placeholder no modelo não foi fornecido.	Certifique-se de que todos os placeholders usados no modelo tenham valores correspondentes.
TemplateDoesNotExistException	O modelo de e-mail especificado não existe.	Verifique se o modelo de e-mail está configurado corretamente e não foi excluído.
TooDeepTemplateInsertion	Os modelos estão aninhados muito profundamente uns nos outros.	Reduza o número de inserções de modelos aninhados no conteúdo do e-mail.
UnableToBuildEmailAttachments	Um ou mais anexos não puderam ser construídos.	Verifique os anexos adicionados ao e-mail e tente novamente.
UnableToBuildHTML	Falha ao compilar o modelo de e-mail. Provavelmente, o modelo contém um erro relacionado a placeholders de Conteúdo Dinâmico (Dynamic Content) ou Modelos Liquid (Liquid Templates).	Verifique as configurações do modelo de e-mail.
UnableToCreateHTML	O Pushwoosh não conseguiu gerar o HTML final para o e-mail.	Verifique as configurações do modelo de e-mail.
UnableToInsertTemplate	O Pushwoosh não conseguiu inserir um modelo referenciado no e-mail.	Verifique a referência do modelo inserido/aninhado no conteúdo do e-mail.
UnableToMinifyHTML	O Pushwoosh não conseguiu minificar o conteúdo HTML do e-mail.	Verifique o HTML do modelo de e-mail em busca de marcação malformada.

Modelos Liquid e Conteúdo Conectado (Connected Content)

Esses erros são específicos da sintaxe Liquid e das solicitações de Conteúdo Conectado (Connected Content) usadas para buscar dados personalizados.

Erro	Descrição	O que fazer
ConnectedContentInvalidJSON	O endpoint de Conteúdo Conectado (Connected Content) retornou um JSON inválido.	Verifique se seu backend retorna um JSON válido para a solicitação de Conteúdo Conectado (Connected Content).
ConnectedContentInvalidParameters	O número de parâmetros passados para o Conteúdo Conectado (Connected Content) não corresponde ao modelo.	Verifique os parâmetros passados na tag de Conteúdo Conectado (Connected Content) em relação ao seu modelo.
ConnectedContentInvalidTemplate	A tag de Conteúdo Conectado (Connected Content) contém um modelo Liquid inválido.	Verifique a sintaxe Liquid usada dentro da tag de Conteúdo Conectado (Connected Content).
ConnectedContentInvalidURL	O Pushwoosh não conseguiu buscar a URL especificada no Conteúdo Conectado (Connected Content).	Verifique se a URL do Conteúdo Conectado (Connected Content) está correta e acessível.
ConnectedContentInvalidVarExpression	A expressão ${} usada no Conteúdo Conectado (Connected Content) é inválida.	Verifique a sintaxe ${} usada na tag de Conteúdo Conectado (Connected Content).
InvalidLiquidTemplate	O e-mail contém um modelo Liquid inválido.	Verifique a sintaxe dos Modelos Liquid (Liquid Templates) usada no e-mail.
LiquidTemplateInvalidParsing	O modelo Liquid não pôde ser analisado devido a um erro de sintaxe.	Verifique a sintaxe dos Modelos Liquid (Liquid Templates) usada no e-mail.
LiquidTemplateInvalidRendering	O modelo Liquid não pôde ser renderizado com os dados disponíveis.	Verifique se as variáveis usadas nos Modelos Liquid (Liquid Templates) correspondem aos dados disponíveis para o destinatário.
LiquidTemplateInvalidTimezone	Um fuso horário inválido foi usado com um filtro de data no modelo Liquid.	Verifique o valor do fuso horário usado com o filtro de data em seus Modelos Liquid (Liquid Templates).

Erros de entrega e infraestrutura

Esses erros vêm da própria infraestrutura de envio de e-mail. A maioria é transitória ou interna, e vários exigem que o Suporte da Pushwoosh investigue.

Erro	Descrição	O que fazer
CannotConnect	O Pushwoosh não conseguiu se conectar ao gateway de envio de e-mail.	Tente enviar a mensagem novamente mais tarde. Se o erro persistir, entre em contato com o Suporte da Pushwoosh.
CannotGetDeviceAPIURL	O Pushwoosh não conseguiu determinar a URL da API necessária para enviar o e-mail.	Entre em contato com o Suporte da Pushwoosh.
CannotSend	O e-mail não pôde ser enviado.	Tente enviar a mensagem novamente mais tarde. Se o erro persistir, entre em contato com o Suporte da Pushwoosh.
EmailSESInvalidParameterValue	Um dos parâmetros passados para a Amazon está incorreto.	Verifique os parâmetros passados e tente novamente.
Failed	A mensagem não pôde ser enviada por um motivo interno.	Tente enviar a mensagem novamente. Se o erro persistir, entre em contato com o Suporte da Pushwoosh.
MessageRejected	A Amazon rejeitou a mensagem e ela não foi enviada.	Verifique o conteúdo da mensagem e o endereço do destinatário e tente novamente.
RequestTimeout	A solicitação para o serviço de envio de e-mail expirou.	Tente enviar a mensagem novamente mais tarde.
SpamDetected	A mensagem foi marcada como spam e não foi enviada.	Revise seu conteúdo em busca de características semelhantes a spam e entre em contato com o Suporte da Pushwoosh se acreditar que isso é um erro.
TransientFailure	Ocorreu uma falha temporária do lado da Amazon ao enviar a mensagem.	Tente enviar a mensagem novamente mais tarde.
UnableToUnmarshalMetaData	O Pushwoosh não conseguiu processar os metadados anexados ao e-mail.	Entre em contato com o Suporte da Pushwoosh com o ID da mensagem.
UnknownError	Ocorreu um erro de envio não especificado.	Entre em contato com o Suporte da Pushwoosh com o ID da mensagem para investigação.

Erros de configuração do Amazon SES

Esses erros vêm da infraestrutura interna de envio do Amazon SES do Pushwoosh, não do conteúdo da sua mensagem ou das configurações da sua conta.

Erro	Descrição	O que fazer
Erros de configuração do 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	Um erro interno na infraestrutura de envio do Amazon SES do Pushwoosh. Isso não é causado pelo conteúdo da sua mensagem ou pelas configurações da sua conta.	Entre em contato com o Suporte da Pushwoosh com o nome exato do erro e a hora em que a mensagem foi enviada.