logo
DomíniosComeçando•

Conectar seu próprio domínio à CodeQR

Use seu próprio domínio nos links curtos e QR codes da CodeQR. O que preparar, quantos domínios cada plano permite e o que muda depois que ele entra no ar.

Avatar for undefined
CodeQR Team
Equipe de Conteúdo

Um domínio personalizado substitui o domínio da CodeQR na frente de cada link e QR code que você cria: go.acmestore.com/verao em vez de um endereço compartilhado. O link funciona exatamente igual — a diferença é que ele leva o seu nome, e quem vê reconhece para onde está indo.

Disponibilidade

  • Plano: Starter ou superior. O plano gratuito tem limite de 0 domínios personalizados e usa um domínio compartilhado da CodeQR.
  • Onde: Domínios, na barra lateral.

Quantos domínios cabem em cada plano:

  • Gratuito — nenhum.
  • Starter — 1 domínio.
  • Pro — 5 domínios.
  • Business — 10 domínios.
  • Advanced — 50 domínios.
  • Enterprise — 1000 domínios.

Antes de começar

  • Tenha um domínio cujo DNS você possa alterar. A compra acontece fora da CodeQR; qualquer registrador serve.
  • Use um subdomínio, não o site. A própria janela avisa: "Não use o domínio principal do seu site ou das suas lojas—alterar o DNS deles derrubaria seu site." Um subdomínio como go. ou qr. é gratuito de criar e não oferece risco. Escolher o domínio certo para seus links curtos percorre a decisão.
  • Saiba onde fica o seu DNS. Às vezes é o registrador, às vezes a Cloudflare, às vezes a hospedagem. É lá que o registro precisa entrar.

Passos

  1. Abra Domínios e selecione Adicionar Domínio.
  2. Digite o endereço em Domínio. Ele é convertido para minúsculas automaticamente, então GO.ACMESTORE.COM vira go.acmestore.com.
  3. Opcional: preencha Página de Destino com o endereço que deve abrir quando alguém acessar o domínio sozinho. Veja Redirecionar a raiz do domínio para o seu site.
  4. Selecione Adicionar domínio.

A janela Adicionar Domínio com o painel Recomendações aberto e um subdomínio digitado

O domínio passa a aparecer na página Domínios com o status Pending Verification — esse texto aparece em inglês mesmo com a interface em português — e o registro de DNS que você precisa criar:

O card do domínio com o status de verificação pendente, o contador de cliques e os botões Atualizar e Editar

  1. Crie o registro no seu provedor de DNS, como descrito em Apontar seu domínio com CNAME ou registro A.
  2. Volte e selecione Atualizar. Assim que o DNS se propagar, o status muda e o domínio começa a servir os links.

O que muda quando o domínio entra no ar

  • Novos links e QR codes passam a oferecer o domínio no campo Link Curto. Se você marcar Domínio Principal, ele vem selecionado.
  • Os links antigos não mudam de endereço. Um link criado em um domínio da CodeQR continua nele; o endereço que você já divulgou nunca muda sozinho.
  • A análise continua no mesmo lugar. Cliques e escaneamentos do novo domínio entram na mesma Análise do resto do espaço de trabalho.
  • O plano pago tira a marca da CodeQR do que o visitante vê, que é a outra metade de parecer da sua marca — veja Remover a marca CodeQR dos links e QR codes.

Gerenciar domínios fora do painel

Domínios só são gerenciados pelo painel. A referência da API lista endpoints de domínio, mas eles não estão disponíveis: uma requisição a https://api.codeqr.io/domains devolve uma página HTML com 404, enquanto outros endpoints respondem normalmente com a mesma chave. A ferramenta MCP list_domains chama esse mesmo endpoint, então devolve a página de erro em vez dos seus domínios.

Automações não devem depender de endpoints de domínio hoje. Já links e QR codes em um domínio personalizado são criados pelos endpoints normais, informando o domínio:

curl -X POST https://api.codeqr.io/links \
  -H "Authorization: Bearer codeqr_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/cardapio","domain":"go.example.com","key":"verao"}'

Verifique se funcionou

Com o domínio verificado, crie um link nele e peça os cabeçalhos:

curl -sSI https://go.example.com/verao
HTTP/2 302
location: https://example.com/cardapio

Um 302 com o seu destino em location significa que o domínio está servindo os seus links. O clique aparece na Análise em poucos minutos.

Solução de problemas

Invalid domain

O endereço não é um nome de host válido. Informe só o domínio, sem https://, sem caminho e sem porta — go.acmestore.com, não https://go.acmestore.com/.

O domínio fica parado em verificação pendente

O registro de propriedade ainda não foi visto. Confira o registro no seu provedor e leia Corrigir um domínio personalizado que não funciona, que cobre o proxy da Cloudflare, os registros CAA e os casos em que o DNS parece certo e não está.

Nada acontece ao selecionar Adicionar domínio em um espaço gratuito

O plano gratuito não comporta domínio personalizado, e hoje a interface não avisa — a requisição é recusada em silêncio. Mude para o Starter ou superior e adicione o domínio.

Recebi um e-mail dizendo que meu domínio precisa ser configurado

Um domínio que continua inválido gera um lembrete aos 14 dias e outro aos 28. Aos 30 dias ele é suspenso para revisão manual. Corrigir o registro de DNS resolve.

Artigos relacionados