Dashboard de Gerenciamento de Domínios
O dashboard do Notifica oferece uma interface visual para gerenciar seus domínios de envio de email. Este guia explica como adicionar, verificar e monitorar domínios sem precisar usar a API diretamente.
Acessando a Página de Domínios
- Faça login no dashboard
- No menu lateral, acesse Configurações → Domínios
- Você verá a lista de todos os domínios registrados para sua conta
Visão Geral da Interface
A página de domínios exibe uma tabela com as seguintes informações:
| Coluna | Descrição |
|---|---|
| Domínio | O nome do domínio registrado (ex: suaempresa.com.br) |
| Status | Estado atual: Pendente, Verificado, ou Falhou |
| Registros DNS | Indicador visual dos registros configurados |
| Data de Verificação | Quando o domínio foi verificado (se aplicável) |
| Ações | Botões de verificar, ver detalhes e remover |
Status dos Domínios
| Status | Ícone | Significado |
|---|---|---|
| Pendente | 🟡 | Domínio registrado, aguardando configuração DNS e verificação |
| Verificado | 🟢 | DNS verificado com sucesso, domínio pronto para envio |
| Falhou | 🔴 | Última tentativa de verificação falhou (registros DNS não encontrados) |
Passo a Passo: Adicionar um Novo Domínio
Passo 1 — Abrir o formulário
Na página de Domínios, clique no botão "Adicionar Domínio" no canto superior direito.
Passo 2 — Digitar o domínio
No modal que aparece:
- Digite o domínio completo (ex:
suaempresa.com.br,mail.suaempresa.com.br) - Não inclua
http://ouhttps:// - Clique em "Adicionar"
Use subdomínios separados para diferentes tipos de envio: transacional.empresa.com.br para emails transacionais e marketing.empresa.com.br para campanhas. Isso protege a reputação do seu domínio principal.
Passo 3 — Copiar os registros DNS
Após adicionar, o dashboard exibe automaticamente os registros DNS necessários:
1. Registro TXT (Verificação de Propriedade)
Tipo: TXT
Host: suaempresa.com.br (ou @ no seu provedor)
Valor: notifica-verification=SEU_TOKEN_UNICO
2. Registro DKIM
Tipo: TXT
Host: notifica._domainkey.suaempresa.com.br
Valor: v=DKIM1; k=rsa; p=SUA_CHAVE_PUBLICA...
3. Registro SPF
Tipo: TXT
Host: suaempresa.com.br (ou @)
Valor: v=spf1 include:spf.usenotifica.com.br ~all
Cada registro tem um botão de copiar para facilitar. Clique no ícone 📋 ao lado do valor para copiar para a área de transferência.
Sobre DKIM customizado por tenant, veja a documentação completa em DKIM — Autenticação de Email.
Passo 4 — Configurar no seu provedor DNS
Vá até o painel do seu provedor DNS e adicione os registros. Provedores comuns no Brasil:
| Provedor | Onde configurar |
|---|---|
| Cloudflare | Dashboard → DNS → Add Record |
| Registro.br | Painel → Domínio → DNS → Criar registro |
| AWS Route 53 | Hosted Zones → domínio → Create Record |
| GoDaddy | My Products → DNS → Add Record |
| Locaweb | Painel → DNS → Gerenciar |
A propagação DNS pode levar de 5 minutos a 48 horas. Na maioria dos casos, os registros propagam em menos de 30 minutos.
Passo 5 — Verificar o domínio
Após adicionar os registros DNS:
- Volte à página de Domínios no dashboard
- Encontre seu domínio na lista (status: Pendente)
- Clique no botão "Verificar"
- O sistema vai consultar os registros DNS
Se verificou com sucesso: O status muda para 🟢 Verificado e a data de verificação é preenchida.
Se falhou: O status muda para 🔴 Falhou com uma mensagem indicando qual registro não foi encontrado. Verifique a configuração e tente novamente.
Visualizar Detalhes do Domínio
Clique no nome do domínio ou no botão de detalhes para ver:
- Registros DNS necessários — Todos os registros com valores para copiar
- Status de cada registro — Quais foram encontrados e quais estão faltando
- Histórico de verificações — Quando cada tentativa foi feita
- Informações de DKIM — Chave pública gerada para este domínio
Remover um Domínio
- Na lista de domínios, clique no ícone de lixeira (🗑️) ao lado do domínio
- Confirme a remoção no modal de confirmação
Atenção: Ao remover um domínio verificado, todos os envios de email usando endereços desse domínio como remetente serão imediatamente bloqueados. Certifique-se de atualizar suas configurações de canal antes de remover.
Gerenciamento via API
Para automatizar o gerenciamento de domínios (CI/CD, scripts, etc.), use a API REST:
| Ação | Método | Endpoint |
|---|---|---|
| Listar | GET | /v1/domains |
| Registrar | POST | /v1/domains |
| Detalhes | GET | /v1/domains/:id |
| Verificar | POST | /v1/domains/:id/verify |
| Remover | DELETE | /v1/domains/:id |
Documentação completa: Configuração de Domínio de Envio e API Reference.
Troubleshooting no Dashboard
"Verificação falhou" repetidamente
- Confira se os registros DNS estão corretos usando o terminal:
dig TXT suaempresa.com.br +short - Verifique se não há registros duplicados (especialmente SPF)
- Aguarde pelo menos 30 minutos entre tentativas
Domínio aparece como "Pendente" após verificação
- A verificação pode demorar alguns segundos. Recarregue a página (F5)
- Se persistir, tente verificar novamente
Não consigo ver o botão "Adicionar Domínio"
- Verifique se você tem permissões de administrador na conta
- Apenas usuários com role de admin podem gerenciar domínios
Monitoramento de Saúde
Após a verificação inicial, o Notifica monitora automaticamente a saúde dos registros DNS dos seus domínios. Veja Monitoramento de Saúde de Domínios para detalhes sobre:
- Verificações automáticas a cada 6 horas
- Alertas quando registros degradam ou são removidos
- Como responder a alertas de saúde
Próximos Passos
- Configuração de Domínio via API — Setup completo com curl
- DKIM — Autenticação de Email — Entenda o DKIM customizado por tenant
- Monitoramento de Saúde — Alertas automáticos de DNS
- Configurar SMTP — Envie emails via relay SMTP