Deep Links do Telegram: Rastreie Links t.me e de Início de Bot

Um deep link do Telegram é um endereço web t.me que abre uma conversa, canal, grupo ou bot específico quando tocado, opcionalmente transportando um parâmetro que o seu bot recebe. As formas comuns são https://t.me/username para abrir uma conversa, https://t.me/username?text=Hi para a abrir com um rascunho pré-preenchido, e https://t.me/YourBot?start=payload para abrir um bot e entregar-lhe um payload. Toca-se no link, o Telegram abre no sítio certo, e para um bot o payload chega do lado do servidor.

Essa última parte é o que torna o Telegram diferente da maioria dos canais de mensagens. O WhatsApp não lhe diz qual anúncio gerou um toque em wa.me. Os bots do Telegram dizem: o payload ?start= é entregue ao seu bot quando o usuário inicia, para que a atribuição possa estar incorporada no próprio link. Para links simples de conversa e canal ainda precisa de um redirecionamento à frente para ver o clique, da mesma forma que precisaria com qualquer deep link de mensagens. Este artigo cobre os dois casos.

Os Padrões de Links t.me

Há uma família de endereços e alguns parâmetros. O Telegram documenta-os na referência de deep links (consultado em 2026-07-18).

Abrir uma conversa ou canal: https://t.me/username. Funciona para nomes de usuário públicos, canais e grupos. É o link que coloca numa bio ou numa assinatura de email.
Pré-preencher um rascunho: https://t.me/username?text=Hello%20Acme. A mensagem é codificada em URL e cai na caixa de rascunho. O usuário toca em enviar, o Telegram não a envia por ele.
Abrir um bot com um payload: https://t.me/YourBot?start=spring-promo. O Telegram abre o bot, mostra o botão Start, e ao toque entrega spring-promo ao bot no comando /start.
Adicionar o usuário a um grupo através de um bot: https://t.me/YourBot?startgroup=payload. Mesma ideia, dirigida à configuração de grupos em vez de uma conversa privada.

O esquema tg:// (tg://resolve?domain=username) existe mas é frágil. Browsers e webviews dentro de aplicações bloqueiam ou removem esquemas personalizados, por isso um link tg:// impresso falha mais vezes do que funciona. Use t.me, que é um URL https normal que resolve de forma limpa e pode ficar atrás de um link curto. A mecânica de porque é que o t.me sequer encaminha para dentro da aplicação são os mecanismos nativos do SO descritos em deep links para aplicações móveis sem SDK.

Porque É Que o Parâmetro Start É a Vitória de Atribuição

A maioria dos canais de click-to-chat é de sentido único: o toque abre a conversa e não lhe diz nada. Os bots do Telegram quebram esse padrão porque o payload ?start= é entregue ao código do seu bot. O Facebook Messenger faz o mesmo com o seu parâmetro ref; o WhatsApp é o que fica em silêncio. O Telegram limita-o a 64 caracteres e permite apenas letras, números, hífenes e underscores, e recomenda base64url se precisar de empacotar dados estruturados, segundo a documentação de deep linking de bots.

Assim, o payload pode transportar uma etiqueta de campanha, um id de referência, ou um id de registro codificado. Quando o usuário toca em Start, o seu bot lê-o e sabe que o clique veio, digamos, da newsletter de maio em vez da publicação fixada no canal. Sem pixel, sem ginástica de webhooks, sem ler etiquetas de dentro do corpo de uma mensagem. O sinal está no /start que o seu bot já trata.

O limite importa. Sessenta e quatro caracteres chegam para nl-may-hero ou um id base64url curto, mas não para uma string UTM completa. O padrão que escala é um id compacto em ?start=, com os dados de campanha legíveis por humanos guardados contra esse id no seu próprio sistema.

A Camada de Redirecionamento

Para links de conversa e canal, e para unificar o rastreamento em toda a superfície do Telegram, coloque um link curto à frente do URL t.me. O cliente toca em s.elido.me/tg, a sua edge registra o clique, depois redireciona para https://t.me/YourBot?start=nl-may. Do lado do cliente, o fluxo é idêntico a tocar diretamente em t.me.

Do seu lado, três coisas mudaram:

O clique fica registrado. O redirecionamento dispara um evento com timestamp, geolocalização, dispositivo e os parâmetros UTM que chegaram no link curto, para que o Start que o seu bot registra um segundo depois seja associável a uma campanha específica.
O destino é editável. Troque o nome de usuário do bot, o canal, ou o payload ?start= sem reimprimir um QR ou editar um anúncio ativo. Se mover uma campanha de um bot para outro, muda o destino uma única vez.
Os dados de campanha são portáteis. s.elido.me/tg?utm_source=email&utm_medium=newsletter&utm_campaign=may captura as etiquetas no redirecionamento, mesmo que o t.me ignore strings de query que não reconhece.

Esta é a mesma camada descrita em como rastrear campanhas UTM de ponta a ponta sem um CDP, e é exatamente a abordagem que o guia de click-to-chat do WhatsApp usa para o wa.me. O Telegram só lhe dá um segundo sinal por cima através do payload do bot.

Se quer links do Telegram editáveis e mensuráveis sem ter de construir o redirecionamento por conta própria, os deep links do Elido ficam à frente de qualquer destino t.me e registram cada toque. Pode configurar um no plano gratuito.

Uma Configuração Prática

Três links curtos cobrem a maioria dos fluxos do Telegram:

Link geral: s.elido.me/tg para o seu bot ou canal principal, usado no rodapé do site, na bio, e na assinatura de email. Capta o tráfego genérico de entrada.
Link de campanha: um por campanha ativa, s.elido.me/tg-may-nl, apontando para o mesmo bot com um payload ?start= específico da campanha. Usado no anúncio ou newsletter específicos.
Link impresso em QR: s.elido.me/tg-shop para colocações físicas, com um payload que nomeia a colocação para que o seu bot saúde quem lê o código com contexto.

Cada link mapeia para um modelo UTM e uma etiqueta descritiva como surface:newsletter · channel:telegram · campaign:may. Configure-os em /links e as etiquetas orientam os filtros em análises. Filtre por channel:telegram para ver todos os toques gerados pelo Telegram em todas as campanhas.

A Ressalva da Mensagem Pré-Preenchida

O rascunho ?text= é um verdadeiro corte de fricção: o cliente chega à conversa com uma mensagem escrita e só tem de tocar em enviar. Mas o Telegram nunca a envia automaticamente, e isso é deliberado. Um link que pudesse enviar uma mensagem silenciosamente em seu nome seria um vetor de spam, por isso o Telegram exige o toque. Escreva o pré-preenchimento de forma a que o toque pareça natural, e não construa um fluxo que dependa de a mensagem ser enviada antes de o usuário agir.

Para bots, não há rascunho visível nenhum. O payload ?start= é invisível para o usuário e entregue diretamente ao bot, o que é mais limpo para o rastreamento porque não há nenhum id de rastreamento a ficar estranhamente numa mensagem que o cliente possa ver.

Superfícies de Código QR

Uma grande parte do tráfego de click-to-chat do Telegram vem de leituras, não de toques na web. Alguém está numa loja, num evento, ou com um folheto na mão, e lê um código que abre o seu bot ou canal. Do impresso à conversa é um dos usos mais fortes do padrão link-curto-depois-t.me.

Duas regras mantêm a tiragem impressa útil:

O QR codifica s.elido.me/<slug>, nunca t.me/... diretamente. Codificar t.me bloqueia o destino, mata as análises de leituras, e desperdiça a tiragem impressa se o bot ou canal mudar.
Cada colocação recebe o seu próprio link curto e o seu próprio payload ?start=, para que o código da montra, o código do folheto, e o código da embalagem sejam linhas separadas que pode comparar. Considerações de design como zona de silêncio, contraste e correção de erros são as mesmas de qualquer colocação, cobertas em códigos QR dinâmicos vs estáticos.

O Que Não Funciona

Três padrões que parecem razoáveis e falham:

Codificar o link t.me em bruto num QR ou anúncio. Sem dados de cliques, sem controlo do destino, e um recurso morto no dia em que o nome de usuário mudar. Imprima o link curto, sempre.

Enfiar uma string UTM dentro de ?start=. O limite de 64 caracteres e o conjunto de caracteres restrito vão truncá-la ou rejeitá-la. Use um id curto e resolva-o para os dados completos da campanha do seu lado.

Depender de tg:// para qualquer coisa impressa ou compartilhada. Os esquemas personalizados são bloqueados por browsers e webviews dentro de aplicações, por isso o link falha para uma parte dos usuários sem fallback nenhum. Mantenha o tg:// interno e encaminhe o caminho público através de t.me atrás de um link curto, com o encaminhamento inteligente a tratar de qualquer fallback por dispositivo da forma como os smart links fazem.

O Telegram é o canal raro onde o deep link pode transportar atribuição por si só. Combine o payload ?start= do bot com um redirecionamento à frente, e obtém tanto o clique como o Start, ligados à campanha que os gerou.

Relacionado no Blog

Perguntas frequentes

Como crio um deep link do Telegram?

Pegue no endereço t.me da sua conta, canal, grupo ou bot e acrescente um parâmetro. Para um bot, https://t.me/YourBot?start=payload abre o bot e envia-lhe o payload quando o utilizador toca em Start. Para uma pessoa ou canal, https://t.me/username abre a conversa, e acrescentar ?text= pré-preenche uma mensagem em rascunho. Codifique a mensagem e mantenha o payload de início dentro de 64 caracteres, usando apenas letras, números, hífenes e underscores.

O que é o parâmetro start num link do Telegram?

O parâmetro start é uma string curta num deep link de bot, escrita como ?start=payload. Quando alguém abre https://t.me/YourBot?start=payload e toca em Start, o Telegram entrega esse payload ao seu bot na mensagem /start. O seu bot lê-o e pode saudar o utilizador, desbloquear conteúdo, ou registrar de onde veio o clique. É o único canal de mensagens onde a atribuição está incorporada no link em vez de acrescentada por fora.

Posso pré-preencher uma mensagem do Telegram?

Sim, para um link de pessoa ou canal. https://t.me/username?text=Hello abre a conversa com Hello escrito no rascunho. A mensagem não é enviada automaticamente, o utilizador tem de tocar em enviar, o que é uma funcionalidade de segurança do Telegram, não uma falha. Os links de bot usam ?start= em vez de ?text=, e o bot recebe o payload silenciosamente em vez de o mostrar como rascunho.

É possível rastrear cliques num link t.me?

Um link t.me simples não lhe dá nenhum dado de cliques, porque o Telegram não lhe reporta o toque de volta. Coloque um link curto à frente: o cliente toca no seu link curto, o redirecionamento registra o clique com hora, dispositivo e etiquetas de campanha, e depois encaminha para o t.me. Para bots, o payload ?start= acrescenta um segundo sinal, do lado do servidor, que o seu bot pode registrar quando o utilizador efetivamente inicia.

Qual é a diferença entre t.me e tg:// links?

t.me é um endereço web https normal que o Telegram resolve e abre na aplicação, o que o torna seguro para imprimir, partilhar, e colocar atrás de um link curto. tg:// é um URL de esquema de aplicação em bruto que só funciona se o Telegram estiver instalado e pode ser bloqueado ou removido por browsers e aplicações. Use t.me para tudo o que é voltado para o cliente, e trate tg:// no máximo como um fallback interno.

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