Email

Opções de entrega

O que acontece quando um email não pode ser entregue na hora, e como mudar isso por email: por quanto tempo continuamos tentando e se devemos enviar para um endereço que já deu hard bounce.

i

Todas as opções são opcionais. Sem elas, cada email segue os padrões abaixo. Elas vão no body de Enviar email, ou como headers quando você envia por SMTP.

Como funcionam as retentativas

Uma rejeição permanente, como um endereço que não existe, é definitiva e não é retentada. Estes casos são retentados por você:

Greylisting

O servidor de destino responde "tente novamente mais tarde" para um remetente que ele nunca viu.

Tentamos de novo pelo mesmo IP após 5, 10, 20, 40, 60 e 60 minutos (cerca de 3 horas no total).

Automático

Erros temporários

Uma resposta 4xx, conexões demais ou uma conexão que cai no meio do envio.

Tentamos de novo algumas vezes com uma pausa entre as tentativas. Quantas vezes e quanto esperar depende do erro, a menos que você defina.

Altere comretryUnavailable · retryUnavailableSeconds

Servidor de destino fora do ar

O servidor de email do destinatário não aceita nenhuma conexão.

Esperamos ele voltar sem gastar suas retentativas. Se ainda estiver fora do ar após 24 horas, o email é marcado como bounced.

Automático

Rate limit

O provedor de email (Outlook, Yahoo, AOL…) pede para diminuirmos o ritmo.

O email espera e é tentado de novo a cada 30 minutos, possivelmente por outro IP. Por padrão continuamos tentando por 25 ciclos (cerca de 12 horas).

Altere comretryRateLimited

Opções de retentativa

Você define o limite, nós definimos o teto. Um valor fora do intervalo é ajustado para o valor permitido mais próximo, e a resposta avisa em warnings. Os nomes dos campos não diferenciam maiúsculas de minúsculas: retryRateLimited e retry_rate_limited são o mesmo.

  • retryRateLimitedintegeropcional

    Quantos ciclos de rate limit de 30 minutos esperar antes de desistir. 0 desiste no primeiro rate limit. Use um valor baixo para emails urgentes, como códigos de login.

    Intervalo 0 – 24Padrão 25 ciclosSMTP X-Sendcorex-Retry-Rate-Limited
  • retryUnavailableintegeropcional

    Quantas vezes tentar de novo após um erro temporário. 0 falha no primeiro.

    Intervalo 0 – 30Padrão Depende do erro (até 10)SMTP X-Sendcorex-Retry-Unavailable
  • retryUnavailableSecondsintegeropcional

    Quantos segundos esperar entre essas tentativas.

    Intervalo 10 – 3600Padrão Depende do erroSMTP X-Sendcorex-Retry-Unavailable-Seconds
  • ignoreHardBouncebooleanopcional

    Envia mesmo que o endereço tenha dado hard bounce nos últimos 90 dias. Uma tentativa por endereço, e a opção é desativada por 7 dias após 3 falhas em 24 horas. Veja Hard bounces conhecidos abaixo.

    Intervalo true · falsePadrão falseSMTP X-Sendcorex-Ignore-Hard-Bounce

Hard bounces conhecidos

Quando um endereço dá hard bounce (a caixa de email não existe), nós o lembramos por 90 dias. Enviar para ele de novo só prejudicaria sua reputação de remetente, então não nos conectamos de novo ao servidor de destino:

Sem o Hard Bounce Shield

Marcado como bounced

O email não é enviado e é registrado como bounce. Ele conta na sua taxa de bounce.

Com o Hard Bounce Shield

Suprimido

O email não é enviado e é registrado como Suppressed. Ele usa um crédito, mas não conta como bounce. Você ainda recebe o webhook bounced, com suppressed: true, para que todo email termine com um evento final.

Caixa de email cheia

Uma caixa cheia é um erro temporário, então o endereço não é lembrado na primeira vez. Se o mesmo endereço voltar como cheio em 3 emails seguidos, sem nenhuma entrega entre eles e com menos de 30 dias entre um e outro, passamos a tratá-lo como hard bounce. Uma entrega bem-sucedida zera a contagem.

Enviar mesmo assim

Se você sabe que a caixa de email existe agora (o destinatário corrigiu, ou foi um problema temporário do lado dele), defina ignoreHardBounce: true. O email é enviado normalmente. Se for entregue, o endereço sai da lista e você não precisa mais da opção para ele.

Limites

A opção significa "esta caixa de email existe agora". Quando isso se revela falso, ela para de funcionar:

  • Uma tentativa por endereço

    Se o email der hard bounce de novo, ele conta como bounce, o endereço é lembrado por mais 90 dias e a opção é ignorada para esse endereço até lá.

  • 3 falhas em 24 horas

    Se 3 emails enviados com a opção derem hard bounce de novo, cada um a menos de 24 horas do anterior, a opção é desativada na sua conta por 7 dias. Seus emails continuam saindo; os hard bounces conhecidos só são pulados como de costume.

Quando a opção foi ignorada, o motivo começa com ignore_hard_bounce revoked: e diz por quê.

!

Use por email, não como padrão. Os provedores de email observam com que frequência você envia para endereços que não existem. Ativá-la em todo envio remove a proteção.

Escolha o IP de envio

Com IPs dedicados, escolhemos qual dos seus IPs envia cada email usando as configurações da sua página de IPs. Para decidir você mesmo, defina sendingIp como um dos seus IPs dedicados. O email sai só desse IP, da primeira tentativa até a última retentativa.

  • sendingIpstringopcional

    Um endereço IPv4 ou IPv6 que seja um dos seus IPs dedicados e esteja ativo. Qualquer outro valor rejeita o email.

    Padrão Escolhido pelas suas configurações de IPSMTP X-Sendcorex-Sending-IPMCP sending_ip
{
  "to": "customer@example.com",
  "from": "billing@yourdomain.com",
  "senderName": "My App",
  "subject": "Your invoice",
  "body": "<p>Your invoice is ready.</p>",
  "sendingIp": "203.0.113.10"
}

O que ele substitui

Estas configurações da sua página de IPs não se aplicam a um email enviado com sendingIp. Emails sem ele continuam seguindo-as.

  • Qual IP envia

    Normalmente alternamos entre seus IPs dedicados. O email sai pelo IP que você escolheu.

  • Roteamento IPv4 e IPv6

    A divisão IPv4/IPv6 das suas configurações de roteamento é ignorada. Um endereço IPv6 envia por IPv6, um endereço IPv4 por IPv4.

  • Failover com rate limit

    Normalmente retentamos por outro dos seus IPs dedicados. O email espera no IP que você escolheu.

  • Blacklist Guard

    Se o IP entrar em uma blacklist, o email não é movido para um IP compartilhado. Ele espera no IP que você escolheu.

  • Emails agendados

    O IP é salvo com o email e usado quando ele sai, mesmo que suas configurações de IP mudem nesse meio-tempo.

Erros

  • API

    400 INVALID_SENDING_IP O valor não é um endereço IP, ou não é um dos seus IPs dedicados ativos. O email não entra na fila.

  • SMTP

    550 5.7.1 A mesma verificação no header X-Sendcorex-Sending-IP. A mensagem é rejeitada no fim do DATA.

  • MCP

    INVALID_SENDING_IP A mesma verificação no argumento sending_ip de email_send.

!

Um IP fixo espera em vez de trocar.Se o provedor desacelerar esse IP ou ele entrar em uma blacklist, o email espera no mesmo IP até sair ou as retentativas acabarem. Para emails que não podem esperar, deixe sendingIp de fora e deixe que a gente escolha.

Exemplo

Um código de login fica inútil depois de alguns minutos, então não o deixe esperando por horas.

import axios from 'axios';

const response = await axios.post(
  'https://mail.sendcorex.com/v3.0/send',
  {
    to: 'user@example.com',
    from: 'noreply@yourdomain.com',
    senderName: 'My App',
    subject: 'Your login code',
    body: '<p>Your code is <b>482913</b></p>',
    retryRateLimited: 4,         // give up after 4 rate-limit cycles (~2 h)
    retryUnavailable: 5,         // up to 5 retries on temporary errors
    retryUnavailableSeconds: 30, // 30 s between them
    ignoreHardBounce: true,      // send even if this address hard bounced before
  },
  {
    headers: { Authorization: process.env.SENDCOREX_API_KEY },
  }
);

console.log(response.data.id, response.data.warnings);

Resposta com um valor ajustado

Aqui retryRateLimited foi enviado como 40. O email continua enfileirado, com 24.

200

Email enfileirado, com um aviso

{
  "success": true,
  "message": "Email queued successfully",
  "code": "EMAIL_QUEUED_SUCCESS",
  "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
  "ids": [
    { "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f", "recipient": "user@example.com" }
  ],
  "recipients": 1,
  "scheduledAt": null,
  "warnings": ["retry_rate_limited 40 → 24"]
}

Headers SMTP

Enviando por SMTP? Adicione as mesmas opções como headers. Nós as lemos e removemos antes de o email ser entregue, então o destinatário nunca as vê.

X-Sendcorex-Retry-Rate-Limited: 4
X-Sendcorex-Retry-Unavailable: 5
X-Sendcorex-Retry-Unavailable-Seconds: 30
X-Sendcorex-Ignore-Hard-Bounce: true
X-Sendcorex-Sending-IP: 203.0.113.10

Eventos de webhook

Acompanhe as retentativas em tempo real com estes eventos de webhook:

  • retrying

    Aconteceu um erro temporário e o email será tentado de novo. O reason diz qual é a tentativa.

  • failed

    Desistimos depois que as retentativas ou os ciclos de rate limit acabaram.

  • bounced

    O servidor de destino rejeitou o email de vez, ou ficou fora do ar por 24 horas. Também é enviado quando pulamos um hard bounce conhecido, com suppressed: true se você tem o Hard Bounce Shield.