O mapeamento de domínio personalizado no Document360 permite substituir a URL padrão project-name.document360.com por um domínio que pertence inteiramente à sua organização, como help.yourcompany.com. Mapear um domínio personalizado fortalece a identidade da sua marca e oferece aos leitores uma experiência consistente e marcada quando visitam seu site de Knowledge Base. O Document360 automaticamente fornece um certificado SSL para seu domínio mapeado, para que o site permaneça seguro sem configurações extras.
Quando usar mapeamento de domínio personalizado
Use mapeamento de domínio personalizado quando quiser que seu site de base de conhecimento esteja sob sua própria marca, em vez de um subdomínio fornecido pelo Document360.
Você quer que os leitores acessem o conteúdo de suporte em uma URL como
help.yourcompany.comem vez de um subdomínio do Document360.Você precisa da verificação do Google Search Console para o seu site de base de conhecimento, que é suportado apenas em um domínio personalizado.
Você quer um endereço web mais curto e memorável para materiais de marketing ou apoio.
Antes de começar
Um domínio fornecido pelo Document360 e um domínio personalizado não podem coexistir — mapear um domínio personalizado substitui o padrão.
Você precisa acessar as configurações de DNS do seu registrador de domínio (por exemplo, GoDaddy, Namecheap ou Cloudflare) para adicionar registros TXT e CNAME.
Atualmente, o Document360 suporta apenas um domínio personalizado por projeto.
Como editar o domínio padrão
Cada novo projeto Document360 recebe automaticamente um domínio padrão no formato project-name.document360.com. Você pode personalizar esse endereço padrão antes ou em vez de mapear um domínio totalmente personalizado.
Navegue até Configurações > Site da base de conhecimento > Domínio personalizado.
Clique em Editar domínio no campo fornecido pelo Document360 . A janela de diálogo Editar subdomínio aparece.
Insira seu domínio preferido no campo. O botão Atualizar permanece inativo se o domínio estiver indisponível ou já estiver em uso, e fica ativo assim que você entra em um domínio disponível.
Clique em Atualizar para atualizar o endereço do site do seu banco de conhecimento.
Como mapear um domínio personalizado
Mapear um domínio personalizado envolve três etapas: adicionar o domínio no Document360, configurar os registros DNS com seu registrador e verificar a configuração.
Adicionar o domínio personalizado no Document360
Navegue até Configurações > Site da base de conhecimento > Domínio personalizado.
Clique em Adicionar domínio.
Insira seu nome de domínio personalizado no campo Inserir seu domínio personalizado e clique em Visualizar configuração.
Seu domínio personalizado agora foi adicionado ao Document360.
Configure DNS com Document360
.png)
Configure o registro TXT no seu registrador de domínio
Faça login no seu registrador de domínio (por exemplo, GoDaddy, Namecheap ou Google Domains).
Navegue até as configurações de DNS e clique em Adicionar novo registro.
Selecione Registro TXT como tipo de Registro.
Insira os detalhes de Host e Valor/Destino do Document360 no seu registrador de domínio.
Clique no ícone de Marcar para salvar as alterações.
No Document360, clique em Verificar. O status do registro TXT muda de Pendente para Verificado.
NOTA
A verificação de registros DNS no Document360 pode levar algum tempo para ser concluída.
Configure o registro CNAME no seu registrador de domínio
Clique em Adicionar novo registro e selecione Registro CNAME como o tipo de Registro.
Insira os detalhes de Host e Valor/Destino do Document360 no seu registrador de domínio.
.png)
Clique no ícone de Marcar para salvar as alterações. No Document360, o status do registro CNAME muda de Pendente para Verificado.
Verificar configuração DNS
O Document360 provisiona automaticamente um certificado SSL assim que a verificação DNS é concluída; Isso pode levar um tempo para ser concluído.
Clique em verificar Retentar.
Uma vez verificado, uma mensagem de sucesso aparece e seu domínio personalizado fica acessível.
.png)
Clique em Ir ao site da sua base de conhecimento para ver a mudança na URL do site.
Seu domínio personalizado agora está mapeado e acessível aos leitores.
Como configurar um domínio Apex
Um domínio Apex (também chamado de domínio raiz) é um domínio sem subdomínio, como abc.com em vez de www.abc.com. Configurar um domínio Apex requer etapas extras de DNS em comparação com um subdomínio padrão.
O achatamento DNS permite usar um registro CNAME no nível Apex, mas nem todos os registradores de domínio suportam isso. Se seu registrador não suporta achatamento de DNS — como o GoDaddy, por exemplo — você pode migrar para um provedor de DNS que suporte, como o Cloudflare, que oferece achatamento de DNS em seu plano gratuito.
NOTA
Para mais detalhes, veja a documentação da Cloudflare sobre o achatamento CNAME.
Usando um certificado SSL personalizado
O Document360 fornece automaticamente um certificado SSL para seu domínio, com renovação contínua. Se preferir instalar seu próprio certificado, forneça os seguintes detalhes:
Campo | Descrição |
|---|---|
Nome comum (CN) | O domínio totalmente qualificado para o certificado. |
Organização (O) | O nome legal da sua organização. |
Unidade Organizacional (OU) | O departamento ou divisão dentro da sua organização. |
Renovação do certificado
Certificados SSL personalizados normalmente são válidos por 90 dias. Renove seu certificado no prazo e forneça o certificado atualizado para que ele possa ser reinstalado no seu domínio.
Como atualizar o balanceador de carga
Um balanceador de carga distribui o tráfego recebido de forma uniforme entre vários servidores, mantendo seu site de base de conhecimento rápido e confiável durante períodos de alto tráfego e evitando que qualquer servidor fique sobrecarregado.
Navegue até Configurações > Site da base de conhecimento na barra de navegação esquerda do portal da Base de Conhecimento.
Navegue para Domínio personalizado > Mapeamento de domínio Personalizado.
Clique em Atualizar.
Verifique a configuração personalizada de mapeamento de domínio no Document360.
Copie o registro CNAME gerado no Document360.
Configure o registro CNAME no seu registrador de domínio.
Verifique novamente a configuração personalizada de mapeamento de domínio no Document360. O status muda de Pendente para Verificado.
NOTA
Essa atualização não causa tempo de inatividade, embora recomendemos realizá-la fora do expediente. Entre em contato com o suporte do Document360 para obter assistência.
O balanceador de carga agora foi atualizado para o site da sua base de conhecimento.
Limites
Limite | Valor | Notas |
|---|---|---|
Domínios personalizados por projeto | 1 | Um segundo domínio não é suportado; Configure um redirecionamento de um domínio para o outro. |
Domínios por versão | Não suportado | Cada versão usa um caminho personalizável dentro do mesmo domínio, não um domínio separado. |
Validade de certificado SSL personalizado | 90 dias | Renove e reenvie o certificado antes que ele expire. |
Verificação no Google Search Console | Domínio personalizado necessário | Verificação não é suportada em um subdomínio fornecido pelo Document360. |
Melhores práticas
Use links relativos (por exemplo,
/docs/article-name) em vez de URLs completas no seu conteúdo, para que os links não quebrem se você mudar de domínio depois.Se você está configurando um domínio Apex e seu registrador não suporta achatamento de DNS, mude para um provedor que suporte, como a Cloudflare, em vez de contornar essa limitação.
Programe as atualizações do balanceador de carga fora do expediente, mesmo que o processo não cause tempo de inatividade, para minimizar qualquer risco durante a mudança.
Renove certificados SSL personalizados antes do prazo de 90 dias para evitar uma interrupção no acesso seguro.
Registradores de domínio comum
Registrador | Referência |
|---|---|
NomeBarato | |
Domain.com | |
Google Domains | |
Hospedeiro | |
Paire | |
GoDaddy | |
Cloudflare | |
Hospedeiro azul |
FAQ
Preciso de um certificado SSL para configurar um domínio personalizado?
Não. O Document360 fornece automaticamente um certificado SSL quando você mapeia seu domínio personalizado. Se preferir usar seu próprio certificado, entre em contato com support@document360.com.
A URL personalizada do domínio vai aparecer no e-mail de convite enviado aos leitores?
Sim. E-mails de convite enviados após o domínio personalizado ser mapeado com sucesso usarão o domínio personalizado em seus links.
O que faço se o CNAME não for verificado após atualizar o DNS?
Remova a configuração atual do domínio personalizado, adicione novamente o domínio personalizado, atualize o CNAME no seu DNS e confirme se ele se verifica com sucesso.
Posso configurar dois domínios personalizados para um único site de base de conhecimento?
Não, mas você pode configurar um redirecionamento de um domínio para outro para que os visitantes do primeiro domínio fiquem no segundo.
O que é um domínio nu?
Um domínio nu não inclui o prefixo "www" — por exemplo, example.com é nu, enquanto www.example.com não é. A maioria dos domínios inclui "www" por padrão.
O que é um registrador de domínio?
Um registrador de domínios é a empresa onde você compra e gerencia seu nome de domínio, como GoDaddy, Namecheap ou Google Domains. Você vai atualizar suas configurações de domínio personalizadas lá para conectá-lo ao Document360.
O que é um registro CNAME?
Um registro CNAME é uma configuração de DNS que conecta seu domínio personalizado, como help.yourcompany.com, a outro endereço, como o domínio padrão fornecido pelo Document360. Ele garante que os leitores acessem seu site de base de conhecimento ao digitarem seu domínio personalizado.
Por que preciso atualizar para o novo balanceador de carga?
O novo balanceador de carga implementa o descarregamento SSL no nível do balanceador de carga para reduzir a carga do servidor e melhorar a segurança, inclui um firewall de aplicações web contra ataques comuns como injeção SQL e scripts cross-site, e utiliza gerenciamento dinâmico de tráfego para melhor desempenho.
É possível criar um domínio separado para cada versão do meu projeto?
Não. Cada versão usa um caminho personalizável dentro do domínio existente, em vez de um domínio separado.
Mudar o domínio personalizado afetará o widget ou os links de artigos existentes?
Não. O widget autentica usando um token de API, então ele continua funcionando após uma mudança de domínio. Links de artigos no Document360 geralmente são relativos (por exemplo, /docs/article-name), então também não quebram. Se você usou URLs completas, revise e atualize-as manualmente — usar links relativos é a melhor prática para evitar isso.
Por que estou vendo o Erro Cloudflare 1014 – CNAME Cross-User Banido ao configurar meu domínio personalizado?
Isso acontece quando tanto o Document360 quanto seu domínio estão hospedados na Cloudflare, já que a Cloudflare bloqueia registros CNAME em diferentes contas. Em uma conta paga da Cloudflare, verifique se "Também prevenir subdomínios" (retenção de zona) está ativado — desative temporariamente, deixe o domínio verificar e então reative. Em uma conta gratuita, a retenção de zona está desativada por padrão; garantir que seus registros CNAME se propaguem dentro de 7 dias após a geração no Document360 e, se a verificação ainda falhar, remover e reconfigurar o domínio personalizado. Se os problemas persistirem, entre em contato com o suporte da Cloudflare, pois a causa pode estar relacionada à faturação.
Adicionar um domínio personalizado muda o link do meu portal do Document360?
Não. A URL do seu portal permanece a mesma — o domínio personalizado se aplica apenas ao site da Knowledge Base, não ao portal de administração.
Posso personalizar a estrutura das URLs da minha base de conhecimento?
Não, a estrutura de URL é fixa. Você pode configurar um domínio personalizado ou modificar um slug de artigo, mas componentes essenciais como versão do projeto, linguagem e caminhos definidos pelo sistema (por exemplo, /docs/) não podem ser alterados.
Como posso conseguir uma URL mais limpa ou mais amigável para o meu conhecimento?
O formato da URL em si é fixo, mas você pode deixá-lo mais limpo editando o subdomínio padrão (via Configurações > Domínio Personalizado > Editar domínio), configurando um domínio personalizado para substituir totalmente o subdomínio do Document360, ou renomeando seu projeto para um nome mais curto, que também atualiza o subdomínio padrão. Remover o código do idioma da URL não é suportado, e o redirecionamento em nível de artigo não pode mudar o formato da URL em si.
Por que a verificação do Google Search Console não está funcionando para o meu site de base de conhecimento?
A verificação do Google Search Console só funciona em um domínio personalizado. Se seu site estiver em um subdomínio Document360, a verificação falha independentemente do método, já que os subdomínios Document360 compartilham o domínio raiz da plataforma e verificá-los pode entrar em conflito com a própria marca e SEO do Document360. Configure primeiro um domínio personalizado e depois complete a verificação usando qualquer método suportado.
Mudar o subdomínio fornecido pelo Document360 vai afetar minha configuração SSO ou SCIM?
Não. Mudar o subdomínio fornecido pelo Document360 não afeta a autenticação SSO existente ou a configuração SCIM, embora usuários que fazem login via SSO precisem usar o subdomínio atualizado posteriormente.