HomeDicas Rápidas

Como Criar um Bot no Telegram: Guia Completo para Principiantes

Aprende passo a passo como criar um bot no Telegram usando o BotFather. Descobre as funcionalidades, comandos e dicas para configurar o teu bot do zero.

Guia · Telegram

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.

Telegram
Bots & Automação
Leitura em 4 min

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

Os bots do Telegram são criados e geridos através do @BotFather, o bot oficial da plataforma.
Após a criação, recebes um token de autenticação único para controlar o teu bot via API.
O nome de utilizador do bot não pode ser alterado depois de criado, por isso escolhe com cuidado.
Os bots suportam comandos, teclados personalizados, pagamentos, mini apps e muito mais.
Existe um ambiente de testes separado para desenvolver sem afetar os utilizadores reais.

Criar um bot no Telegram começa sempre no mesmo sítio: o @BotFather. Segue estes cinco passos.

1
Abre o @BotFather no Telegram

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.

Passo 1 - BotFather no Telegram
2
Envia o comando /newbot

Escreve e envia o comando para iniciar o processo de criação. O BotFather vai guiar-te pelos passos seguintes de forma interativa.

/newbot
Passo 2 - Comando /newbot
Passo 2 - Resposta do BotFather
3
Escolhe um nome para o bot

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.

4
Define o nome de utilizador

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.

Passo 4 - Nome de utilizador do bot
5
Guarda o token de autenticação

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.

Passo 5 - Token de autenticação
Passo 5 - Token gerado pelo BotFather
💡

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.

⌨️
Comandos e teclados

Os bots reconhecem comandos que começam com / e podem apresentar teclados com opções predefinidas, tornando a interação muito mais intuitiva.

🔍
Modo inline

Com o modo inline ativo, qualquer utilizador pode invocar o bot em qualquer conversa escrevendo @nomedobot, sem abrir uma conversa separada.

💳
Pagamentos

Os bots aceitam pagamentos via fornecedores externos. Para produtos digitais, o Telegram exige que os pagamentos sejam feitos em Telegram Stars (XTR).

📱
Mini Apps

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.

🤖
Bots geridos por bots

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.

🌐
Web Login

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.

/setdescription Define o texto que os novos utilizadores veem ao abrir o bot pela primeira vez, na caixa “O que este bot pode fazer?”.
/setabouttext Define uma breve descrição no perfil do bot, até 120 caracteres. Aparece quando alguém partilha o bot com outra pessoa.
/setuserpic Define a foto de perfil do bot. Escolhe algo único e reconhecível para que os utilizadores o identifiquem facilmente na lista de conversas.
/setcommands Configura a lista de comandos suportados pelo bot. Aparecem como sugestões quando o utilizador escreve / na conversa.
/setprivacy Controla que mensagens o bot recebe quando é adicionado a grupos. Por padrão, os bots só recebem mensagens que lhes sejam diretamente dirigidas.
/mybots Lista todos os teus bots com controlos para editar as suas definições numa interface moderna e interativa.

O Telegram disponibiliza um ambiente de testes completamente separado do ambiente principal. Podes desenvolver e experimentar o teu bot sem correr riscos.

iOS
Acesso pelo iPhone

Toca 10 vezes no ícone de Definições → Contas → Entrar noutra conta → Teste.

PC
Acesso pelo Telegram Desktop

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
Preciso de saber programar para criar um bot no Telegram?

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.

Posso mudar o nome de utilizador do bot depois de criado?

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.

Quantos bots posso criar no Telegram?

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.

Os bots do Telegram são gratuitos?

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.

O bot pode funcionar em grupos e canais?

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.

Conclusão
Criar um bot no Telegram é mais simples do que parece

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.

Este artigo foi útil?

Muito obrigado pelo feedback!
Generic selectors
Exact matches only
Search in title
Search in content
Post Type Selectors