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.

Conta e limites de envio

Esses erros significam que sua conta ou conjunto de configuração 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ção, geralmente devido a uma alta taxa de bounce ou reclamações.	Revise suas taxas de bounce e reclamações 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.
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 aberturas/cliques é 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 bounces 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 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 de 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.
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.

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 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 e Modelos Liquid usadas no modelo.
CannotNormalizeHTML	O conteúdo do e-mail não pôde ser preparado para o envio.	Verifique o conteúdo HTML do modelo de e-mail em busca de erros.
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 passados para o modelo.
InvalidTemplateException	O modelo de e-mail especificado não pôde ser renderizado.	Verifique o modelo de e-mail em busca de erros 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 ou Modelos Liquid.	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

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

Erro	Descrição	O que fazer
ConnectedContentInvalidJSON	O endpoint de Conteúdo Conectado retornou um JSON inválido.	Verifique se o seu backend retorna um JSON válido para a solicitação de Conteúdo Conectado.
ConnectedContentInvalidParameters	O número de parâmetros passados para o Conteúdo Conectado não corresponde ao modelo.	Verifique os parâmetros passados na tag de Conteúdo Conectado em relação ao seu modelo.
ConnectedContentInvalidTemplate	A tag de Conteúdo Conectado contém um modelo Liquid inválido.	Verifique a sintaxe Liquid usada dentro da tag de Conteúdo Conectado.
ConnectedContentInvalidURL	O Pushwoosh não conseguiu buscar a URL especificada no Conteúdo Conectado.	Verifique se a URL do Conteúdo Conectado está correta e acessível.
ConnectedContentInvalidVarExpression	A expressão ${} usada no Conteúdo Conectado é inválida.	Verifique a sintaxe ${} usada na tag de Conteúdo Conectado.
InvalidLiquidTemplate	O e-mail contém um modelo Liquid inválido.	Verifique a sintaxe dos Modelos Liquid 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 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 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.

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 da 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 da 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.