Ir para o conteúdo

Domínios Personalizados

Caminho: /dashboard/settings (aba Custom Domain) · Permissão: Módulo de Configurações

Domínios personalizados permitem que você disponibilize seu bot em uma URL com sua marca, como https://bot.suaempresa.com, em vez de um endereço IP com um número de porta. A configuração é automatizada a partir do dashboard — sem necessidade de comandos via linha de código.

Custom Domain Settings Custom Domain Settings

O que um domínio personalizado faz

Em vez de acessar seu bot em https://123.45.67.89:8321, um domínio personalizado oferece uma URL limpa e profissional:

  • https://bot.suaempresa.com — Profissional e confiável
  • https://suporte.suaempresa.com — Específico para o propósito
  • https://ia.suaempresa.com — Moderno e memorável

Este continua sendo o seu servidor privado — um domínio personalizado é apenas uma URL com sua marca que aponta para ele.

Pré-requisitos

Antes de configurar um domínio personalizado, certifique-se de ter:

Requisito Detalhes
Controle de DNS Você pode criar registros tipo A para o seu domínio (via seu registrador ou Cloudflare)
Portas 80 e 443 Abertas no seu servidor para tráfego HTTP e HTTPS
Propriedade do domínio Você é dono ou gerencia o domínio que deseja usar

O SSL é gerenciado automaticamente

Os certificados SSL são provisionados e renovados automaticamente. Nenhuma configuração manual é necessária.

Configuração passo a passo

Passo 1: Criar um registro DNS

Vá ao seu registrador de domínio ou provedor de DNS e crie um registro A:

Tipo de registro Nome Valor
A bot.seudominio.com O endereço IP do seu servidor

Substitua bot por qualquer subdomínio de sua preferência (ex: suporte, ia, chat).

Passo 2: Verificar o DNS

  1. Vá para Settings → Custom Domain no dashboard.
  2. Insira seu domínio (ex: bot.seudominio.com).
  3. Clique em Verify DNS.
  4. O sistema verifica se o registro A aponta para o seu servidor.

Propagação de DNS

As alterações de DNS podem levar de 5 a 30 minutos para propagar. Se a verificação falhar, aguarde alguns minutos e tente novamente.

Passo 3: Adicionar o domínio

  1. Assim que o DNS for verificado, clique em Add Domain.
  2. O sistema automaticamente:
    • Gera os arquivos de configuração do Nginx
    • Solicita um certificado SSL da Let's Encrypt
    • Ativa o domínio

Seu bot agora está online em https://bot.seudominio.com.

Compatibilidade com Cloudflare

Se você usa a Cloudflare como seu provedor de DNS/CDN:

  • Modo SSL recomendado: Full (Strict)
  • O sistema é compatível com o proxy da Cloudflare (nuvem laranja ativada).
  • A Cloudflare gerencia o SSL na borda (edge), e o servidor fornece o certificado de origem.

Gerenciando domínios

Renovar SSL

Os certificados SSL da Let's Encrypt expiram a cada 90 dias. Você pode renovar pelo dashboard:

  1. Vá para Settings → Custom Domain.
  2. Clique em Renew SSL.

A renovação automática é configurada durante a instalação, mas você pode iniciar uma renovação manual a qualquer momento.

Remover um domínio

  1. Vá para Settings → Custom Domain.
  2. Clique em Remove.
  3. A configuração do Nginx e o certificado SSL são removidos.
  4. O bot volta a ser acessado via IP:porta.

Incorporação do Widget após domínio personalizado

Assim que seu domínio personalizado estiver ativo, atualize o código de incorporação do seu widget para utilizá-lo:

<script 
  src="https://bot.yourdomain.com/chatbot-widget/v1/js/loader.js"
  data-bot-id="your-bot-id"
  data-backend-url="https://bot.yourdomain.com"
  async>
</script>

Use a página de incorporação dinâmica

Vá para Dashboard → Embed após adicionar seu domínio personalizado — o código de incorporação gerado utilizará automaticamente o novo domínio. Nenhuma alteração manual de URL será necessária.

FAQ (Perguntas Frequentes)

P: A verificação de DNS falhou.

  • Aguarde de 5 a 30 minutos para a propagação do DNS.
  • Verifique se o registro A está apontando para o endereço IP correto usando o painel de controle do seu provedor de DNS.
  • Se continuar falhando, entre em contato com seu gerente de conta.

P: O HTTPS não está funcionando.

  • Tente renovar o SSL em Settings → Custom Domain.
  • Se estiver usando Cloudflare, garanta que o modo SSL esteja definido como Full (Strict).
  • Entre em contato com seu gerente de conta se o problema persistir.

P: Posso usar múltiplos domínios personalizados?

  • Atualmente, apenas um domínio personalizado por servidor é suportado. Para múltiplos domínios, entre em contato com seu gerente de conta.

P: Minha URL antiga de IP:porta continuará funcionando?

  • Sim. Adicionar um domínio personalizado não desativa o acesso direto por IP. Ambos os métodos funcionam simultaneamente.