O que o bot sabe fazer

  • Agendamento de serviços: escolha de data e horário, confirmação e lembrete na véspera.
  • Respostas a perguntas frequentes e encaminhamento das perguntas difíceis para uma pessoa.
  • Recebimento de pedidos, com registro numa planilha e aviso para o dono.
  • Disparos de mensagens e lembretes programados.
  • Coleta de dados de sites — por exemplo, preços ou novos anúncios — e envio de um resumo.
  • Mini app do Telegram: uma interface completa com botões e formulários dentro do próprio Telegram.

Passo 1. Crie o bot no BotFather

  1. No Telegram, abra o bot oficial @BotFather e envie o comando /newbot.
  2. Escolha um nome e um nome de usuário para o bot — ele precisa terminar em “bot”.
  3. O BotFather vai enviar um token — uma sequência longa do tipo 123456:ABC…. É a chave do seu bot: não publique nem mostre para ninguém.

O ideal é guardar o token num arquivo .env na pasta do projeto (com a linha BOT_TOKEN=…) e dizer ao agente onde ele está. Assim o token não vai parar no código nem na conversa.

Passo 2. Descreva o roteiro

Descreva o que o bot faz do ponto de vista do cliente: o que ele escreve, o que vê como resposta e o que acontece depois. Por exemplo:

Crie um bot de Telegram para agendamentos numa barbearia. O cliente toca em /start, escolhe o serviço (corte, barba ou combo — os preços estão em prices.txt), uma data nos próximos 14 dias e um horário livre entre 10h e 21h. Depois do agendamento, o bot envia uma confirmação e, 2 horas antes, um lembrete. Eu, como dono, recebo uma mensagem a cada novo agendamento. O token está no .env.

Passo 3. Rode e teste

O agente escreve o código, instala as bibliotecas necessárias e roda o bot no terminal integrado — você vê cada comando e a saída dele. Abra o bot no Telegram e percorra o roteiro como se fosse um cliente. Se algo der errado, descreva o que você fez e o que viu: o agente encontra a causa nos logs e corrige.

Passo 4. Mini app (opcional)

Se os botões no chat não bastarem, peça um mini app do Telegram: um catálogo, um carrinho ou um formulário de agendamento com calendário. Na seção “App” do NEO, você pode abri-lo no modo Telegram — com os parâmetros de inicialização e o tema do Telegram — e testar sem sair do NEO.

Passo 5. Para o bot funcionar 24 horas

Enquanto o bot roda no seu computador, ele só funciona quando o computador está ligado. Para funcionar 24/7, ele precisa ficar num servidor: o agente sugere opções e prepara tudo para colocar no ar. Os planos do NEO incluem hospedagem própria: no Pro, um projeto fica no ar 24 horas por dia; no Max, três.

Segurança

  • O token é como uma senha. Se ele vazar, revogue no @BotFather com o comando /revoke e gere um novo.
  • Colete só os dados de clientes que forem necessários e avise para que servem.
  • Antes de liberar o bot para todo mundo, percorra o roteiro inteiro você mesmo — inclusive com erros: data errada, toque duplo, cancelamento.