Como funcionam as supressões
Porque um endereço deixa de receber, que listas existem, e o que reactivar faz mesmo.
Uma supressão é um endereço para o qual deixamos de enviar. O pedido é recusado
antes de sair, com 422, e não conta para a tua quota.
Duas listas, e só uma é tua
A lista da conta. Endereços suprimidos para ti, e só para ti. Entram automaticamente quando uma mensagem devolve em definitivo, ou à mão, por ti. Podes tirar de lá o que quiseres.
A lista da plataforma. Endereços suprimidos para todos os clientes. Só lá entram devoluções permanentes e queixas de spam, e não podes tirá-los de lá.
A segunda existe porque a reputação dos IPs é partilhada. Um endereço que não existe continua a não existir para o cliente seguinte, e cada tentativa custa reputação a toda a gente que envia por aquele IP. Deixar um cliente gastar essa reputação não é uma decisão que lhe pertença.
No painel, uma linha bloqueada na plataforma diz Bloqueado na plataforma em vez de oferecer um botão que não faria nada.
Porque entram
| Motivo | De onde vem | Em que lista |
|---|---|---|
| Hard bounce | O destino recusou em definitivo | Conta e plataforma |
| Reclamação | A pessoa marcou como spam | Conta e plataforma |
| Cancelou subscrição | O destinatário carregou em cancelar | Conta |
| Manual | Tu, no painel ou pela API | Conta |
Os dois primeiros são reportados por terceiros, e é por isso que a API não deixa escrevê-los: uma devolução que tu próprio inventasses entraria no registo que serve para avaliar o teu envio.

Suprimir à mão
No painel, em Supressões, botão Suprimir endereço. Ou:
curl -X POST https://app.c-connect.pt/v1/suppressions \
-H "Authorization: Bearer $CCONNECT_KEY" \
-H "Content-Type: application/json" \
-d '{
"address": "alguem@example.org",
"reason": "unsubscribe",
"detail": "Pediu por telefone"
}'
Os motivos que podes escrever são manual e unsubscribe.
O que reactivar faz
Tira o endereço da tua lista, e mais nada.
Se ele também estiver na lista da plataforma, continua bloqueado, e a resposta
diz-to: still_globally_suppressed: true. Não é uma falha do pedido, é a outra
lista a manter-se.
Vale a pena pensar duas vezes antes de reactivar um hard bounce. O endereço foi suprimido porque o destino disse que não existe; a próxima mensagem devolve outra vez, e a devolução conta contra ti.
Reactivar faz sentido quando:
- a pessoa mudou de emprego e a caixa voltou a existir;
- houve um problema temporário mal classificado, o que é raro;
- suprimiste à mão por engano.
O que deves fazer do teu lado
Uma supressão aqui não limpa a tua base de dados. Quando um endereço devolve, marca-o também no teu sistema:
- para não voltares a tentar por outro canal;
- para não pagares por um contacto que não existe;
- para que quem olhar para a ficha perceba porque é que não há emails lá.
Se preferires não ir buscar um a um, os eventos bounced e complained chegam
pelos webhooks no momento em que acontecem.