> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getqr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectar um domínio personalizado

> Sirva os links dos seus QR codes a partir do seu próprio subdomínio, como qr.yourbrand.com, em vez do domínio curto compartilhado do GetQR.

Conecte um subdomínio que seja seu, como `qr.yourbrand.com`, para que os novos QR codes usem o seu domínio em vez do domínio curto compartilhado do GetQR. As pessoas veem a sua marca ao escanear, e o GetQR emite e renova o certificado HTTPS para você.

> [!NOTE]
>
> Os domínios personalizados estão em beta e podem ainda não estar disponíveis em todos os workspaces. Se você não vê a aba **Domains** nas configurações da sua conta, o recurso não está ativado para o seu workspace.

## Antes de começar

* Você precisa ter a função **Admin** ou **Editor**. Um **Viewer** pode ver a lista de domínios, mas não pode alterar nada.
* Você precisa ter acesso às configurações de DNS do seu domínio, no seu registrador ou provedor de DNS (por exemplo, Cloudflare, GoDaddy, Namecheap ou Squarespace). Se outra pessoa gerencia o seu DNS, você pode baixar os valores exatos para ela durante a configuração.
* Você pode conectar até 3 domínios por workspace.
* Você conecta um **subdomínio**, não o seu domínio raiz. `qr.yourbrand.com` funciona; `yourbrand.com` e `www.yourbrand.com` não. O seu site e o seu e-mail no domínio raiz não são afetados.

## Conecte o seu domínio

**1. Abra a aba Domains**

Na barra lateral, abra o menu do seu perfil e clique em **My Account**. Depois, selecione a aba **Domains**.

**2. Inicie a configuração**

Clique em **Connect a domain**.

> [!TIP]
>
> Você também pode começar pelo criador de QR codes: abra o menu suspenso de domínios no campo **Custom short link** e clique em **Connect a domain**.

**3. Escolha um subdomínio**

Em **Choose a subdomain**, escolha um prefixo: **qr**, **go**, **scan** ou **link**. Para usar seu próprio prefixo, clique em **Custom** e digite-o no campo **Subdomain**.

**4. Digite o seu domínio raiz**

Em **Your domain**, digite apenas o seu domínio raiz, por exemplo `yourbrand.com`. O GetQR verifica o nome de host completo automaticamente e mostra **Checking availability…**.

**5. Confirme que o nome de host está disponível**

Aguarde a mensagem de que o nome de host está disponível. A prévia em **Your codes will look like** mostra como seus links vão ficar. Clique em **Continue**.

**6. Copie o registro DNS**

Em **Add one DNS record**, copie os valores de **Name** e **Target** com os botões de copiar. O tipo de registro é sempre **CNAME**, e **Proxy** deve ser **DNS only — grey cloud**.

> [!TIP]
>
> Não gerencia o DNS você mesmo? Clique em **Download instructions** para obter um arquivo com os valores exatos para o seu desenvolvedor ou equipe de TI.

**7. Adicione o registro CNAME no seu provedor de DNS**

Em uma nova aba, abra o seu provedor de DNS e adicione um registro CNAME com o **Name** e o **Target** que você copiou. Defina o TTL como Auto (padrão). Veja as [Dicas por provedor](#provider-tips) abaixo.

**8. Adicione o registro CAA, se o GetQR pedir**

Se a tela de configuração mostrar um aviso de CAA, o seu domínio raiz tem um registro CAA que bloqueia a autoridade certificadora do GetQR. Adicione o registro extra mostrado no aviso, que se parece com este:

```text theme={null}
yourbrand.com. CAA 0 issue "letsencrypt.org"
```

Se não houver aviso, pule esta etapa.

**9. Avise o GetQR que o registro foi adicionado**

De volta ao GetQR, clique em **I've added the record**. O GetQR verifica o seu DNS na hora e passa para a tela de verificação.

**10. Aguarde a verificação**

O GetQR verifica automaticamente e configura o HTTPS. A verificação costuma levar até 1 hora, dependendo do seu provedor de DNS e da região. Você pode fechar a janela: o GetQR continua verificando e envia um e-mail quando o domínio estiver no ar.

Para verificar antes, clique em **Check now**.

**11. Teste o seu domínio**

Quando o domínio estiver no ar, você verá que ele está ativo com HTTPS. Abra o link de teste (`your-subdomain/test`) para confirmar que funciona no seu dispositivo e clique em **Done**.

## Dicas por provedor

Cada provedor usa rótulos um pouco diferentes, mas o registro é sempre o mesmo: um registro **CNAME** com o **Name** e o **Target** mostrados no GetQR.

**Cloudflare**

1. Abra os registros DNS do seu domínio raiz.
2. Adicione um registro do tipo **CNAME**.
3. Cole o **Name** (por exemplo `qr`) e o **Target** do GetQR.
4. Desative a nuvem laranja para que o status do proxy mostre **DNS only**.
5. Salve o registro.

> [!WARNING]
>
> O Cloudflare ativa o proxy em novos registros por padrão. Enquanto o registro estiver com proxy (nuvem laranja), o certificado não pode ser emitido e as leituras falham.

**GoDaddy**

1. Abra as configurações de DNS do seu domínio raiz.
2. Adicione um novo registro do tipo **CNAME**.
3. Digite o **Name** do GetQR no campo de nome (host), por exemplo `qr`.
4. Cole o **Target** do GetQR no campo de valor (aponta para).
5. Deixe o TTL no padrão e salve.

**Namecheap**

1. Abra as configurações de DNS do seu domínio raiz.
2. Adicione um novo registro do tipo **CNAME**.
3. Digite o **Name** do GetQR no campo de host, por exemplo `qr`.
4. Cole o **Target** do GetQR no campo de valor (destino).
5. Deixe o TTL em Automatic e salve.

**Google / Squarespace**

Os domínios registrados no Google Domains agora são gerenciados pelo Squarespace.

1. Abra as configurações de DNS do seu domínio raiz.
2. Adicione um registro personalizado do tipo **CNAME**.
3. Digite o **Name** do GetQR no campo de host, por exemplo `qr`.
4. Cole o **Target** do GetQR no campo de dados (valor).
5. Salve o registro.

> [!TIP]
>
> A maioria dos provedores adiciona o seu domínio raiz ao nome automaticamente. Digite apenas a parte do subdomínio (`qr`), não `qr.yourbrand.com`, ou você pode acabar com `qr.yourbrand.com.yourbrand.com`.

## Use o seu domínio nos QR codes

Depois que o domínio estiver no ar, você o escolhe para cada QR code no criador. No campo **Custom short link**, abra o menu suspenso de domínios e selecione o seu domínio. Domínios que ainda estão sendo configurados aparecem na lista com o rótulo **Setting up** e ainda não podem ser selecionados. Veja [Criar um link curto personalizado](/pt-br/short-links/create-short-link).

> [!WARNING]
>
> Os QR codes mantêm o domínio com que foram criados. Os códigos existentes não passam para o seu novo domínio, e remover um domínio faz com que todos os QR codes nele parem de funcionar.

## Configurações

| Configuração | O que faz |
| - | - |
| **Subdomain** | O prefixo do seu nome de host, como `qr`. Apenas letras, números e hifens. `www` não é permitido. |
| **Your domain** | O seu domínio raiz, como `yourbrand.com`. Não inclua um subdomínio aqui. |
| **Type** | Sempre **CNAME**. |
| **Name** | O rótulo do subdomínio a ser digitado no seu provedor de DNS. |
| **Target** | O nome de host do GetQR para o qual o seu registro aponta. Ele é exclusivo do seu domínio, então sempre copie-o do app. |
| **Proxy** | Deve ser **DNS only — grey cloud**. Um registro com proxy bloqueia o certificado. |

## Casos de uso

* **Confiança na marca.** As pessoas veem `qr.yourbrand.com` na prévia do link ao escanear, e não um domínio de terceiros.
* **Campanhas.** Combine o seu domínio com um link curto personalizado, por exemplo `qr.yourbrand.com/summer-menu`.
* **Impressões pequenas.** Um nome de host curto gera um QR code menos denso, que é lido com mais confiabilidade em tamanhos pequenos.

## Problemas comuns

> **Não vejo a aba Domains**
>
> Os domínios personalizados estão em beta e são ativados por workspace. Se a aba não aparece nas configurações da sua conta, o recurso ainda não está disponível para o seu workspace.

> **O botão Connect a domain está desativado**
>
> O seu workspace já tem 3 domínios, o máximo. Remova um para conectar outro. Se você nem vê o botão, você tem a função **Viewer**; peça a um Admin ou Editor.

> **“Use a subdomain such as qr.yourbrand.com”**
>
> Você digitou um domínio raiz. Um domínio raiz exige outro tipo de registro e afetaria o seu site e o seu e-mail. Escolha um prefixo de subdomínio e digite apenas o domínio raiz em **Your domain**.

> **“www is reserved for your website”**
>
> `www` aponta para o seu site, então o GetQR não pode usá-lo. Escolha outro prefixo, como `qr`.

> **“already includes a subdomain”**
>
> Você digitou um subdomínio em **Your domain**, por exemplo `qr.yourbrand.com`. Digite apenas o domínio raiz (`yourbrand.com`) e escolha o prefixo em **Subdomain**.

> **“This domain is already connected to another GetQR account”**
>
> Outro workspace do GetQR já usa esse nome de host. Escolha outro subdomínio ou entre em contato com [help@getqr.com](mailto:help@getqr.com) se achar que é um erro.

> **“That domain can't be connected”**
>
> O nome de host é reservado ou não é permitido. Escolha outro subdomínio.

> **A verificação está demorando**
>
> Alterações de DNS podem levar algum tempo para se propagar. Verifique se o tipo, o nome e o destino do registro correspondem exatamente ao app e se o registro não está com proxy. Veja [Verificar o seu domínio](/pt-br/custom-domains/verify-and-troubleshoot) para saber o que cada status significa.

## Próximos passos

> **[Verificar o seu domínio](/pt-br/custom-domains/verify-and-troubleshoot)**
>
> Confira o status e corrija problemas de DNS ou de certificado.

> **[Criar um link curto personalizado](/pt-br/short-links/create-short-link)**
>
> Use o seu domínio e o seu próprio slug em um QR code.

> **[Funções e permissões](/pt-br/members/roles-and-permissions)**
>
> Veja quem pode conectar e remover domínios.

> **[Imprimir o seu QR code](/pt-br/downloads/printing)**
>
> Imprima somente depois que o seu domínio estiver no ar.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.