# Configuração do Domínio

## Configurando o seu próprio domínio na Bolten

Oferecemos aos nossos clientes a opção de escolher a rota de acesso ao modelo para um subdomínio customizado.

Isso significa que o seu cliente poderá acessar o ecosssistema Bolten através de `<meu-subdominio>.<meu-dominio>.com.br` ou `<meu-subdominio>.bolten.io` , garantindo uma experiência unificada dentro do ecossistema do parceiro.

<figure><img src="https://1580422610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaHm1VFs056Yg2At7HGkE%2Fuploads%2FYoxE4QQXHLlgjS0KVgmO%2Fezgif-3e34e2445ef865.gif?alt=media&#x26;token=e8e9a836-f46a-4fa5-a005-a2f43774d18a" alt=""><figcaption></figcaption></figure>

**A configuração pode ser feita de 2 formas: a partir de um domínio que o parceiro já possui ou criando um novo subdomínio Bolten via painel do Parceiro.**

| Opção 1                                                                    | Opção 2                                                             |
| -------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| <mark style="color:purple;">**`<subdominio>.<meu-dominio>.com.br`**</mark> | <mark style="color:purple;">**`<meu-subdominio>.bolten.io`**</mark> |

### **Qual a diferença entre as 2 opções?**

**Não há diferença de funcionalidades oferecidas para quem usa um subdomínio próprio ou o subdomínio Bolten (com final&#x20;*****bolten.io*****).**

A primeira opção é a alternativa para parceiros que queiram deixar seu modelo em um domínio totalmente customizado, sem a exposição do nome "Bolten" na URL.

**Ela requer que o usuário tenha adquirido previamente o domínio**, em serviços como [Registro.br](https://registro.br/), [Hostinger](https://www.hostinger.com.br/) ou [GoDaddy](https://www.godaddy.com/). É um pouco mais complexa, pois exige que o parceiro realize uma configuração de apontamento de DNS nesse serviço.

Esse processo leva cerca de 5 minutos e é feito pelo próprio parceiro, seguindo o passo-a-passo fornecido na seção "Meu Domínio" da Bolten. Isso garante que o nome "Bolten" não aparecerá na URL.

> **Nota importante: a partir de 12/01/2026 não é mais possível utilizar domínios completos na&#x20;*****opção 1*****. Isso significa que, caso você seja dono de `minha-super-loja.com.br`, somente é possível utilizar algum subdomínio deste domínio (por exemplo: `crm.minha-super-loja.com.br` ou `app.minha-super-loja.com.br` , mas não `minha-super-loja.com.br` )**

A segunda opção é a alternativa para clientes que não querem ter o trabalho de adquirir o seu próprio domínio ou realizar configurações complexas. É só solicitar o subdomínio Bolten na seção "Meu Domínio" e dentro de alguns minutos ele será disponibilizado automaticamente a você!

#### **Opção 1) Configurando um subdomínio a partir de um domínio seu**

1\) No menu lateral do Painel do Parceiro, **clique em "Meu Domínio"**

<figure><img src="https://1580422610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaHm1VFs056Yg2At7HGkE%2Fuploads%2FuBHIQlGfDtnBjDPBGelt%2Fimage.png?alt=media&#x26;token=91a40589-56e2-487f-8ab8-eb4d512d7698" alt=""><figcaption></figcaption></figure>

2\) Para solicitar um domínio, marque a primeira opção e **preencha os campos com o nome do seu domínio e do provedor de serviços em que ele foi adquirido**. Caso o seu provedor de serviços não esteja na lista, clique em "Outro". Em seguida, **clique em "Solicitar"**.

O domínio deve seguir o formato `<subdominio>.<meu-dominio>.com.br` , sem barras (não é suportado o uso de rotas específicas dentro de um domínio já em uso).

<figure><img src="https://1580422610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaHm1VFs056Yg2At7HGkE%2Fuploads%2Fp2lkhqT3nE7fvAzqWHoV%2Fimage.png?alt=media&#x26;token=3dccc485-977c-4af1-8ca0-7c64a1fb7129" alt=""><figcaption></figcaption></figure>

3\) Caso o seu subdomínio seja válido, a sua solicitação deve ir direto para a etapa "Aguardando sua Ação". Caso não vá para esta etapa, aguarde alguns minutos e tente solicitar o seu subdomínio novamente.

<figure><img src="https://1580422610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaHm1VFs056Yg2At7HGkE%2Fuploads%2FENVeZj5SkxzBhgeCV1lu%2Fimage.png?alt=media&#x26;token=18fd1652-5cab-48b8-bd27-ddd1fd0f03ee" alt=""><figcaption></figcaption></figure>

Ao chegar nessa etapa, siga as instruções informadas na seção "**Configurar Registro CNAME**" dentro da sua registradora para realizar o apontamento informado. Você pode clicar em "**Ver tutorial para...**" para ver instruções específicas da sua registradora de como realizar o apontamento. Esse botão só aparece caso tenhamos a instrução específica para a sua registradora.

De forma geral, todas as registradoras possuem um processo parecido para criar o apontamento CNAME. Você pode usar o vídeo abaixo como referência:

4\) Após realizar o apontamento acima, dentro de algumas horas (de 1h a 48h), seu modelo deve automaticamente estar funcionando no endereço informado.

Você pode acompanhar o status da solicitação nesta mesma tela (ele é atualizado automaticamente). Você também pode atualizar o status manualmente, ao clicar no botão "**Checar Status**".

Um e-mail é enviado automaticamente para você quando esse processo for concluído.

<figure><img src="https://1580422610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaHm1VFs056Yg2At7HGkE%2Fuploads%2FA5wSlT7DaybXEybIWqFk%2Fimage.png?alt=media&#x26;token=afd9e4e1-c7be-4bfa-af26-44da4f70507f" alt=""><figcaption></figcaption></figure>

**Caso esse processo tome mais de 48h sem atualização de Status,** **veja essa seção.**

<figure><img src="https://1580422610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaHm1VFs056Yg2At7HGkE%2Fuploads%2F1R6VWdnF2y6Ii0AMzl1x%2Fimage.png?alt=media&#x26;token=a680e3f6-2e09-4fdf-803a-f47d0ba2a67c" alt=""><figcaption></figcaption></figure>

#### **Opção 2) Configurando um novo subdomínio**

1\) No menu lateral do Painel do Parceiro, **clique em "Meu Domínio"**

<figure><img src="https://1580422610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaHm1VFs056Yg2At7HGkE%2Fuploads%2FuBHIQlGfDtnBjDPBGelt%2Fimage.png?alt=media&#x26;token=91a40589-56e2-487f-8ab8-eb4d512d7698" alt=""><figcaption></figcaption></figure>

2\) Para solicitar um novo subdomínio, marque a segunda opção e **preencha o campo com o nome do subdomínio que você deseja usar**. Não é necessário adicionar sufixos (.com, .br), pois ele terá obrigatoriamente o final `bolten.io` .

<figure><img src="https://1580422610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaHm1VFs056Yg2At7HGkE%2Fuploads%2FJsL8ed5L2MPV3Cj78MXk%2Fimage.png?alt=media&#x26;token=7b1cc9a4-4c80-4e67-8206-5d5bddaf9738" alt=""><figcaption></figcaption></figure>

3\) Nesse caso, o processo é completamente automático. Ele inicia-se no status "**Domínio Solicitado**" e deve, dentro de 1h, ser automaticamente transicionado para o estado de "**Domínio Criado**".

Você também pode clicar em "**Checar Status**" para atualizar o status manualmente.

<figure><img src="https://1580422610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaHm1VFs056Yg2At7HGkE%2Fuploads%2Foeyf66FzTWo0KkIVJlJm%2Fimage.png?alt=media&#x26;token=fe490f7d-6e94-4d18-a74d-339da6b3a323" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1580422610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaHm1VFs056Yg2At7HGkE%2Fuploads%2FyA7ZbUkvX1uZwhgah4aw%2Fimage.png?alt=media&#x26;token=f5eddc08-1650-465b-96d0-2e18210810f1" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1580422610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaHm1VFs056Yg2At7HGkE%2Fuploads%2FGfOi6mabOLHvJ9hzT0nN%2Fimage.png?alt=media&#x26;token=d021cdb9-dde7-4900-a012-825c09ca7962" alt=""><figcaption></figcaption></figure>

Você também deve receber um e-mail quando esse processo for concluído.

Caso esse processo não seja concluído em até 12h, [contacte o Suporte Técnico](https://wa.me/5511941304545?text=Ol%C3%A1%2C%0D%0A%0D%0AGostaria+de+acionar+o+suporte+tecnico) da Bolten.

#### **Acompanhando o status da sua solicitação**

Os pedidos de apontamento são processados dentro de 48h. O parceiro pode acompanhar o status da sua solicitação no [**painel "Meu Domínio"**](https://app.bolten.io/pt/partners/domain_requests/new).

<figure><img src="https://1580422610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaHm1VFs056Yg2At7HGkE%2Fuploads%2FqpVnUPY4hoCjD2UPjBEh%2Fimage.png?alt=media&#x26;token=b9da9148-4edd-4a7c-a9ab-4eff61442484" alt=""><figcaption></figcaption></figure>

Caso o parceiro queira fazer alguma alteração no seu domínio depois de já ter feito a solicitação, ele pode:

* Alterar o domínio desejado, a cada 5 minutos, caso o domínio ainda não tenha sido provisionado (status **Pendente**);
* Alterar o domínio desejado caso ele tenha sido rejeitado por nossos administradores (status **Rejeitado**);

**Somente é permitido o uso de 1 domínio por parceiro.**

Caso deseje realizar alguma alteração no domínio existente após a solicitação já ter sido feita, entre em contato com a nossa equipe de [Suporte Técnico](https://wa.me/5511941304545?text=Ol%C3%A1%2C%0D%0A%0D%0AGostaria+de+acionar+o+suporte+tecnico).

#### **O que fazer caso minha solicitação tenha sido rejeitada?**

Solicitações são rejeitadas devido ao uso de nomes de subdomínios repetidos ou que sejam considerados inapropriados pela moderação da Bolten.

Caso sua solicitação tenha sido rejeitada, selecione outro nome (seja para domínio ou subdomínio) e clique novamente em "Solicitar".

<figure><img src="https://1580422610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaHm1VFs056Yg2At7HGkE%2Fuploads%2F4bnFPcVZyNXhNFAgR3VG%2Fimage.png?alt=media&#x26;token=ba8229b5-6342-45b9-8ae0-b9117be42fba" alt=""><figcaption></figcaption></figure>

#### **O que fazer caso minha esteja parada em "Aguardando Ação do Cliente" por mais de 48h?**

Caso seu apontamento esteja parado no status "**Aguardando Ação do Parceiro**" / "**Aguardando sua Ação**" por um longo período de tempo, isso indica que o apontamento para o CNAME indicado não foi feito corretamente pelo parceiro. Revise a sua configuração ou entre em contato com o suporte de sua registradora para assegurar-se que o apontamento está correto.

<figure><img src="https://1580422610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaHm1VFs056Yg2At7HGkE%2Fuploads%2FhIQAQ6JM33tZOacm4rLs%2Fimage.png?alt=media&#x26;token=5666fa8d-7d15-4ddf-9084-bd39c32897dc" alt=""><figcaption></figcaption></figure>

Para diagnosticar se o apontamento está feito corretamente, você pode usar o serviço [DNSChecker](https://dnschecker.org/), inserindo o seu subdomínio no campo de busca e selecionando a opção **CNAME**.

Ao realizar a busca, todas as entradas devem exibir o valor `whitelabel.bolten.io` . Se isso acontecer, o seu apontamento está correto.

<figure><img src="https://1580422610-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaHm1VFs056Yg2At7HGkE%2Fuploads%2FpVINzlWjmu8QOd36LKi0%2Fimage.png?alt=media&#x26;token=d5c7f02e-344d-4658-851b-1e8a11a9fe93" alt=""><figcaption></figcaption></figure>

Caso o apontamento esteja correto e ainda assim você não conseguir acessar o seu subdomínio, entre em contato com a nossa equipe de [Suporte Técnico](https://wa.me/5511941304545?text=Ol%C3%A1%2C%0D%0A%0D%0AGostaria+de+acionar+o+suporte+tecnico).

#### **Limitações do uso de domínios próprios**

Não é possível utilizar rotas específicas de um domínio que já esteja sendo utilizado. Por exemplo, caso o parceiro tenha uma página ativa já populada em `<meu-dominio>.com.br` , não é possível usar `<meu-dominio>.com.br/crm` como URL de acesso à Bolten.


---

# 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://bolten.gitbook.io/bolten-docs/configuracoes-avancadas/configuracao-do-dominio.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.