Erros de e-mail
Esta página lista os códigos de erro que a 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
Anchor link toEsses 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 bounce ou de reclamações. | Revise suas taxas de bounce e de 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
Anchor link toEsses 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 | A 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” 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 a 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
Anchor link toEsses 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 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
Anchor link toEsses erros ocorrem enquanto a Pushwoosh entrega a mensagem via SMTP, desde uma configuração ausente até uma falha de conexão.
| Erro | Descrição | O que fazer |
|---|---|---|
| SMTPCannotProcessData | A 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 por SMTP. |
| SMTPUnableToCreateConnection | A Pushwoosh não conseguiu estabelecer uma conexão SMTP. | Verifique as configurações e credenciais do seu servidor SMTP e tente novamente. |
| SMTPUnableToSignDKIM | A Pushwoosh não conseguiu assinar a mensagem com DKIM. | Verifique a configuração 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
Anchor link toEsses erros ocorrem enquanto a 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 | A Pushwoosh não conseguiu buscar os placeholders usados no template de e-mail. | Verifique os placeholders de Dynamic Content no template de e-mail. |
| CannotGetTemplateBindings | A Pushwoosh não conseguiu buscar as vinculações de dados necessárias para renderizar o template. | Verifique as configurações de Dynamic Content e Liquid Templates 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 o 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 pelo 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 Dynamic Content 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 Dynamic Content ou Liquid Templates. | Verifique as configurações do template de e-mail. |
| UnableToCreateHTML | A Pushwoosh não conseguiu gerar o HTML final para o e-mail. | Verifique as configurações do template de e-mail. |
| UnableToInsertTemplate | A 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 | A 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. |
Liquid templates e Connected Content
Anchor link toEsses erros são específicos da sintaxe Liquid e das solicitações de Connected Content usadas para buscar dados personalizados.
| Erro | Descrição | O que fazer |
|---|---|---|
| ConnectedContentInvalidJSON | O endpoint de Connected Content retornou um JSON inválido. | Verifique se o seu backend retorna um JSON válido para a solicitação de Connected Content. |
| ConnectedContentInvalidParameters | O número de parâmetros passados para o Connected Content não corresponde ao template. | Verifique os parâmetros passados na tag de Connected Content em relação ao seu template. |
| ConnectedContentInvalidTemplate | A tag de Connected Content contém um template Liquid inválido. | Verifique a sintaxe Liquid usada dentro da tag de Connected Content. |
| ConnectedContentInvalidURL | A Pushwoosh não conseguiu buscar a URL especificada no Connected Content. | Verifique se a URL do Connected Content está correta e acessível. |
| ConnectedContentInvalidVarExpression | A expressão ${} usada no Connected Content é inválida. | Verifique a sintaxe ${} usada na tag de Connected Content. |
| InvalidLiquidTemplate | O e-mail contém um template Liquid inválido. | Verifique a sintaxe de Liquid Templates usada no e-mail. |
| LiquidTemplateInvalidParsing | O template Liquid não pôde ser analisado devido a um erro de sintaxe. | Verifique a sintaxe de Liquid Templates 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 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 template Liquid. | Verifique o valor do fuso horário usado com o filtro de data em seus Liquid Templates. |
Erros de entrega e infraestrutura
Anchor link toEsses 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 | A 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 | A 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 ao 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 | A 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
Anchor link toEsses erros vêm da infraestrutura de envio interna 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
| 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. |