Como Criar um Bot no Telegram: Guia Completo para Principiantes
O BotFather trata de tudo em menos de 5 minutos. Aprende a criar, configurar e lançar o teu primeiro bot no Telegram do zero.
O Telegram é muito mais do que uma aplicação de mensagens. A plataforma permite criar bots totalmente personalizados, capazes de automatizar tarefas, responder a utilizadores, aceitar pagamentos e até gerir outros bots.
Se sempre quiseste saber como criar um bot no Telegram, este guia explica tudo o que precisas de saber, desde o primeiro comando até às configurações mais avançadas.
⚡ O que precisas de saber
Criar um bot no Telegram começa sempre no mesmo sítio: o @BotFather. Segue estes cinco passos.
Procura por @BotFather na barra de pesquisa do Telegram e abre a conversa. É o bot oficial da plataforma para criar e gerir todos os teus bots. Certifica-te que o perfil tem o visto azul de verificação.
Escreve e envia o comando para iniciar o processo de criação. O BotFather vai guiar-te pelos passos seguintes de forma interativa.
/newbot
Este é o nome de exibição que aparece nas conversas e no perfil do bot. Pode ser qualquer texto, incluindo espaços. Por exemplo: Assistente do Ricardo.
O nome de utilizador é usado em menções e no link t.me/nomedobot. Obrigatoriamente tem que terminar em “bot”, como meuassistentebot ou MeuAssistente_bot. Atenção: não pode ser alterado depois de criado.
O BotFather vai gerar um token único, uma sequência de texto parecida com 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw. Guarda-o em segurança. É através deste token que controlas o bot via API. Nunca o partilhes publicamente.
Dica: Se perderes o token ou ele ficar comprometido, podes gerar um novo a qualquer momento enviando o comando /token ao @BotFather e selecionando o bot em questão.
Os bots do Telegram vão muito além de responder a mensagens. Aqui estão as principais funcionalidades disponíveis.
Os bots reconhecem comandos que começam com / e podem apresentar teclados com opções predefinidas, tornando a interação muito mais intuitiva.
Com o modo inline ativo, qualquer utilizador pode invocar o bot em qualquer conversa escrevendo @nomedobot, sem abrir uma conversa separada.
Os bots aceitam pagamentos via fornecedores externos. Para produtos digitais, o Telegram exige que os pagamentos sejam feitos em Telegram Stars (XTR).
Integra aplicações web completas dentro do Telegram com interfaces em JavaScript. Mais de 500 milhões de utilizadores interagem com mini apps todos os meses.
Uma funcionalidade avançada permite que um bot crie e gira outros bots, útil para plataformas que querem que os seus clientes lancem agentes próprios.
Permite autenticar utilizadores em websites externos usando a conta Telegram, oferecendo um login rápido e sem necessidade de registo adicional.
O BotFather disponibiliza vários comandos para configurares o teu bot depois de criado. Estes são os mais importantes.
O Telegram disponibiliza um ambiente de testes completamente separado do ambiente principal. Podes desenvolver e experimentar o teu bot sem correr riscos.
Toca 10 vezes no ícone de Definições → Contas → Entrar noutra conta → Teste.
Abre as Definições → pressiona Shift + Alt + clique direito em “Adicionar Conta” → seleciona “Servidor de Teste”.
Neste ambiente, crias um novo utilizador e um novo bot via @BotFather, e envias os pedidos para o endereço https://api.telegram.org/bot<token>/test/MÉTODO. As alterações não afetam o bot em produção.
Importante: O ambiente de testes é completamente separado. Terás que criar uma conta nova e um bot novo para o usar. Os tokens do ambiente principal não funcionam no ambiente de testes e vice-versa.
| Funcionalidade | Disponível | Notas |
|---|---|---|
| Comandos e menus | ✅ Grátis | Disponível para todos os bots |
| Teclados personalizados | ✅ Grátis | Reply keyboards e inline keyboards |
| Modo inline | ✅ Grátis | Requer ativação no BotFather |
| Pagamentos digitais | ✅ Grátis | Apenas via Telegram Stars (XTR) |
| Mini Apps / Web Apps | ✅ Grátis | Requer desenvolvimento web |
| Gestão de outros bots | ✅ Grátis | Funcionalidade avançada |
Para criar o bot via BotFather não precisas de saber programar. No entanto, para o bot fazer algo útil, como responder a mensagens ou executar tarefas, precisas de desenvolver um backend que comunique com a API do Telegram. Existem bibliotecas disponíveis em Python, JavaScript, PHP e outras linguagens que facilitam bastante este processo.
Não. O nome de utilizador do bot é permanente e não pode ser alterado após a criação. O nome de exibição pode ser alterado com o comando /setname no BotFather, mas o @username fica definitivo. Escolhe bem antes de confirmar.
Podes criar até 20 bots por conta de utilizador no Telegram. Se precisares de mais, terás que usar contas diferentes. Cada bot tem o seu próprio token e pode ser gerido de forma independente.
Sim, criar e usar bots no Telegram é completamente gratuito. A plataforma não cobra pela criação nem pelo uso da API. Os únicos custos envolvidos são os da infraestrutura que usas para hospedar o código do bot, como um servidor ou serviço de cloud.
Sim. Os bots podem ser adicionados a grupos e canais do Telegram. Em grupos, por padrão funcionam em modo de privacidade e só recebem mensagens que lhes sejam diretamente dirigidas. Este comportamento pode ser alterado nas definições do BotFather, embora não seja recomendado exceto quando estritamente necessário.
Em menos de 5 minutos tens um bot criado e pronto a configurar. O @BotFather trata de todo o processo de registo e geração do token, e a API do Telegram oferece um conjunto de funcionalidades que vai desde simples respostas automáticas até mini apps completas com pagamentos integrados.
O limite é a tua imaginação — e o código que consegues escrever ou adaptar. Com as bibliotecas disponíveis para as linguagens mais populares, nunca foi tão acessível construir ferramentas úteis dentro do Telegram.
Gostaste deste artigo?
Recebe o resumo tech da semana com as principais novidades.
iOS 27: a lista oficial de iPhones que vão receber
A Apple confirmou os iPhones compatíveis com o iOS 27. Há boas notícias: nenhum modelo do iOS 26 ficou de…
Telegram volta ao Apple Watch com app nativa e mensagens
O Telegram tem nova app nativa para Apple Watch, com mensagens, GIFs, vídeo e mais. Eis como funciona e como…
Apple revela todas as novidades dos serviços com o iOS
A Apple anunciou as novidades dos seus serviços para o outono. Maps com IA, dividir contas no Wallet, álbuns iCloud…
Nova memória do ChatGPT vai lembrar-se de tudo (e chega
A nova memória do ChatGPT é mais inteligente e atualiza-se sozinha. A grande novidade: a função Dreaming vai chegar também…
WhatsApp no iPhone: assim podes organizar melhor as conversas
O WhatsApp no iPhone deixa agora escolher que listas de conversas ficam visíveis e esconder o resto num menu. Há…
Siri no iOS 27: o que a Apple vai mostrar
A nova Siri no iOS 27 chega à WWDC a 8 de junho. Descobre o que é facto confirmado e…
Este artigo foi útil?
Redator de tecnologia no Minuto Digital. Especializado em smartphones, inteligência artificial e inovação digital. Explico as últimas novidades tech de forma simples, clara e direta.
