logo
LinksComeçando•

Crie um link curto e ajuste as opções avançadas

Crie um link curto na CodeQR, escolha o domínio e a chave, deixe uma anotação interna e encontre a opção avançada que resolve o seu caso.

Avatar for undefined
CodeQR Team
Equipe de Conteúdo

Um link curto na CodeQR é um endereço vivo: você decide para onde ele leva, pode trocar esse destino depois de já ter compartilhado, e cada visita é registrada. Esta página cria um e aponta a opção que resolve o que trouxe você aqui.

Disponibilidade

  • Plano: todos, inclusive o gratuito. A quantidade de links por ciclo depende do plano; cada opção avançada tem a própria exigência, listada abaixo.
  • Onde: Links na barra lateral e depois Adicionar Link. O mesmo construtor abre quando você edita um link existente.

Antes de começar

  • Tenha o destino em mãos — o endereço completo, começando com https://.
  • Decida em qual domínio o link vai morar. Um domínio compartilhado da CodeQR funciona na hora; um domínio seu precisa ser conectado antes e deixa o link com a sua cara.
  • Tudo aqui pode ser alterado depois, menos uma coisa: a chave em Link Curto. Trocá-la quebra todas as cópias já compartilhadas.

Passos

  1. Abra Links e clique em Adicionar Link.
  2. Cole o endereço em URL de destino. A CodeQR lê a página e preenche as prévias à direita.
  3. Escolha o domínio em Link Curto e digite o final que você quer. Deixar como Opcional gera um final aleatório; os dois ícones acima do campo geram uma chave aleatória ou pedem uma sugestão à IA.
  4. Opcional: escolha uma Pasta, adicione tags ou ligue Usar como modelo para reaproveitar essas configurações no próximo link.
  5. Clique em Criar link.

URL de destino, Link Curto, Pasta e Usar como modelo no construtor de links da CodeQR

O link aparece no topo de Links, pronto para copiar.

Escolha a opção que resolve o seu problema

Tudo abaixo da divisória Opcional é uma chave que você liga agora ou depois.

Num workspace gratuito as chaves pagas aparecem, mas o salvamento é recusado com o motivo exato, nomeando cada opção envolvida (a mensagem vem em inglês): You can only use custom link preview and link expiration on a Starter plan. Upgrade to Starter to use these features.

Deixe um recado para a equipe em Comentários

Comentários é um campo de texto guardado com o link e visível apenas dentro da CodeQR — o visitante nunca vê. Sirva-se dele para o que a URL não conta: de qual campanha o link é, quem pediu, quando pode ser apagado. Está em todos os planos.

Links com anotação exibem um ícone de documento na lista, ao lado do ícone de raio que marca os links com opções avançadas.

Confira um link antes de compartilhar

Coloque + no fim de qualquer link curto da CodeQR — go.example.com/cardapio-verao+ — e você abre a página pública de inspeção, que mostra para onde o link leva sem segui-lo. Ela funciona para qualquer pessoa, então dá para mandar a um colega que perguntou se o link é seguro.

Faça o mesmo pela API

O mesmo link, com uma requisição:

curl -X POST https://api.codeqr.io/links \
  -H "Authorization: Bearer codeqr_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/blog",
    "domain": "go.example.com",
    "key": "cardapio-verao",
    "comments": "Campanha de agosto — rodapé da newsletter"
  }'

A resposta traz o link pronto e o QR code:

{
  "id": "cmsxmiaps0003pmi0yyolgqp7",
  "domain": "go.example.com",
  "key": "cardapio-verao",
  "url": "https://example.com/blog",
  "shortLink": "https://go.example.com/cardapio-verao",
  "qrCode": "https://api.codeqr.io/qr?url=https://go.example.com/cardapio-verao?qr=1",
  "clicks": 0
}

Um assistente de IA conectado por MCP cria o mesmo link a partir de uma frase — veja Conecte a CodeQR ao Claude, ChatGPT e Cursor com MCP. Para obter a chave antes, veja Crie uma chave de API e escolha as permissões.

Verifique se funcionou

Abra o link curto no navegador: você cai no destino. No terminal, a mesma checagem sem deixar um clique para trás é um pedido de cabeçalhos:

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

O contador de cliques em Links atualiza em segundos, e Análise mostra a visita em poucos minutos.

Solução de problemas

A chave que digitei virou letras aleatórias

A CodeQR gera uma chave aleatória assim que você informa o destino, e essa resposta pode chegar por cima de uma chave digitada um segundo antes. Confira o campo Link Curto mais uma vez antes de clicar em Criar link e redigite se tiver mudado.

Duplicate key: this short link already exists.

Aquele final já está em uso naquele domínio. Escolha outro, ou deixe o campo vazio para receber um aleatório. Links excluídos liberam a chave.

Invalid key.

A chave tem um caractere que não é aceito — um espaço, um acento que não pôde ser convertido ou pontuação. Letras, números, - e / são seguros.

You can only use … on a Starter plan.

A opção que você ligou exige plano pago. A mensagem lista todas as opções envolvidas, então desligar as que você não precisa pode ser suficiente.

O link abre uma página de "não encontrado"

A chave não existe naquele domínio — em geral um erro de digitação, um link excluído ou o domínio errado. Confira a lista em Links e copie o link de lá.

Artigos relacionados