Gerenciar supressões

Este guia cobre todas as tarefas da lista de supressão: encontrar entradas, adicioná-las uma a uma ou a partir de um arquivo CSV, exportar, removê-las e controlar a supressão automática. Para entender como as supressões funcionam, consulte Supressões.

Antes de começar

• Qualquer membro do workspace pode gerenciar a lista no painel. Alterar as configurações de supressão automática exige um administrador.
• Para a API, use uma chave de API com Full Access.

Ver e filtrar a lista

curl -G https://api.emailit.com/v2/suppressions \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  --data-urlencode "type.exact=complaint" \
  --data-urlencode "limit=100"

Adicionar uma supressão

curl https://api.emailit.com/v2/suppressions \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "ada@example.com",
    "type": "unsubscribe",
    "reason": "Opted out by phone",
    "keep_until": "2027-01-01T00:00:00Z"
  }'

Importar um arquivo CSV

Use uma importação para trazer uma lista de supressão de outro provedor ou para adicionar muitos endereços de uma vez.

1. Prepare o arquivo. Use um arquivo .csv com as colunas email, type e reason:

   suppressions.csv

   email,type,reason
   ada@example.com,bounce,Hard bounce at previous provider
   grace@example.com,unsubscribe,Unsubscribed in 2025
   alan@example.com,,Requested removal

   • email é obrigatório. type e reason são opcionais.
   • Um type vazio ou desconhecido vira recipient.
   • A linha de cabeçalho é opcional. Sem ela, o Emailit lê as colunas na ordem email, type, reason.
   • O arquivo precisa ter menos de 8 MB e no máximo 10.000 linhas.

2. Envie o arquivo. Em Email API›Suppressions, selecione Import e escolha o arquivo ou arraste-o para Select a file or drag it here.

3. Confira o resultado. O Emailit adiciona as entradas novas e ignora os endereços que já têm uma supressão do mesmo tipo. As linhas com endereços de e-mail inválidos são ignoradas.

Para mais de 10.000 endereços, divida o arquivo. Para importar a partir de código, chame Criar uma supressão para cada endereço.

Exportar a lista

1. Restrinja a lista. Se quiser, pesquise ou filtre a lista em Email API›Suppressions. A exportação inclui apenas o que está sendo mostrado.

2. Exporte. Selecione Export e depois Export no pop-over. O Emailit baixa o arquivo suppressions.csv.

O arquivo tem as colunas email, type, reason e created_at e contém até 10.000 linhas.

Excluir supressões

Excluir uma supressão permite que o Emailit volte a enviar para o endereço. Confirme que o endereço é válido e que a pessoa quer receber os seus e-mails, senão o próximo envio pode dar bounce ou gerar uma reclamação.

curl https://api.emailit.com/v2/suppressions/sup_4Lm8Qr2Tz6Wk \
  -X DELETE \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

Configurar a supressão automática

O Emailit adiciona automaticamente à lista os endereços que dão bounce ou reclamam. No Pro e no Business, os administradores podem alterar isso.

1. Abra as configurações. Acesse Workspace›Settings e selecione a aba Suppressions.

2. Ative ou desative. Use Enable automatic suppression.

3. Escolha o que suprimir. Em Suppress on, escolha Bounces and Complaints (padrão), Bounces only ou Complaints only.

No Pay as you go e nos planos Custom, a supressão automática está sempre ativada para bounces e reclamações. Os controles mostram um selo Pro e não podem ser alterados. Os membros que não são administradores podem ver as configurações, mas não alterá-las. Consulte Bounces e reclamações para saber exatamente quando o Emailit suprime um endereço.

Tentar enviar de novo e-mails suprimidos

Uma mensagem bloqueada por uma supressão continua suppressed mesmo depois que você exclui a supressão. Para enviá-la:

1. Exclua a supressão do endereço, como descrito acima. Caso contrário, a nova tentativa é suprimida de novo.

2. Tente enviar o e-mail de novo. Abra-o em Email API›Emails e selecione Retry ou chame Tentar enviar um e-mail de novo.

Uma nova tentativa cria um novo e-mail com o mesmo conteúdo e um novo ID e custa créditos como qualquer outro envio. Você pode tentar enviar de novo e-mails com até 30 dias, desde que o conteúdo deles ainda esteja dentro do seu período de retenção de dados.

Veja também