C C-Connect Documentação

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.

A lista de supressões desta conta, com o motivo de cada endereço.
A lista de supressões desta conta, com o motivo de cada endereço.

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.