EDUZZ-HS-DNS-001 - Migracao DNS suporte.eduzz.com

Resumo Executivo

O que precisa ser feito?

Para que os formularios e a base de conhecimento do HubSpot funcionem no subdominio suporte.eduzz.com, e necessario configurar registros DNS no provedor de DNS da Eduzz.

Subdominio

suporte.eduzz.com

Destino

HubSpot Service Hub

Registros Necessarios

CNAME + TXT

Etapa 1 - Email

Registros para Envio de Email

Pode executar hoje - Testar antes do Go-Live

Para que o HubSpot possa enviar emails em nome do dominio eduzz.com, e necessario configurar os registros DKIM e atualizar o SPF existente. Esta etapa pode ser feita imediatamente e testada antes do Go-Live.

DKIM (Obrigatorio)

Autenticacao de email para garantir que as mensagens nao sejam marcadas como spam.

Tipo	Host / Nome	Valor / Destino	TTL
CNAME	`hs1-47558663._domainkey`	`eduzz-com.hs12a.dkim.hubspotemail.net.`	3600
CNAME	`hs2-47558663._domainkey`	`eduzz-com.hs12b.dkim.hubspotemail.net.`	3600

SPF (Recomendado)

O dominio ja possui SPF configurado. E necessario adicionar o include do HubSpot ao registro existente, sem remover os outros provedores.

⚠️

Atencao: NAO substituir o SPF existente!

O registro SPF atual inclui: Outlook, SendGrid, Shopback, Zendesk, SendPulse.
Adicione o include do HubSpot mantendo todos os outros.

Tipo	Host	Valor Atual
TXT	`@`	`v=spf1 include:spf.protection.outlook.com include:sendgrid.net include:spf.shopback.com.br include:mail.zendesk.com include:mxsspf.sendpulse.com ~all`

Tipo	Host	Valor Novo (com HubSpot)
TXT	`@`	`v=spf1 include:spf.protection.outlook.com include:sendgrid.net include:spf.shopback.com.br include:mail.zendesk.com include:mxsspf.sendpulse.com include:47558663.spf05.hubspotemail.net ~all`

ℹ️

Verificar include SPF exato

Confirme o valor exato do include SPF no painel do HubSpot antes de aplicar. O formato e: include:XXXXXXX.spf.hubspotemail.net

Etapa 2 - Subdominio

Registros DNS - suporte.eduzz.com

Executar Segunda 09/02 as 07:00

Adicione os seguintes registros no painel de DNS do dominio eduzz.com. Aguardar ate segunda-feira para nao impactar operacao atual.

Tipo	Host / Nome	Valor / Destino	TTL
CNAME	`suporte`	`47558663.group13.sites.hubspot.net`	3600
TXT	`_cf-custom-hostname.suporte`	`40af517c-c5cd-4183-8c99-83ef7bb81fc4`	3600

⚠️

Importante: Ordem de Criacao

Crie primeiro o registro TXT e depois o CNAME. O TXT e usado para validacao SSL do Cloudflare/HubSpot.

ℹ️

Sobre o campo "Host"

No campo Host/Nome, insira apenas suporte (sem o dominio principal). Alguns provedores podem exigir suporte.eduzz.com ou suporte.eduzz.com. (com ponto final). Consulte a documentacao do seu provedor de DNS.

Execucao

Passo a Passo

1

Acessar Painel de DNS

Acesse o painel do provedor de DNS onde o dominio eduzz.com esta configurado. Pode ser Cloudflare, AWS Route 53, GoDaddy, Registro.br, ou outro.

2

Verificar Registro Existente

Verifique se ja existe algum registro para suporte.eduzz.com. Se existir, anote o valor atual antes de alterar (para possivel rollback).

3

Criar/Atualizar Registro CNAME

Crie um novo registro CNAME (ou atualize o existente) com os valores da tabela acima. O TTL de 3600 segundos (1 hora) e recomendado para permitir ajustes rapidos.

4

Aguardar Propagacao

Aguarde a propagacao do DNS. Pode levar de alguns minutos ate 24 horas, dependendo do TTL anterior. Use ferramentas como dnschecker.org para verificar.

5

Validar no HubSpot

Apos a propagacao, valide a configuracao no painel do HubSpot em Settings > Website > Domains & URLs. O status deve mudar para "Connected".

Estimativa

Tempo de Propagacao

Minimo

5 min

Se TTL atual for baixo

Tipico

1-4h

Maioria dos casos

Maximo

24-48h

Cenario pessimista

💡

Dica: Reduzir TTL Antes

Se possivel, reduza o TTL do registro atual para 300 segundos (5 min) algumas horas antes da migracao. Isso acelera a propagacao quando a mudanca for feita.

Validacao

Como Verificar

Use os comandos abaixo para verificar se o DNS foi propagado corretamente.

Verificar CNAME (Mac/Linux)

dig suporte.eduzz.com CNAME +short
# Esperado: 47558663.group13.sites.hubspot.net

Verificar TXT (Mac/Linux)

dig _cf-custom-hostname.suporte.eduzz.com TXT +short
# Esperado: "40af517c-c5cd-4183-8c99-83ef7bb81fc4"

Terminal (Windows)

nslookup -type=CNAME suporte.eduzz.com
nslookup -type=TXT _cf-custom-hostname.suporte.eduzz.com

Online

https://dnschecker.org/#CNAME/suporte.eduzz.com
https://dnschecker.org/#TXT/_cf-custom-hostname.suporte.eduzz.com

Checklist

Antes de Executar

Confirmar acesso ao painel de DNS do dominio eduzz.com
Anotar configuracao atual do subdominio (se existir)
Criar registro TXT primeiro (validacao SSL)
Criar registro CNAME apontando para HubSpot
Aguardar propagacao DNS (verificar com dnschecker.org)
Validar no painel HubSpot (status "Connected")
Comunicar time de suporte sobre conclusao

Suporte

Responsaveis

Configuracao HubSpot

Fabio Munhoz

EPIC Digital

Execucao DNS

Time Infra Eduzz

A definir

Tech Lead

Marcus Picoli

Eduzz