---
title: Verificação
description: Verificações básicas grátis em todo endereço e verificação completa paga dos seus contatos antes de enviar.
ai:
  exclude: true
---

A verificação mantém o e-mail longe de endereços que vão dar bounce, o que protege sua [entregabilidade](/docs/pt-br/concepts/deliverability-insights). Há dois níveis.

## Verificações básicas (grátis, todos os planos)

O BillionSend confere o domínio do destinatário sempre que um e-mail é aceito e sempre que um contato é criado ou importado. Ele recusa um endereço quando:

- o domínio é um nome reservado ou de documentação (`.test`, `.invalid`, `example.com` e semelhantes) ou não é um domínio de topo real,
- o domínio não tem servidor de e-mail: não existe ou não publica registro MX (ou publica um MX nulo),
- o domínio pertence a um serviço de e-mail descartável.

Um envio ou contato recusado retorna `422 validation_error` com uma mensagem como `x@example.com can never receive mail: …`. Em uma importação em lote, essas linhas são ignoradas. Nada é cobrado. Para testar o envio sem escrever para ninguém, use `success@simulator.amazonses.com`.

## Verificação completa (planos pagos)

A verificação completa confere se cada caixa de correio existe, sem enviar nada a ela. Custa **US$ 0,40 por 1.000 endereços**, vem na fatura mensal (nada a pagar antes) e está disponível nos planos Starter, Pro e Scale. No Free, os botões Verificar ficam desativados e valem só as verificações básicas.

Ela funciona apenas com os contatos da sua equipe. Se a sua equipe tem crédito grátis de verificação, ele é usado antes de qualquer cobrança.

### Iniciar uma verificação

No painel, você pode iniciá-la a partir de:

- **Contatos → Contatos**: selecione contatos e aperte **Verificar**.
- A página de um **segmento**: aperte **Verificar** para checar todos os membros.
- A **janela de importação**: marque **Verificar após importar** para checar os contatos novos.
- O painel **"Antes de enviar" de uma transmissão**: ele mostra quantos destinatários nunca foram verificados e oferece **Verificar agora**.

Antes de começar, a janela mostra quantos endereços serão checados e quanto custam. Proprietários, administradores e membros de marketing podem iniciá-la. Veja [Funções da equipe](/docs/pt-br/team-roles).

### Resultados

Cada contato recebe um veredito, mostrado na coluna **Verificação** e na página do contato:

| Veredito | Significado |
| --- | --- |
| `valid` | A caixa de correio existe. |
| `invalid` | A caixa de correio não existe. |
| `risky` | Pode dar bounce. |
| `catchall` | O domínio aceita qualquer endereço, então a caixa não pode ser confirmada. |
| `role` | Um endereço compartilhado, como `info@` ou `support@`. |
| `disposable` | Uma caixa descartável. |
| `unknown` | Não foi possível obter resposta. |

Um endereço `invalid` entra automaticamente na sua [lista de supressão](/docs/pt-br/concepts/suppressions), então nenhum e-mail chega a ele. Os outros vereditos apenas marcam o contato; ele continua na lista e continua recebendo e-mail.

### O que é cobrado

- Você paga só por resultados: endereços que terminam `unknown` não são cobrados, e uma execução que falha não é cobrada.
- Um contato que já tem resultado é pulado, e também o que está sendo verificado em outra execução. Nenhum endereço é cobrado duas vezes.
- Configurações → Cobrança e uso mostra os endereços verificados e o custo do mês, e suas execuções recentes.

### Limites

| | |
| --- | --- |
| Contatos por início | 500.000. Para uma lista maior, verifique por segmento, em partes. |
| Contatos por execução | 50.000. Um início maior é dividido em várias execuções. |
| Tempo de uma execução | 12 horas. Uma execução que não termina até lá falha. |

### API

Tudo o que o painel faz também está na API. Um alvo é `{ "kind": "contacts", "contact_ids": [...] }`, `{ "kind": "segment", "segment_id": "..." }` ou `{ "kind": "broadcast", "broadcast_id": "..." }`.

| Requisição | O que faz |
| --- | --- |
| `GET /verifications/availability` | Se a sua equipe pode iniciar a verificação completa e o preço por 1.000 endereços. |
| `POST /verifications/estimate` | Quantos contatos de um alvo nunca foram verificados e quanto custa verificá-los. Não altera nada. |
| `POST /verifications` | Inicia a verificação de um alvo. Adicione `"recheck": true` para verificar também contatos já verificados. |
| `GET /verifications` | Suas execuções, das mais recentes para as mais antigas, com status e resultados. |
| `GET /verifications/{id}` | Uma execução. |

```bash
curl -X POST https://api.billionsend.com/verifications \
  -H "Authorization: Bearer bs_..." \
  -H "Content-Type: application/json" \
  -d '{ "target": { "kind": "segment", "segment_id": "seg_id" } }'
```

O resultado de cada contato fica no próprio contato: `GET /contacts/{id}` e `GET /contacts` retornam `verification_status` (`valid`, `invalid`, `risky`, `catchall`, `role`, `disposable` ou `unknown`) e `verified_at`, ambos `null` até o contato ser verificado. `GET /usage` mostra os endereços verificados e o custo do mês em `verification`. Iniciar uma execução exige uma chave com acesso total; no plano Free a resposta é `403 plan_limit_reached`. O servidor MCP tem as mesmas cinco ações (veja [MCP](/docs/pt-br/mcp)).
