Formatos de link do Telegram
Cada linha mostra o link web normal, o esquema de URL do iPhone e o formato do Android. Substitua os placeholders em maiúsculas por valores reais.
| Conteúdo | Link web | iPhone (esquema de URL) | Android |
|---|---|---|---|
| Canal, grupo ou usuário | https://t.me/USERNAME | tg://resolve?domain=USERNAME | intent://t.me/USERNAME#Intent;package=org.telegram.messenger;scheme=https;end |
| Postagem específica | https://t.me/CHANNEL/123 | tg://resolve?domain=CHANNEL&post=123 | intent://t.me/CHANNEL/123#Intent;package=org.telegram.messenger;scheme=https;end |
| Bot com parâmetro de início | https://t.me/BOTNAME?start=PAYLOAD | tg://resolve?domain=BOTNAME&start=PAYLOAD | intent://t.me/BOTNAME?start=PAYLOAD#Intent;package=org.telegram.messenger;scheme=https;end |
| Convite privado | https://t.me/+INVITE_CODE | tg://join?invite=INVITE_CODE | intent://t.me/+INVITE_CODE#Intent;package=org.telegram.messenger;scheme=https;end |
O tg:// ignora a página web t.me que pede aos visitantes para tocar em “Abrir no Telegram”.
A maioria dos aplicativos não documenta oficialmente seus esquemas de URL. Os formatos abaixo são aqueles que o DSLink usa em produção hoje, mas uma atualização de aplicativo pode alterá-los – teste em um dispositivo real antes de codificar um esquema em seu próprio aplicativo ou site.
Usando o esquema em um site
Um esquema de URL pode ir direto para um link. No iPhone, o Safari pede que o visitante confirme antes de trocar de aplicativo:
<a href="tg://resolve?domain=USERNAME">Open in Telegram</a>No Android, você pode adicionar um substituto da web à própria intenção. Se o aplicativo estiver faltando, o Chrome abrirá o URL substituto em vez de falhar:
intent://t.me/USERNAME#Intent;package=org.telegram.messenger;scheme=https;S.browser_fallback_url=https%3A%2F%2Ft.me%2FUSERNAME;endDois limites se aplicam em todos os lugares. Se o aplicativo não estiver instalado, um esquema simples não fará nada de útil – o iOS mostra um erro. E navegadores integrados em aplicativos como Instagram, TikTok ou X geralmente bloqueiam ou ignoram esquemas personalizados, que é exatamente onde a maioria dos links é acessada.
A alternativa sem código: um link inteligente
Um link inteligente DSLink envolve tudo isso em um URL curto. Em um telefone, ele tenta o formato correto do aplicativo para o dispositivo, recorre à página web do Telegram se o aplicativo estiver ausente e envia visitantes de desktop diretamente para o site. Você compartilha um link em todos os lugares e recebe estatísticas de cliques.
Perguntas frequentes
O que é o esquema de URL tg://?
tg:// é o esquema que o aplicativo Telegram registra. tg://resolve?domain=NAME abre um canal, grupo, usuário ou bot; tg://join?invite=CODE abre um convite privado.
Posso passar um parâmetro start para um bot do Telegram?
Sim: tg://resolve?domain=BOTNAME&start=PAYLOAD. O payload pode conter letras, dígitos, sublinhados e hífens.
O que acontece se o aplicativo Telegram não estiver instalado?
Um esquema de URL simples falha: o iOS mostra um erro e nada abre. Sempre emparelhe-o com um substituto da web - no Android com S.browser_fallback_url na intenção ou use um link inteligente DSLink, que retorna à página da web automaticamente.