Inícios de bot no Telegram: o que são e como usar o parâmetro start
Equipe Booming Social · · 1 min de leitura
O que conta como início de bot, como funciona o link com ?start= e como acompanhar os resultados no seu próprio bot.
Quando alguém abre um bot pela primeira vez e toca em Iniciar, o Telegram envia o comando /start para o bot. É isso que o serviço de inícios de bot entrega: contas iniciando o seu bot.
O link do bot
Todo bot tem um nome de usuário que termina em "bot", e o link dele é t.me/nomedobot. Você encontra o nome no BotFather ou na tela de informações do próprio bot.
O parâmetro start
O Telegram aceita links no formato t.me/nomedobot?start=valor. Quem abre esse link e toca em Iniciar faz o bot receber "/start valor", o que permite saber de onde a pessoa veio: uma campanha, um parceiro, um código de indicação.
Regras do valor, definidas pelo Telegram:
- até 64 caracteres;
- apenas letras, números, sublinhado e hífen.
O serviço de inícios de bot aceita o link com ou sem o parâmetro. Se você usa start para rastrear origem, crie um valor próprio para o pedido e separe esses inícios dos demais nos seus registros.
Como acompanhar
O Telegram não mostra um contador público de inícios. O acompanhamento é feito pelo próprio bot: quantos /start ele recebeu, de quais contas e com qual parâmetro. Se o seu bot grava esses eventos em um banco de dados ou planilha, compare o período antes e depois do pedido.
Antes de pedir
- Deixe o bot ligado, respondendo ao /start.
- Confira se o link termina no nome do bot (com "bot" no final).
- Se usar start, teste o link você mesmo antes de colar no pedido.
O status do pedido, a contagem inicial e quanto falta aparecem em Meus pedidos, e o que não for entregue volta para o saldo.