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