Como criar um bot no Telegram

Passo 1 — Falar com o BotFather

O BotFather é o bot oficial do Telegram que cria outros bots. Procure por @BotFather na busca do aplicativo e confira o selo de verificado antes de conversar: existem imitações com nomes parecidos.

Mande /newbot. Ele vai pedir duas coisas, nesta ordem: o nome de exibição (pode ter espaço e acento, e dá para mudar depois) e o @username (precisa terminar em "bot" e não pode ser mudado nunca mais).

Passo 2 — Guardar o token

Assim que o @username é aceito, o BotFather devolve uma linha parecida com 123456789:AAH... Isso é o token, e é a única credencial do bot.

Quem tem o token pode mandar mensagem como o seu bot, ler o que chega nele e tirá-lo do ar. Não cole em grupo, não mande por e-mail e não guarde em bloco de notas compartilhado. Se vazar, mande /revoke ao BotFather: o token antigo morre e um novo nasce.

Passo 3 — Dar cara ao bot

Ainda no BotFather, três comandos mudam o que o lead vê antes de tocar em Iniciar — e é essa tela que decide se ele toca:

• /setdescription — o texto do cartão de apresentação, que aparece antes do primeiro contato.
• /setabouttext — a linha curta que aparece no perfil do bot.
• /setuserpic — a foto. Bot sem foto passa impressão de bot abandonado.
• /setcommands — a lista de comandos que aparece no menu ao lado do campo de texto.

Passo 4 — Fazer o bot responder

Um bot recém-criado não faz nada: ele existe, mas ninguém está do outro lado. Para ele responder, alguma aplicação precisa receber as mensagens que chegam nele.

Existem dois jeitos. No *polling*, um programa seu pergunta ao Telegram, de tempos em tempos, se chegou mensagem — simples de testar e ruim de manter no ar. No *webhook*, você registra um endereço e o Telegram entrega a mensagem nele assim que ela chega — é o que toda operação em produção usa, porque não depende de o seu programa ficar perguntando.

É neste ponto que você escolhe entre programar do zero ou usar uma plataforma. A Spectra Flow faz essa parte: você cola o token e o bot passa a responder, com webhook registrado e monitorado.

Passo 5 — Colocar o bot no grupo ou canal

Se o seu produto é um grupo VIP, o bot precisa estar lá dentro como administrador. Adicione-o pelo próprio Telegram, em Membros → Adicionar, e promova a administrador.

As permissões que importam para vender são poucas e específicas: convidar usuários (para gerar o link de entrada de quem comprou) e restringir membros (para tirar quem perdeu o acesso). Sem a primeira, o cliente paga e não recebe convite; sem a segunda, a assinatura vence e a pessoa continua dentro.

Passo 6 — Cobrar

O Telegram não processa pagamento por você. Quem gera a cobrança é um gateway — e o bot só mostra no chat o que o gateway devolveu: um PIX copia e cola ou um link de cartão.

O ponto que mais quebra aqui é a confirmação: o gateway precisa avisar quando a cobrança foi paga, num endereço registrado. Sem isso, a venda acontece e a entrega não.

O que um bot NÃO consegue fazer

Vale saber antes de desenhar a operação em cima de algo que não existe. Estes limites são do Telegram, não da ferramenta que você escolher:

• Um bot não cria grupo nem canal. Só usuários criam — o bot é adicionado depois.
• Um bot não manda a primeira mensagem. Ele só fala com quem já falou com ele.
• Um bot não adiciona pessoas a grupos à força: ele gera um convite, e a pessoa entra.
• Um bot não lê conversas privadas de outras pessoas, nem mensagens de grupo em que não foi mencionado (a menos que o modo privacidade seja desligado pelo dono).
• Um bot não substitui a sua conta: ações que exigem uma conta de usuário continuam exigindo você.

Depois que o bot existe

A partir daqui as perguntas mudam de assunto: como apresentar os planos, como recuperar quem não pagou, como saber de onde veio cada lead. É o trabalho de operação, e é o que a Spectra Flow organiza no Control Room.

Perguntas frequentes