Configurar um domínio personalizado para sua central de ajuda

Este guia mostra como apontar um domínio que você possui (por exemplo ajuda.suaempresa.com) para a sua central de ajuda do Deskwoot. Nenhum conhecimento técnico necessário, explicamos cada passo além do que está acontecendo nos bastidores. Tempo total: 5 minutos de configuração e depois 2 a 10 minutos de espera. Disponível no plano Enterprise.

O que você está fazendo em palavras simples

No momento sua central de ajuda fica em suaempresa.deskwoot.com. Isso é perfeitamente normal, mas empresas maiores costumam querer a central em um subdomínio da própria marca, como ajuda.suaempresa.com ou suporte.suaempresa.com. Para que isso funcione, você precisa dizer à agenda global de endereços da internet (o DNS) que ajuda.suaempresa.com deve servir o conteúdo da central de ajuda do Deskwoot.

Você faz isso adicionando no seu registrador de domínios (Cloudflare, GoDaddy, Namecheap, Google Domains, etc.) os registros DNS que o Deskwoot mostra. Para um subdomínio, normalmente é um único CNAME que aponta o tráfego para nós; às vezes o Deskwoot também pede um registro TXT que confirma que o domínio é seu. Com os registros no lugar, um certificado SSL gratuito é instalado automaticamente para que a página carregue com o cadeado. É só isso.

Antes de começar

• Você precisa ser administrador na sua conta do Deskwoot.
• Você precisa estar no plano Enterprise. Os planos inferiores veem o mesmo painel bloqueado.
• Você precisa de acesso ao seu provedor de DNS. É onde você comprou o domínio (ou para onde moveu o DNS dele). Os mais comuns: Cloudflare, GoDaddy, Namecheap, Route 53, Google Domains.
• Escolha um subdomínio se puder. Subdomínios como ajuda, suporte ou docs normalmente só precisam de um CNAME. O domínio raiz (suaempresa.com sozinho) precisa de outros registros, explicamos isso mais adiante.

Passo 1: insira o domínio no Deskwoot

1. Abra a Central de Ajuda no painel do Deskwoot.
2. Clique na aba Configurações no painel à direita.
3. Role até a seção Domínio personalizado.
4. Digite o hostname completo que você quer (por exemplo ajuda.acme.com) e clique em Registrar.

O Deskwoot reserva o hostname na nossa camada de borda e mostra os registros DNS para você adicionar no seu provedor de DNS. Cada registro tem botões para copiar o host e o valor. A etiqueta de status muda para "Aguardando DNS".

Passo 2: adicione os registros DNS no seu provedor

Adicione cada registro que o painel lista, exatamente como aparece. Para um subdomínio, normalmente é um registro CNAME. Um CNAME é apenas uma entrada do tipo "este nome aponta para aquele outro nome" no DNS. A maioria dos provedores tem um formulário simples: escolha o tipo (CNAME), digite um Nome, digite um Valor, salve.

O CNAME (encaminha seus visitantes para o Deskwoot)

• Tipo: CNAME
• Nome / Host: a parte de subdomínio do seu hostname. Se você registrou ajuda.acme.com, isto é ajuda. A maioria dos provedores acrescenta o resto automaticamente, mas alguns querem o hostname completo (ajuda.acme.com). Ambos funcionam, dependendo do seu provedor.
• Valor / Destino / Aponta para: copie isto do painel do Deskwoot. Tem a aparência de xxxxx.up.railway.app.
• TTL: deixe em automático / padrão (normalmente 300 segundos = 5 minutos).
• Proxy / nuvem laranja do Cloudflare: DESLIGADO (somente DNS, veja as observações específicas do Cloudflare abaixo).

Um registro TXT, se o painel mostrar um (confirma que o domínio é seu)

• Tipo: TXT.
• Nome / Host: o host que o painel mostra, por exemplo _railway-verify.ajuda.acme.com (ele também pode começar com _acme-challenge). Muitos provedores querem só a parte antes do seu domínio (_railway-verify.ajuda) e completam o resto.
• Valor: o valor que o Deskwoot mostra nessa linha.
• TTL: automático / padrão.

Todos os registros da lista são obrigatórios. Se o painel mostrar um registro TXT e você o pular, o certificado SSL não pode ser emitido e a página não carrega por HTTPS. A lista pode mudar durante a configuração (um registro para o certificado pode aparecer quando a emissão começa), então clique em Verificar agora de novo mais tarde e adicione qualquer registro novo que aparecer.

Passo 3: aguarde e depois clique em "Verificar agora"

As mudanças de DNS levam tempo para se propagar pelo mundo. Propagação típica:

• Cloudflare: 1 a 2 minutos.
• Namecheap / GoDaddy / Google Domains: 5 a 15 minutos.
• Provedores antigos ou lentos / TTL alto: até 24 horas (raro).

Depois que passarem alguns minutos, volte ao painel do Deskwoot e clique em Verificar agora no painel de Domínio personalizado. A etiqueta de status vai atualizar:

• Aguardando DNS: seus registros DNS ainda não estão visíveis de onde o Deskwoot está verificando. Espere mais um minuto ou dois.
• Emitindo certificado SSL: o DNS está bom, o Let's Encrypt está gerando seu certificado. Normalmente leva menos de um minuto.
• No ar: seu domínio está servindo tráfego com HTTPS. Pronto.

O botão Verificar agora tem um intervalo de espera de 10 segundos para você não clicar nele à toa. A propagação de DNS não fica mais rápida só porque você clica mais.

O que acontece nos bastidores

Você não precisa saber disto para fazer funcionar, mas para os curiosos:

1. Quando você clica em Registrar, o Deskwoot avisa o Railway (nossa plataforma de hospedagem) para adicionar seu hostname à tabela de roteamento dele.
2. O Railway define os registros DNS de que o seu domínio precisa: um registro que encaminha o tráfego (um CNAME para um subdomínio, um registro A ou ALIAS para um domínio raiz) e, quando necessário, um registro TXT que prova que você controla o domínio, para que o Let's Encrypt possa emitir o certificado.
3. Você adiciona esses registros no seu provedor de DNS.
4. O observador de DNS em segundo plano do Railway consulta os registros a cada poucos segundos.
5. Assim que os registros ficam visíveis globalmente, o Railway pede automaticamente ao Let's Encrypt um certificado SSL gratuito via protocolo ACME.
6. O Let's Encrypt confirma que você controla o domínio, emite o certificado, e o Railway o instala na borda.
7. Seu domínio agora serve tráfego HTTPS. O certificado se renova sozinho a cada 60 a 90 dias; você nunca precisa mexer nele.

Custo: $0. Os certificados do Let's Encrypt são gratuitos, o Railway os provisiona para nós sem custo extra, e o Deskwoot inclui domínios personalizados no plano Enterprise sem taxa por domínio.

Observações específicas por provedor

Cloudflare

• O erro mais comum: deixar a nuvem laranja (proxy) LIGADA. O proxy do Cloudflare encerra a requisição antes que ela chegue ao Railway, o que pode impedir a verificação do domínio e o certificado SSL. Clique na nuvem laranja para trocá-la por uma nuvem cinza (somente DNS) em TODOS os registros.
• Se você usa o Universal SSL do Cloudflare, ele pode avisar sobre um conflito. Ignore o aviso, o certificado que instalamos na borda do Deskwoot é o que seus visitantes veem.
• A propagação no Cloudflare é rápida: normalmente 60 a 90 segundos.

GoDaddy

• Na página de Gerenciamento de DNS, use o botão "Adicionar" e depois CNAME.
• Para um registro cujo nome começa com sublinhado (como _railway-verify.ajuda), digite o host exatamente como o painel mostra.
• O GoDaddy remove os pontos finais do campo Valor, isso é esperado.

Namecheap

• Vá em Domain List, depois Manage, depois Advanced DNS.
• Add New Record, depois CNAME Record.
• No campo Host, "ajuda" acrescenta automaticamente .suaempresa.com.

Google Domains / Squarespace Domains

• O Google migrou a maioria dos clientes de domínio para o Squarespace em 2024. Qualquer uma das plataformas tem o mesmo fluxo de CNAME.
• Procure por "DNS", depois "Manage custom records", depois Add, depois CNAME.

AWS Route 53

• Abra a zona hospedada do seu domínio, depois Create record, depois CNAME.
• Use o hostname completo no campo Name. O Route 53 não acrescenta nada automaticamente.

E o domínio raiz?

O padrão de DNS não permite registros CNAME na "raiz" de um domínio (suaempresa.com sozinho, também chamado de domínio "apex" ou "nu"). Mesmo assim o Deskwoot aceita um domínio raiz: o painel então mostra um registro A ou ALIAS mais um registro TXT em vez de um CNAME.

Você tem duas opções:

• Use um subdomínio (recomendado): ajuda.suaempresa.com, suporte.suaempresa.com, docs.suaempresa.com.
• Use o domínio raiz e adicione exatamente os registros que o painel mostra. Para um registro ALIAS, o seu provedor de DNS precisa de um recurso "ALIAS" ou "ANAME" (CNAME Flattening do Cloudflare, registros alias do Route 53, ALIAS do DNSimple).

Solução de problemas

Travado em "Aguardando DNS"

1. Você adicionou TODOS os registros? Você precisa de cada registro que o painel lista, inclusive um registro TXT, se aparecer.
2. Você copiou o Valor exato do Deskwoot? Até um pequeno erro de digitação (caractere a mais, ponto faltando) quebra a busca.
3. Você desligou o proxy do Cloudflare? Nuvem laranja significa "com proxy" e pode quebrar a verificação. Nuvem cinza é o correto.
4. Existe um registro A conflitante? Se antes você tinha ajuda.suaempresa.com apontando para outro lugar com um registro A, exclua-o. Um CNAME não pode coexistir com outros registros no mesmo nome.
5. Verifique os registros com uma ferramenta externa: rode dig CNAME ajuda.suaempresa.com em um terminal, ou use uma ferramenta web de consulta de DNS. Você deve ver o destino do Railway. Se não vir, o registro ainda não se propagou.

Travado em "Emitindo certificado SSL" por mais de 2 minutos

1. Causa mais comum: um registro que o painel lista (muitas vezes um TXT) está faltando, tem o valor errado, ou está com proxy pelo Cloudflare. Clique em Verificar agora: se um registro novo apareceu na lista, adicione-o também.
2. Verifique-o especificamente, com o host que o painel mostra: dig TXT _railway-verify.ajuda.suaempresa.com deve retornar o valor que o Deskwoot mostra.
3. Alguns provedores de DNS removem o prefixo de sublinhado ou o transformam. Se o seu provedor não aceita nomes que começam com _, troque de provedor para este domínio ou fale com a gente, podemos ajudar a contornar.

O domínio mostra "No ar" mas a página exibe um aviso de segurança no navegador

1. Force uma recarga da página (Cmd+Shift+R no Mac, Ctrl+Shift+R no Windows). Os navegadores guardam os certificados SSL em cache de forma agressiva.
2. Espere 1 a 2 minutos. Às vezes o certificado é emitido mas ainda não está instalado em todos os nós de borda.
3. Tente uma janela anônima / privada.

Quero usar um domínio diferente, como faço para mudar?

1. Clique em Remover no painel de Domínio personalizado. Isso cancela o registro do hostname no Railway e limpa os valores de DNS do Deskwoot.
2. Exclua os registros DNS antigos no seu provedor de DNS (opcional, mas mais organizado).
3. Registre o novo hostname e adicione os registros DNS dele.

Perguntas frequentes