# Domínio Personalizado

{% embed url="<https://drive.google.com/file/d/1-djoJBiLtWuUn3B9W-CywBE51EMWiPnf/view>" %}

O recurso de Domínio Personalizado é essencial para parceiros White Label que desejam fortalecer sua marca, oferecendo uma experiência de acesso totalmente proprietária aos seus clientes.

Ao contratar a plataforma, você pode substituir o endereço padrão do sistema por uma URL exclusiva (como `app.suaempresa.com.br`).

{% hint style="warning" %}
**Requisito Técnico Obrigatório**

Certifique-se de que seu provedor atual permite a criação de **entradas NS específicas para subdomínios**. Alguns provedores possuem limitações que impedem essa configuração.

**O provedor não oferece esse recurso?**

Recomendamos migrar o gerenciamento do seu DNS gratuitamente para a **Cloudflare**, que é 100% compatível com nossa plataforma.

**Não sabe por onde começar?**

[Confira nosso guia passo a passo ensinando como configurar seu domínio na Cloudflare](https://docs.helena.app/duvidas-e-novidades/faq/como-configurar-seu-dominio-na-cloudflare).
{% endhint %}

#### Entendendo a Diferença

Antes de configurar, veja na prática a diferença entre os tipos de domínio exibidos no gerenciamento de parceiros:

* **Domínio Padrão:** É o endereço gerado automaticamente pela plataforma (ex: `suaempresa.wts.chat`). Se você não configurar um domínio próprio, é assim que seu cliente acessará o sistema.
* **Domínio Personalizado:** É a URL da sua marca (ex: `app.suaempresaXX.com.br`). Note no exemplo que a conta "SuaempresaXX" possui um endereço personalizado configurado, transmitindo maior profissionalismo e autoridade.

{% hint style="warning" %}
**Recomendação Importante:**

Sugerimos fortemente a criação de um subdomínio específico para o acesso à plataforma, ao invés de usar seu domínio principal.

* Ideal: `painel.suaempresa.com.br` ou `app.suaempresa.com.br`.
* **Por que isso é importante?** Utilizar um subdomínio evita conflitos técnicos com o seu site institucional principal e facilita o gerenciamento dos apontamentos de DNS.
  {% endhint %}

#### 1. Preparação e Definição do Endereço

Antes de iniciar a configuração técnica, você precisa possuir um domínio registrado (ex: `suaempresa.com.br`) em um provedor de sua preferência (como Registro.br, GoDaddy, Hostgator, Cloudflare e etc.).

#### 2. Solicitação ao Time de Sucesso (CS)

Definido o subdomínio, informe ao seu gerente de contas (CS). Nosso time técnico preparará o ambiente e gerará as chaves de segurança necessárias para a sua URL exclusiva

#### 3. Configuração Técnica (Apontamento de NS)

Diferente de apontamentos simples (Tipo A ou CNAME), nossa plataforma exige o direcionamento via **NS (Name Server)** para garantir a gestão do certificado de segurança e estabilidade.

1. **Receba os Dados:** Nosso time fornecerá uma lista de servidores (ex: `ns-162.awsdns-20.com`).
2. **Configure no Provedor:** Acesse a zona de DNS do seu domínio e crie entradas do tipo NS apontando **apenas o subdomínio** escolhido para os endereços fornecidos

#### 4. Validação e Ativação

Após realizar a configuração, a propagação dos DNS pode levar algumas horas. Uma vez propagado, nosso sistema validará a conexão e emitirá o certificado de segurança (SSL) automaticamente.

Você poderá confirmar que o processo foi concluído quando o status do domínio aparecer como "Finalizado" nas configurações da sua conta.

#### **Resultado Final**

Uma vez finalizado, tanto o acesso web quanto a API da plataforma responderão diretamente pela sua URL personalizada, reforçando a autoridade da sua marca junto aos seus clientes finais.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.helena.app/configurando-sua-plataforma/configuracao-inicial/dominio-personalizado.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
