Pular para o conteúdo
Esc
↑↓navegar↵abrir⌘Jpré-visualizar
Nesta página

Supressões

A lista de endereços que o BillionSend não vai mais escrever, para proteger a reputação do seu remetente.

A lista de supressão guarda endereços que não devem receber e-mails, para você nunca enviar repetidamente a um endereço que deu bounce ou marcou você como spam. Ela protege sua reputação e seus limites de envio. No painel, fica em Público → Supressões.

Como os endereços entram na lista

  • Hard bounce. O servidor de destino recusou o endereço de forma permanente. Soft bounces não contam.
  • Reclamação. O destinatário marcou um e-mail como spam.
  • Endereço inválido. A verificação profunda da lista descobriu que nenhuma caixa responde ali.
  • Caixa cheia. A caixa de um contato informa estar cheia duas vezes, com 1 a 30 dias de intervalo.
  • Manual. Você adicionou, no painel ou pela API.

Bounces e reclamações são adicionados automaticamente. A lista é por equipe e tem uma entrada por endereço. Ela descreve o endereço, não uma marca: um endereço que não existe é o mesmo fato, qualquer que seja o seu domínio que escreva a ele.

Um destinatário que clica em descadastrar não entra aqui. Essa escolha é registrada como um descadastro do domínio cujo e-mail trazia o link, e só interrompe e-mails de marketing. A lista de supressão interrompe todos os e-mails ao endereço, inclusive os transacionais.

O que ela faz

  • Todo envio pula os destinatários suprimidos: POST /emails, o relay SMTP, envios com tópico e transmissões. Eles são removidos de to, cc e bcc.
  • Se todos os destinatários estão suprimidos, o envio é recusado com 422 all_recipients_suppressed. O relay SMTP responde 550. Quando isso esvazia um envio de POST /emails, o BillionSend guarda um registro com status suppressed e sem conteúdo, que não conta no seu volume, e envia o webhook email.suppressed.
  • E-mails que esperam são conferidos de novo quando saem, então um e-mail agendado pula endereços suprimidos nesse meio-tempo.
  • Transmissões pulam os contatos suprimidos.

Toda mudança na lista envia um webhook suppression.added ou suppression.removed.

Revisar e remover

O painel lista cada endereço com o motivo e a data. Os descadastros dos destinatários ficam em outra aba, cada um com seu domínio.

Você pode remover um endereço para voltar a enviar. Faça isso só quando souber que a causa foi resolvida, por exemplo uma caixa que sempre existiu mas foi recusada por um servidor mal configurado. O endereço volta a ser suprimido no próximo bounce ou reclamação.

API

Os SDKs chamam os endpoints /suppressions como suppressions.*. Cada entrada é { id, email, origin, source_id, created_at }. origin é bounce, complaint ou manual, e source_id é o e-mail cujo bounce ou reclamação criou a entrada.

curl -X POST https://api.billionsend.com/suppressions \
  -H "Authorization: Bearer $BILLIONSEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "email": "user@example.org" }'
  • GET /suppressions?origin=bounce lista as entradas, da mais nova à mais antiga, opcionalmente por origem.
  • GET /suppressions/{id} e DELETE /suppressions/{id} aceitam o id da entrada ou o endereço de e-mail.
  • POST /suppressions adiciona um endereço. O origin opcional (bounce, complaint ou manual, padrão manual) permite trazer o histórico de bounces e reclamações de outro provedor. Adicionar um endereço que já está na lista devolve a entrada existente.
  • POST /suppressions/batch/add com { "emails": [...] } e POST /suppressions/batch/remove com { "emails": [...] } ou { "ids": [...] } aceitam até 1.000 endereços por chamada.

Remover uma entrada exige uma chave criada por um proprietário ou administrador. Veja Funções da equipe.

Um endereço cujos dados pessoais você apagou continua bloqueando envios, mas fica oculto da lista e das buscas por e-mail. Ele continua acessível pelo id, que mostra "[erased]" como o e-mail.

Amazon SES e sua equipe

O Amazon SES mantém uma lista de supressão própria para a sua equipe, separada da de todas as outras: um bounce no seu e-mail nunca bloqueia o e-mail de outra equipe ao mesmo endereço. O SES adiciona bounces e reclamações a ela sozinho. Quando você remove um endereço aqui, ele é removido lá alguns segundos depois. Um envio que o SES recusa por causa da lista dele aparece como bounce permanente com o subtipo OnTenantSuppressionList.

Se suas taxas de bounce ou de reclamação subirem demais, o SES pode pausar sua equipe. Os proprietários recebem um e-mail com o motivo do SES, seus e-mails ficam retidos em vez de falhar, e saem quando o SES voltar a habilitar o envio. Veja Limites de envio.

Esta página foi útil?