Overview
Os domínios de envio da conta, com a pontuação.
GET /domains devolve os mesmos números da tela Gestão > Domínios (SMTP): a pontuação (reputation.score), a média de 7 dias (reputation.score_7d), a qualidade e o alcance.
⚠️ A pontuação de cada domínio é recalculada a cada 4 a 5 horas, e também na hora em que alguém usa Verificar agora na tela. reputation.evaluated_at diz quando foi o último cálculo: compare com o da consulta anterior para saber se o número mudou.
Qualidade: por qual grupo de IP o domínio envia
reputation.quality.value |
rótulo | |
|---|---|---|
entry |
Em formação | Domínio cadastrado há menos de 7 dias. A qualidade passa a ser calculada a partir do oitavo dia. |
perfect |
Excelente | Pontuação alta, sem reclamação de spam nem armadilha de spam em 30 dias. O envio usa o grupo de IPs compartilhados de melhor reputação. |
good |
Boa | Operação saudável. O envio usa IPs compartilhados de boa reputação. |
warning |
Atenção | A pontuação ou as reclamações de spam pedem atenção. O envio passa para IPs compartilhados de reputação inferior. |
poor |
Ruim | Risco de bloqueio pelos provedores de e-mail. O envio passa para o grupo de IPs compartilhados mais restrito. |
Alcance: quais destinos aceitam a mensagem
O alcance sai da pontuação: abaixo de 45 pontos nenhuma mensagem é enviada, e cada faixa acima libera um grupo de destinos.
reputation.reach.value |
rótulo | |
|---|---|---|
full |
Entrega sem restrição | Todos os destinos conhecidos recebem. |
broad |
Entrega quase total | Quase todos os destinos recebem. Bancos, órgãos do governo federal e grandes multinacionais não recebem. |
major_providers |
Entrega ampla | Os grandes provedores de e-mail recebem. Órgãos públicos, Vivo, Claro e TIM não recebem. |
mainstream |
Entrega parcial | O Gmail recebe. Hotmail, Outlook, Yahoo, UOL, Terra e iCloud não recebem. |
corporate |
Entrega restrita | Domínios corporativos terminados em .com.br recebem. Gmail, Hotmail, Outlook, Yahoo, UOL e Terra não recebem. |
unlisted_only |
Entrega muito restrita | Os grandes provedores de e-mail e os domínios corporativos não estão recebendo. Apenas destinos sem exigência própria de pontuação são atendidos. |
none |
Envio parado | Nenhuma mensagem está sendo enviada. Abaixo de 45 pontos o envio é interrompido antes da entrega, para qualquer destinatário. |
⚠️ reputation.reach é null quando a régua de pontuação não se aplica ao domínio — é o caso de domínio com IP dedicado e isenção configurada. Ele entrega para todos os destinos, qualquer que seja a pontuação.
⚠️ Qualidade e alcance respondem perguntas diferentes. Um domínio pode ter qualidade good e alcance mainstream: a média de 7 dias o mantém no grupo de IP, e a pontuação do último cálculo restringe os destinos.
O id do domínio é o mesmo número que cada mensagem traz em smtp_domain_id.
Ser avisado quando a faixa muda
Em vez de consultar de tempos em tempos, assine os webhooks domain.quality.changed e domain.reach.changed num endpoint de e-mail no formato v2. Cada aviso traz a faixa de antes, a de agora e este mesmo objeto de domínio. A queda é avisada no cálculo em que acontece; a subida, quando o cálculo seguinte a confirma.
