Documentação

Procurando uma resposta rápida? Veja as perguntas frequentes.

Como encurtar um link

O que é: Cole seu URL longo, clique em Encurtar link, e você receberá um link curto pronto para copiar ou compartilhar.

Funciona sem conta. O primeiro link está pronto em cinco segundos. Opcionalmente: abaixo do formulário, expanda Opções avançadas, se quiser definir sua própria parte final, senha, data de expiração ou limite de cliques desde o início.

Se você criar uma conta (gratuita), você receberá também um painel com histórico de links, estatísticas e edição.

Partes finais personalizadas (parte após cutty.dev/)

O que é: Você substitui o aleatório cutty.dev/k3n9X por algo legível, por exemplo, cutty.dev/oferta.

Você pode usar letras, números, sublinhados e traços (3–40 caracteres). Espaços e caracteres diacríticos poloneses não são válidos para URLs — são automaticamente limpos.

Detalhe importante: uma parte final criada é sua para sempre. Mesmo que você exclua o link depois, ninguém mais ocupará a mesma parte final. Prometemos estabilidade, pois alguém pode imprimir seu código QR ou enviar seu link por SMS.

Links protegidos por senha

O que é: Você adiciona uma senha ao criar (ou editar). O visitante vê uma pequena janela "digite a senha" antes de ser redirecionado.

Útil para: catálogos apenas para clientes, documentos beta, conteúdo para pessoas específicas. Após digitar a senha uma vez, o visitante não precisa digitá-la novamente por 24 horas — o navegador lembra.

Detalhe importante: após 5 tentativas falhadas do mesmo endereço IP, bloqueamos adivinhações por 5 minutos. Bots não entrarão à força.

Códigos QR

O que é: Cada link recebe automaticamente um código QR. Clique em QR no painel (ou imediatamente após a criação) e baixe PNG (para tela) ou SVG (para impressão).

Use em folhetos, cartazes, cartões de visita, em menus de restaurantes. Eles são lidos imediatamente em qualquer smartphone moderno — sem instalar aplicativos.

Detalhe importante: os PNGs são armazenados em cache, então o download é imediato mesmo em conexões lentas.

UTM (parâmetros de campanhas de marketing)

O que é: Se você gerencia campanhas de marketing, provavelmente conhece UTM — esses ?utm_source=facebook&utm_medium=ads pedaços que dizem ao Google Analytics de onde veio o clique.

Você os adiciona ao criar o link. O cutty os cola automaticamente ao URL final em cada clique — sem cópia manual, sem risco de sintaxe corrompida.

Detalhe importante: se o URL final já tiver UTM, os seus preenchem os campos faltantes — nunca sobrescrevem os UTM já existentes.

Datas de expiração e limites de cliques

O que é: Você faz com que o link feche automaticamente após um prazo ou após um número específico de cliques.

A expiração é ideal para eventos: "essa oferta termina na quinta-feira às 21:00". O limite de cliques é ideal para ações limitadas: "as primeiras 100 pessoas recebem um desconto". Você pode usar ambos ao mesmo tempo.

Após a expiração, o visitante vê uma pequena página "esse link expirou" — sem tela de erro em branco. Você pode depois desbloquear o link editando o status para "ativo" no painel.

Estatísticas de cliques

O que é: Para cada link, você vê um gráfico diário de cliques (últimos 30 dias), fontes principais (de onde veio o clique — Twitter, e-mail, indicação) e países principais.

Não coletamos dados de visitantes. Não os rastreamos em outras páginas. Contamos apenas cliques, hasheamos o endereço IP (para que ninguém inflate as estatísticas recarregando a página) e salvamos o código do país de onde veio o clique.

Disponível no painel após criar uma conta. Links anônimos não coletam estatísticas detalhadas — para isso é necessário uma conta.

Exportar para CSV

O que é: Baixe todos os seus links com metadados como um arquivo de planilha. Abre no Excel, no Google Sheets, no Numbers.

Útil para: relatórios mensais, cópias de segurança, compartilhar dados de campanhas com colegas da equipe. Contém a parte final, o URL final, o número de cliques, a data de criação, expiração e status.

Links anônimos e "reivindicação" após criar uma conta

O que é: Sem conta, você pode encurtar até 30 links por hora (de um mesmo endereço IP). Seus links são atribuídos a um pequeno cookie em seu navegador.

Se depois criar uma conta, o painel perguntará se você quer "reivindicar" seus links anônimos — um clique e eles ficam permanentemente associados à sua conta. Nada é perdido.

Sem reivindicação, seus links anônimos continuam funcionando — mas você não pode editá-los nem ver suas estatísticas, e desaparecerão do seu painel se você limpar os cookies.

API e integrações

A API pública está nos planos (no plano pago). Por enquanto, tudo é feito pelo painel.

Algo não está funcionando?

Escreva para [email protected]. Respondo no mesmo dia. Status da aplicação: /api/healthz.

Funcionalidades avançadas

Para além de encurtar, palavras-passe e validade, o cutty tem muitos extras que pode ativar ao criar ou editar um link:

• Análise de cliques — uma divisão por dispositivo e navegador, uma distribuição de 24 horas e exportação para CSV dos acessos em bruto. Sem cookies, sem perfis.
• Tags, pastas e pesquisa — organize os links no painel e encontre-os num segundo.
• Redirecionamentos inteligentes — destinos diferentes por país ou dispositivo, mais rotação A/B por peso.
• Ativação agendada — o link entra em funcionamento à hora que definir.
• Webhooks — uma notificação para o seu endpoint a cada clique.
• Cartão de pré-visualização personalizado — título, descrição e imagem para os crawlers de redes sociais.
• Página link-in-bio — uma mini página de links em cutty.dev/seu-nome, em quatro temas.
• Importação em lote e códigos QR num ZIP — crie e descarregue muitos links de uma vez.

Tudo isto também pode ser feito por programação — através da API e do MCP.