Quando você realiza campanhas de email ou sincroniza contatos entre seu app e um ESP, você precisa de uma regra clara: quem está autorizado a receber emails e quem deve ser excluído. verify-email.app não substitui o link de cancelamento de assinatura do seu ESP ou conformidade legal, mas fornece a você regras de lista negra e lista branca que aparecem em cada resposta de verificação como um único campo: block. Seu código pode ler block antes de enviar, importar uma lista, ou criar uma conta—sem precisar copiar a lógica de permitir/negar para cada serviço.

• Lista Negra — Se o email ou seu domínio estiver na sua lista negra, a API retorna block: true. Use isso para pessoas que optaram por sair, casos de abuso, ou domínios que você nunca quer enviar emails.

• Lista Branca — Quando o modo de lista branca está ativo, apenas endereços (ou domínios inteiros) que você adicionou à lista branca recebem block: false. Todos os outros recebem block: true. Use isso para listas fechadas—parceiros, convites, betas internos—não para uma newsletter normal de “qualquer um pode se inscrever”.

• Ordem — A lista negra prevalece. Se um endereço está na lista negra, continua bloqueado mesmo se também aparecer na lista branca.

1. Quando um usuário cancela a inscrição no seu app ou você processa um webhook do ESP, pegue o endereço dele (ou o domínio que você bloqueia por política).

2. Adicione-o com POST /v1/blacklist e corpo JSON {"value": "[email protected]"} (ou "example.com" para bloquear todos os endereços nesse domínio). Use o cabeçalho X-API-Key com sua chave de API.

3. Antes de enviar uma campanha ou enviar uma linha para sua ferramenta de mailing, verifique o endereço. Se block é verdadeiro, pule esse destinatário.

Para permitir novamente mais tarde (por exemplo, eles se reinscreveram e confirmaram), remova a regra com DELETE /v1/[email protected].

1. Ative o modo estrito de permitir apenas: PUT /v1/whitelist/enabled com o corpo {"enabled": true}.

2. Adicione cada endereço ou domínio aprovado: POST /v1/whitelist com {"value": "[email protected]"} ou {"value": "company.com"}.

3. Ao verificar, block: false significa que o endereço é permitido sob sua lista branca; outros são bloqueados até que você os adicione.

Quando você não precisar do modo de permitir apenas (por exemplo, retorno de inscrições públicas), defina enabled como false para que a lista branca pare de restringir todos os outros.

A maioria dos produtos armazena consentimento no ESP e mantém uma lista de supressão lá. No verify-email.app você geralmente remove o endereço da lista negra se eles tinham cancelado a inscrição antes (DELETE na lista negra), então confia no seu ESP para o estado real da inscrição. Reserve a lista branca para fluxos onde apenas emails pré-aprovados podem passar.

Você pode gerenciar as mesmas regras no painel, bem como via API—veja as páginas de Lista Negra e Lista Branca no verify-email.app para contexto e detalhes da API.