Pular para o conteúdo principal

Configuração de Domínio de Envio

Para enviar emails através do Notifica usando um endereço personalizado (ex: [email protected]), você precisa verificar a propriedade do domínio.

Pré-requisitos​

  • Conta ativa no Notifica
  • API key gerada no dashboard
  • Acesso ao painel DNS do seu domínio (Cloudflare, Route53, Registro.br, etc.)

1. Registrar o domínio​

Via API​

curl -X POST https://app.usenotifica.com.br/v1/domains \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: domain-suaempresa-001" \
  -d '{
    "domain": "suaempresa.com.br"
  }'

Resposta:

{
  "id": "dom_abc123",
  "domain": "suaempresa.com.br",
  "status": "pending",
  "dns_records": {
    "txt": {
      "name": "suaempresa.com.br",
      "type": "TXT",
      "value": "notifica-verification=aBcDeFgHiJkLmNoPqRsTuVwXyZ012345"
    }
  },
  "created_at": "2025-01-15T10:30:00Z"
}

Via Dashboard​

  1. Acesse Configurações → Domínios no dashboard
  2. Clique em Adicionar Domínio
  3. Digite o domínio (ex: suaempresa.com.br)
  4. O dashboard exibirá os registros DNS necessários

2. Adicionar registros DNS​

Após registrar o domínio, adicione os seguintes registros no painel DNS do seu provedor.

Registro TXT (verificação de propriedade)​

CampoValor
TipoTXT
Nome/Hostsuaempresa.com.br (ou @ dependendo do provedor)
Valornotifica-verification=SEU_TOKEN_AQUI
TTL300 (ou o mínimo permitido)
informação

O token de verificação é único por domínio e fornecido na resposta da API ou no dashboard.

Registro SPF​

Adicione o Notifica ao seu registro SPF existente, ou crie um novo:

Se você já tem um registro SPF:

v=spf1 include:_spf.usenotifica.com.br [seus includes existentes] ~all

Se você não tem registro SPF:

CampoValor
TipoTXT
Nome/Host@
Valorv=spf1 include:_spf.usenotifica.com.br ~all
aviso

Nunca crie mais de um registro SPF para o mesmo domínio. Se já existir um, edite-o para incluir o Notifica.

Registro DKIM​

CampoValor
TipoCNAME
Nome/Hostnotifica._domainkey
Valornotifica._domainkey.usenotifica.com.br
dica

O DKIM é essencial para boa reputação de envio. Sem ele, seus emails têm maior chance de cair no spam.

Registro DMARC (recomendado)​

CampoValor
TipoTXT
Nome/Host_dmarc
Valorv=DMARC1; p=none; rua=mailto:[email protected]
informação

Comece com p=none para monitoramento. Depois de validar que tudo funciona, mude para p=quarantine ou p=reject.

3. Verificar o domínio​

Após adicionar os registros DNS, aguarde a propagação (geralmente 5-60 minutos) e solicite a verificação.

Via API​

curl -X POST https://app.usenotifica.com.br/v1/domains/dom_abc123/verify \
  -H "Authorization: Bearer YOUR_API_KEY"

Sucesso:

{
  "id": "dom_abc123",
  "domain": "suaempresa.com.br",
  "status": "verified",
  "verified_at": "2025-01-15T10:45:00Z"
}

Falha (DNS ainda não propagou):

{
  "error": "dns_check_failed",
  "message": "TXT record not found. DNS propagation may still be in progress."
}

Via Dashboard​

  1. Acesse Configurações → Domínios
  2. Clique em Verificar ao lado do domínio pendente
  3. O status mudará para ✅ Verificado ou ❌ Falhou

4. Consultar domínios​

Listar todos os domínios​

curl https://app.usenotifica.com.br/v1/domains \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "data": [
    {
      "id": "dom_abc123",
      "domain": "suaempresa.com.br",
      "status": "verified",
      "verified_at": "2025-01-15T10:45:00Z"
    },
    {
      "id": "dom_def456",
      "domain": "marketing.suaempresa.com.br",
      "status": "pending",
      "verified_at": null
    }
  ]
}

Detalhes de um domínio​

curl https://app.usenotifica.com.br/v1/domains/dom_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

Remover um domínio​

curl -X DELETE https://app.usenotifica.com.br/v1/domains/dom_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"
aviso

Ao remover um domínio verificado, todos os envios de email usando esse domínio pararão imediatamente.

Troubleshooting​

"TXT record not found"​

Causas comuns:

  1. Propagação DNS incompleta — Aguarde até 72 horas (raro, geralmente 5-30 minutos). Verifique com:

    dig TXT suaempresa.com.br +short

  2. Nome do registro incorreto — Alguns provedores (como Registro.br) adicionam o domínio automaticamente. Se o host é suaempresa.com.br, talvez você precise digitar apenas @.

  3. Valor com aspas extras — O valor deve ser exatamente notifica-verification=SEU_TOKEN. Sem aspas extras ao redor.

  4. Proxy do Cloudflare — Registros TXT não são afetados pelo proxy, mas certifique-se de que o registro está como DNS only (nuvem cinza) se estiver usando CNAME.

"SPF PermError"​

Isso acontece quando há mais de um registro SPF para o mesmo domínio. Solução:

# Check existing SPF records
dig TXT suaempresa.com.br +short | grep spf

Combine tudo em um único registro:

v=spf1 include:_spf.google.com include:_spf.usenotifica.com.br ~all

"DKIM signature not found"​

  1. Verifique se o CNAME está correto: 
    dig CNAME notifica._domainkey.suaempresa.com.br +short
  2. O resultado deve ser notifica._domainkey.usenotifica.com.br.

Verificação demora mais que 24 horas​

Se os registros DNS estão corretos mas a verificação falha:

  1. Teste a resolução DNS diretamente: 
    dig TXT suaempresa.com.br @8.8.8.8 +short
  2. Se o registro aparece com DNS público mas a verificação falha, entre em contato com o suporte.

Monitoramento de Saúde dos Registros DNS​

Após configurar e verificar seu domínio, o Notifica monitora automaticamente a saúde dos registros DNS a cada 6 horas. Se algum registro for removido ou degradado, alertas são criados automaticamente.

O que é monitorado​

  • TXT de verificação — Token de propriedade do domínio
  • DKIM — Assinatura digital dos emails
  • SPF — Autorização de envio
  • MX — Registros de mail exchange
  • DMARC — Política de autenticação

Alertas automáticos​

Quando um registro muda de ok para missing ou error:

  • Um alerta é criado automaticamente com severidade baseada no impacto
  • Se você tem webhooks configurados, o evento domain.alert.created é disparado
  • Quando o problema é corrigido, o alerta é auto-resolvido

Verificação manual​

Após corrigir um registro DNS, você pode forçar uma verificação imediata sem esperar o ciclo de 6 horas:

curl -X POST https://app.usenotifica.com.br/v1/domains/dom_abc123/health/check \
  -H "Authorization: Bearer YOUR_API_KEY"
aviso

Rate limit de 1 verificação manual por minuto por domínio.

📖 Documentação completa: Monitoramento de Saúde de Domínios

DKIM Customizado por Tenant​

O Notifica gera pares de chaves DKIM exclusivos para cada tenant (RSA 2048 bits). Isso garante que seus emails sejam autenticados de forma independente e que problemas de reputação de outros tenants não afetem sua deliverability.

Registro DKIM no DNS​

O registro DKIM é um TXT publicado em notifica._domainkey.<domain>:

notifica._domainkey.suaempresa.com.br.  300  IN  TXT  "v=DKIM1; k=rsa; p=SUA_CHAVE_PUBLICA"

A chave pública é fornecida na resposta da API ao registrar o domínio e no dashboard.

📖 Documentação completa: DKIM — Autenticação de Email

Boas práticas​

  • Use subdomínios para transacional vs marketing: mail.suaempresa.com.br para transacional, news.suaempresa.com.br para marketing
  • Configure DMARC desde o início: Protege sua reputação
  • Monitore bounces: Emails para endereços inválidos prejudicam sua reputação. Use os webhooks do Notifica para rastrear bounces
  • Não use domínios gratuitos (gmail.com, hotmail.com): Provedores de email rejeitam envios com SPF falho nesses domínios

Próximos passos​