O iOS não tem um encurtador de URL integrado, e o Share sheet do Safari copia o endereço completo. A solução é o aplicativo Atalhos: um Atalho de quatro ações que pega qualquer URL que você estiver vendo, envia para a API de um encurtador e coloca o link curto na sua área de transferência. Depois de uma configuração de três minutos, são dois toques a partir de qualquer aplicativo que possa compartilhar um link.
Esta é a versão para celular de como encurtar uma URL, que cobre o caminho do desktop e do painel. Se você quer a mesma coisa dentro de um aplicativo que está construindo, em vez de no seu próprio celular, os tutoriais de JavaScript e Python cobrem a mesma chamada de API em código.
Você precisa de uma coisa antes de começar: uma chave de API. Qualquer encurtador com uma API REST funciona; os nomes de campo abaixo são do Elido, e a visão geral da API gratuita de encurtador de URL documenta o formato da requisição.
Crie o Atalho: Quatro Ações
Abra o Atalhos, toque no sinal de mais e adicione estas ações nesta ordem.
1. Receber URLs. No painel de detalhes do Atalho (o botão de informações), ative Show in Share Sheet e defina a entrada aceita como somente URLs. Esse último detalhe importa: deixe como Anything e o Atalho vai aparecer quando você compartilhar uma foto, o que é ruído.
2. Get Contents of URL. Aponte-a para https://api.elido.app/v1/links e abra a seta para expandir as opções:
- Method: POST
- Headers:
Authorization=Bearer YOUR_API_KEY, eContent-Type=application/json - Request Body: JSON, com um campo,
destination_url, cujo valor é a variável Shortcut Input
3. Get Dictionary Value. Chave short_url, a partir da saída da ação anterior. A resposta já vem interpretada, então não há nenhuma etapa de JSON para escrever.
4. Copy to Clipboard. Adicione Show Notification depois dela se quiser uma confirmação; sem isso, o Atalho roda silenciosamente e você nunca tem certeza absoluta de que funcionou.
Dê a ele um nome curto. É esse nome que você vai tocar no Share sheet, e é o que você vai dizer para a Siri.
Precisa de uma chave para apontar? Crie uma no plano gratuito, cole-a no campo do cabeçalho, e o Atalho funciona já na primeira execução.
Usando o Atalho
Abra uma página no Safari, toque em Compartilhar, role até o seu Atalho, toque nele. O link curto está na sua área de transferência; cole-o onde você for.
Funciona em qualquer lugar que ofereça um Share sheet, o que é a maior parte do iOS: Mail, Notas, App Store, Fotos com um link de álbum compartilhado, navegadores de terceiros, a maioria dos aplicativos de leitura. O guia do usuário do Atalhos da Apple cobre os detalhes da integração com o Share sheet, e o Atalhos também pode ser executado a partir de um esquema de URL se você quiser acioná-lo a partir de outra automação.
Dois refinamentos que vale a pena adicionar depois que a versão básica funcionar:
- Tags UTM automáticas. Insira uma ação Text antes da chamada à API que anexe
?utm_source=…&utm_medium=…à Shortcut Input, e passe esse texto comodestination_url. Todo link compartilhado do seu celular passa então a carregar as mesmas tags dos links criados em um computador, o que é a diferença entre um relatório limpo e uma pilha de tráfego sem tags. Veja convenções de nomenclatura UTM para um esquema que sobrevive a uma equipe. - Um slug que você escolhe. Adicione um segundo campo ao corpo JSON se quiser um final legível em vez de um aleatório. O que é um custom back-half explica onde isso aparece.
Quando Não Funciona
Dois erros respondem por quase toda execução malsucedida.
O primeiro é uma ação Get Contents of URL deixada em GET. O padrão é GET, a linha Method é fácil de passar despercebida, e a API responde com um 404 ou 405 que o Atalhos reporta como um erro pouco esclarecedor.
O segundo é o Request Body definido como Form em vez de JSON. Form envia application/x-www-form-urlencoded, a API não consegue ler o destino a partir disso, e você recebe um 400 que parece um problema do servidor.
Se os dois estiverem certos e ainda assim falhar, adicione uma ação Quick Look logo depois de Get Contents of URL. Ela mostra a resposta bruta, e a mensagem de erro da API geralmente nomeia o campo ao qual ela se opôs.
As Alternativas, Sinceramente
O Atalho não é o único caminho, e nem sempre é o certo.
Se você encurta um link uma vez por mês, abrir o site do encurtador no Safari e colar é suficiente e não custa nada para configurar. Se você faz isso semanalmente, o Atalho recupera seus três minutos de configuração em menos de duas semanas. E se você está gerenciando campanhas em vez de compartilhar um link ocasional, um painel com pastas, tags e relatórios de cliques é um lugar melhor do que um celular; o aplicativo móvel cobre o mesmo terreno com gerenciamento de links de verdade por trás dele.
Uma nota de segurança. A chave de API vive dentro do Atalho, então trate o Atalho como uma credencial. Não a publique em um link do iCloud compartilhado ou em uma galeria pública, e se um colega a quiser, envie a receita em vez do arquivo, para que ele cole a própria chave. Use uma chave restrita apenas à criação de links onde a API oferecer suporte a esse escopo.
Leia a série cornerstone
Este artigo insere-se no tutorials cluster. A versão geral é como encurtar uma URL, o lado da medição é como rastrear cliques em links, e a API gratuita de encurtador de URL documenta a requisição que o Atalho está enviando.
Relacionados no Blog
Perguntas frequentes
Como encurto uma URL no iPhone?
Crie um Atalho de quatro ações no aplicativo Atalhos que recebe URLs, envia a URL para a API de um encurtador, lê short_url na resposta e a copia para a área de transferência. Ative Show in Share Sheet e ele se torna uma ação de dois toques a partir do Safari ou de qualquer aplicativo que possa compartilhar um link.
O iPhone tem um encurtador de URL integrado?
Não. O iOS não tem um encurtador do sistema, e o Share sheet do Safari copia a URL completa. O aplicativo Atalhos é a forma nativa de adicionar um, porque ele pode chamar qualquer API HTTP e colocar o resultado na sua área de transferência sem um aplicativo de terceiros no meio do caminho.
Posso encurtar um link no iPhone sem um aplicativo?
Sim, abrindo o site de um encurtador no Safari e colando a URL ali. Funciona, mas custa uma troca de aba, uma colagem e uma cópia toda vez. O Atalho existe para eliminar essas três etapas para quem encurta links com mais frequência do que apenas ocasionalmente.
A abordagem do Atalhos é segura para minha chave de API?
A chave fica armazenada dentro do Atalho, então trate o Atalho como uma credencial. Não a publique em um link do iCloud compartilhado ou em uma galeria de Atalhos, e use uma chave restrita apenas à criação de links. Se você compartilhar o Atalho com um colega, peça que ele cole a própria chave.
Por que meu Atalho não retorna nada ou dá erro?
As duas causas mais comuns são uma ação Get Contents of URL configurada como GET em vez de POST, e um corpo de requisição enviado como Form em vez de JSON. Verifique se o Request Body é JSON com um campo destination_url, e se o cabeçalho Authorization traz Bearer seguido de um espaço e a chave.
O Atalho pode adicionar tags UTM automaticamente?
Sim. Adicione uma ação Text que anexe os parâmetros da sua campanha à URL recebida antes da chamada à API, e passe esse texto como o destino. É a forma mais fácil de garantir que todo link compartilhado a partir de um celular carregue as mesmas tags dos links criados em um computador.
Experimente Elido
Cole uma URL, obtenha um link curto
Sem cadastro. O link vive 30 dias. Cadastre-se para mantê-lo para sempre.
Grátis, sem necessidade de registo · 2 por dia