Pular para o conteúdo

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.