Seu próprio bot no Telegram
Aula 14 de 22 do curso “Agentes para a vida”. Grátis, com animações e teste.
Um agente no mensageiro
O melhor agente é o que está por perto. Um chat num site precisa ser aberto, achado e lembrado de quem ele é toda vez. Um bot no Telegram mora onde você já passa o dia. O briefing já vem dentro, então você escreve curto: «+ comprar ração do gato» ou «quanto eu gastei com táxi este mês?». Aliás, o bot é grátis: o Telegram não cobra para criar bots. Você só paga o passo de IA no Zapier ou no n8n, e os dois têm começo grátis.
BotFather: um bot em 2 minutos
Todo bot do Telegram nasce num bot só: o @BotFather. Procure por ele e confira o selo azul, porque tem muita cópia falsa. Mande /newbot. Primeiro ele pede um nome, que todo mundo vê, tipo «Ajudante da Liza». Depois um username, que é como acham o bot. Regra do Telegram: o username tem que terminar em «bot», por exemplo liza_helper_bot. Se estiver ocupado, coloque números. O BotFather responde com uma sequência longa de números e letras. É o token, e ele é o próximo slide.
O token: nunca para ninguém
O token não é a senha da sua conta, é a chave do bot inteiro. Com ele dá para ler o que mandam pro bot e responder em nome dele. O Telegram diz com todas as letras: guarde o token em segurança. Onde ele nunca pode ficar: num print, num chat com amigos, num repositório público no GitHub e nem no texto do briefing da IA. Onde pode: nas configurações de conexão do Zapier ou do n8n, que escondem ele. Se vazar mesmo assim, sem pânico: no BotFather, com /token você gera um novo e o antigo para de funcionar.
Responder só a você
O username do bot é público: qualquer pessoa pode achar e mandar mensagem. Sem proteção, seu bot responde todo mundo e o passo de IA gasta seu limite com ensaio dos outros. A solução é o chat ID. É um número que vem junto com cada mensagem, e o seu é sempre o mesmo. Descobrir é fácil: mande mensagem pro bot, abra uma execução de teste no Zapier ou no n8n e procure o campo chat id. Depois coloque um filtro logo após o gatilho: se o chat ID não for o seu, para. No n8n já existe uma opção pronta para isso: Restrict to Chat IDs. É o mesmo menor privilégio da aula de conectores, só que para um bot.
Montando a corrente
A corrente é a da aula passada, só muda a entrada. Passo 1: o gatilho «mensagem nova no Telegram». No n8n ele se chama Telegram Trigger; no Zapier procure o app Telegram Bot. É ali que entra o token. Passo 2: um filtro pelo seu chat ID. Passo 3: o passo de IA com o briefing do próximo slide. Passo 4: resposta no mesmo chat e, se for tarefa ou gasto, também uma linha no Google Planilhas. Dica: teste o briefing antes num chat comum com dez mensagens suas e só depois conecte o bot.
Faça você: o ajudante de bolso
Crie um bot no BotFather e coloque o token só nas configurações do Zapier ou do n8n. Monte os quatro passos do slide anterior e cole o briefing abaixo no passo de IA. Confira três coisas: o bot responde «+ comprar pão», responde uma pergunta e fica quieto se você escrever de outra conta. Ainda não quer conectar nada? Copie o briefing num chat comum e escreva como se fosse o bot: você vai ver como funciona.
Teste-se
- O que fazer primeiro?
Resposta certa: Gerar um token novo no BotFather. Um token novo deixa o antigo inútil na hora. Quem quer que tenha visto, a chave não serve mais. - Como parar isso?
Resposta certa: Um filtro depois do gatilho: responder só ao chat ID dela. O filtro por chat ID age antes do passo de IA, então mensagem de estranho não gasta limite nem dinheiro. - Por que o BotFather não aceita o nome?
Resposta certa: O username de um bot precisa terminar em «bot». É a regra do Telegram para todo bot: liza_helper_bot serve, liza_helper não. - Onde o token deve ficar?
Resposta certa: Nas configurações de conexão do Telegram no n8n. As configurações de conexão escondem o token, e é bem ali que ele é necessário: o n8n usa ele para receber mensagens e responder.
← «Se → então»: piloto automático sem código Um time de agentes: o QG da viagem →