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 bounces 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 apontam para 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 que ainda estejam 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 que ainda estejam 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” para o 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 para o 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 suas configurações de 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 template.

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 um 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 acontecem enquanto o Pushwoosh entrega a mensagem via 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 template 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 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 do DKIM para o 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 template e conteúdo

Esses erros ocorrem enquanto o Pushwoosh constrói ou renderiza o e-mail — um template 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 template de e-mail.	Verifique os placeholders de Conteúdo Dinâmico no template de e-mail.
CannotGetTemplateBindings	O Pushwoosh não conseguiu buscar as vinculações de dados necessárias para renderizar o template.	Verifique as configurações de Conteúdo Dinâmico e Templates Liquid usadas no template.
CannotNormalizeHTML	O conteúdo do e-mail não pôde ser preparado para o envio.	Verifique o conteúdo HTML do template de e-mail em busca de erros.
CannotProcessEmailTemplateFromRepo	O template de e-mail não pôde ser carregado e processado.	Verifique as configurações do template 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 template 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 template é inválido, muitas vezes devido a JSON malformado.	Verifique os dados de Conteúdo Dinâmico passados para o template.
InvalidTemplateException	O template de e-mail especificado não pôde ser renderizado.	Verifique o template de e-mail em busca de erros e tente novamente.
MissingRenderingAttributeException	Um valor referenciado por um placeholder no template não foi fornecido.	Certifique-se de que todos os placeholders usados no template tenham valores correspondentes.
TemplateDoesNotExistException	O template de e-mail especificado não existe.	Verifique se o template de e-mail está configurado corretamente e não foi excluído.
TooDeepTemplateInsertion	Os templates estão aninhados muito profundamente uns nos outros.	Reduza o número de inserções de templates 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 template de e-mail. Provavelmente, o template contém um erro relacionado a placeholders de Conteúdo Dinâmico ou Templates Liquid.	Verifique as configurações do template de e-mail.
UnableToCreateHTML	O Pushwoosh não conseguiu gerar o HTML final para o e-mail.	Verifique as configurações do template de e-mail.
UnableToInsertTemplate	O Pushwoosh não conseguiu inserir um template referenciado no e-mail.	Verifique a referência do template 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 template de e-mail em busca de marcação malformada.

Templates Liquid e Conteúdo Conectado

Esses erros são específicos da sintaxe Liquid e das solicitações de Conteúdo Conectado usadas para buscar 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 template.	Verifique os parâmetros passados na tag de Conteúdo Conectado em relação ao seu template.
ConnectedContentInvalidTemplate	A tag de Conteúdo Conectado contém um template 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 template Liquid inválido.	Verifique a sintaxe dos Templates Liquid usada no e-mail.
LiquidTemplateInvalidParsing	O template Liquid não pôde ser analisado devido a um erro de sintaxe.	Verifique a sintaxe dos Templates Liquid usada no e-mail.
LiquidTemplateInvalidRendering	O template Liquid não pôde ser renderizado com os dados disponíveis.	Verifique se as variáveis usadas nos Templates 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 template Liquid.	Verifique o valor do fuso horário usado com o filtro de data em seus Templates 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, depois 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.