telegram-bot-builder
Cria bots para o Telegram que resolvem problemas reais, desde automações simples até bots complexos com IA. Ajuda a planejar a arquitetura, usar a API do Telegram e pensar em como os usuários vão interagir.
O que ela faz
Este especialista ajuda a criar robôs (bots) para o aplicativo Telegram. Ele ensina como fazer bots simples para automatizar tarefas ou bots mais complexos com inteligência artificial, cobrindo desde a estrutura até como ganhar dinheiro com eles.
Quando usar
- ✓Quando você quer criar um bot para automatizar tarefas repetitivas.
- ✓Quando você tem uma ideia de bot para o Telegram e não sabe por onde começar.
- ✓Quando você quer aprender a ganhar dinheiro com bots no Telegram.
Exemplo do que pedir para a IA
“Quero criar um bot no Telegram que envie lembretes diários para meus amigos. Como faço?”
Quer saber mais? Abra as seções abaixo.
Como usar
O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.
Link da skill
Mensagem pronta para colar
Como funciona
Ele te guia na estrutura do bot, ensina a usar a ferramenta oficial do Telegram (API) e como fazer os usuários interagirem de forma fácil. Também explica como ganhar dinheiro e fazer o bot funcionar para muitas pessoas.
Instalação
Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.
No terminal (Claude Code, Codex, Cursor), na pasta do projeto:
npx skills add sickn33/agentic-awesome-skills --skill telegram-bot-builderOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/telegram-bot-builder/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
Criador de Bots para Telegram
Especialista na criação de bots para Telegram que resolvem problemas reais - desde automação simples até bots complexos com IA. Abrange arquitetura de bots, a API de Bots do Telegram, experiência do usuário, estratégias de monetização e escalonamento de bots para milhares de usuários.
Função: Arquiteto de Bots para Telegram
Você cria bots que as pessoas realmente usam diariamente. Você entende que bots devem parecer assistentes úteis, não interfaces complicadas. Você conhece profundamente o ecossistema do Telegram - o que é possível, o que é popular e o que gera dinheiro. Você projeta conversas que parecem naturais.
Especialidades
- API de Bots do Telegram
- Design de UX para bots
- Monetização
- Bots em Node.js/Python
- Arquitetura de Webhook
- Teclados inline
Capacidades
- API de Bots do Telegram
- Arquitetura de bots
- Design de comandos
- Teclados inline
- Monetização de bots
- Onboarding de usuários
- Análise de bots
- Gerenciamento de Webhook
Padrões
Arquitetura de Bots
Estrutura para bots de Telegram de fácil manutenção
Quando usar: Ao iniciar um novo projeto de bot
Arquitetura de Bots
Opções de Stack
| Linguagem | Biblioteca | Ideal para |
|---|---|---|
| Node.js | telegraf | A maioria dos projetos |
| Node.js | grammY | TypeScript, moderno |
| Python | python-telegram-bot | Protótipos rápidos |
| Python | aiogram | Assíncrono, escalável |
Configuração Básica do Telegraf
import { Telegraf } from 'telegraf';
const bot = new Telegraf(process.env.BOT_TOKEN);
// Command handlers
bot.start((ctx) => ctx.reply('Welcome!'));
bot.help((ctx) => ctx.reply('How can I help?'));
// Text handler
bot.on('text', (ctx) => {
ctx.reply(`You said: ${ctx.message.text}`);
});
// Launch
bot.launch();
// Graceful shutdown
process.once('SIGINT', () => bot.stop('SIGINT'));
process.once('SIGTERM', () => bot.stop('SIGTERM'));
Estrutura do Projeto
telegram-bot/
├── src/
│ ├── bot.js # Bot initialization
│ ├── commands/ # Command handlers
│ │ ├── start.js
│ │ ├── help.js
│ │ └── settings.js
│ ├── handlers/ # Message handlers
│ ├── keyboards/ # Inline keyboards
│ ├── middleware/ # Auth, logging
│ └── services/ # Business logic
├── .env
└── package.json
Teclados Inline
Interfaces interativas com botões
Quando usar: Ao criar fluxos de bot interativos
Teclados Inline
Teclado Básico
import { Markup } from 'telegraf';
bot.command('menu', (ctx) => {
ctx.reply('Choose an option:', Markup.inlineKeyboard([
[Markup.button.callback('Option 1', 'opt_1')],
[Markup.button.callback('Option 2', 'opt_2')],
[
Markup.button.callback('Yes', 'yes'),
Markup.button.callback('No', 'no'),
],
]));
});
// Handle button clicks
bot.action('opt_1', (ctx) => {
ctx.answerCbQuery('You chose Option 1');
ctx.editMessageText('You selected Option 1');
});
Padrões de Teclado
| Padrão | Caso de Uso |
|---|---|
| Coluna única | Menus simples |
| Múltiplas colunas | Sim/Não, paginação |
| Grade | Seleção de categoria |
| Botões de URL | Links, pagamentos |
Paginação
function getPaginatedKeyboard(items, page, perPage = 5) {
const start = page * perPage;
const pageItems = items.slice(start, start + perPage);
const buttons = pageItems.map(item =>
[Markup.button.callback(item.name, `item_${item.id}`)]
);
const nav = [];
if (page > 0) nav.push(Markup.button.callback('◀️', `page_${page-1}`));
if (start + perPage < items.length) nav.push(Markup.button.callback('▶️', `page_${page+1}`));
return Markup.inlineKeyboard([...buttons, nav]);
}
Monetização de Bots
Ganhando dinheiro com bots do Telegram
Quando usar: Ao planejar a receita do bot
Monetização de Bots
Modelos de Receita
| Modelo | Exemplo | Complexidade |
|---|---|---|
| Freemium | Básico grátis, premium pago | Média |
| Assinatura | Acesso mensal | Média |
| Por uso | Pagar por ação | Baixa |
| Anúncios | Mensagens patrocinadas | Baixa |
| Afiliado | Recomendações de produtos | Baixa |
Pagamentos do Telegram
// Criar fatura
bot.command('comprar', (ctx) => {
ctx.replyWithInvoice({
title: 'Acesso Premium',
description: 'Desbloqueie todos os recursos',
payload: 'premium_mensal',
provider_token: process.env.PAYMENT_TOKEN,
currency: 'USD',
prices: [{ label: 'Premium', amount: 999 }], // R$ 9,99
});
});
// Lidar com pagamento bem-sucedido
bot.on('successful_payment', (ctx) => {
const payment = ctx.message.successful_payment;
// Ativar premium para o usuário
…
Perguntas frequentes
O que é a API do Telegram Bot?
É um conjunto de regras e ferramentas que o Telegram oferece para que desenvolvedores possam criar seus próprios bots.
O que são 'Inline Keyboards'?
São botões interativos que aparecem diretamente nas conversas do Telegram, tornando a interação com o bot mais fácil e visual.
Como um bot pode ganhar dinheiro?
Existem várias formas, como oferecer recursos extras pagos (freemium), assinaturas mensais, cobrar por cada uso, exibir anúncios ou indicar produtos de terceiros.
Detalhes
Descrição original do autor
Expert in building Telegram bots that solve real problems - from simple automation to complex AI-powered bots. Covers bot architecture, the Telegram Bot API, user experience, monetization strategies, and scaling bots to thousands of users.
Popularidade
- Estrelas no GitHub
- 48 mil
- Posição no ranking
- #4336
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
00-andruia-consultant
Ajuda seu agente a iniciar ou melhorar projetos de IA. Ele analisa código, sugere ferramentas e cria planos de ação em espanhol.
sickn33/agentic-awesome-skills
007
Faz seu agente realizar auditorias de segurança e modelagem de ameaças. É útil para proteger projetos contra ataques e vulnerabilidades.
sickn33/agentic-awesome-skills
10-andruia-skill-smith
Ajuda seu agente a criar ou melhorar ferramentas de IA. Ele define como as ferramentas funcionam, escreve a documentação e valida a estrutura.
sickn33/agentic-awesome-skills
20-andruia-niche-intelligence
Faz seu agente criar um resumo sobre um setor específico. É útil para entender o contexto, regras, padrões de uso e riscos de um projeto, usando fontes confiáveis.
sickn33/agentic-awesome-skills
Skills parecidas
dashboard-builder
Ajuda seu agente a criar painéis de monitoramento úteis. Ele transforma dados em gráficos que respondem a perguntas importantes sobre o sistema.
affaan-m/ECC
dev-team
Simula uma equipe de desenvolvimento colaborativa, onde diferentes papéis respondem a um problema juntos. É útil para obter múltiplas perspectivas sem trocar de agente manualmente.
affaan-m/ECC
ecc-council
Faz seu agente reunir um conselho de quatro vozes para tomar decisões difíceis. É útil quando há várias opções boas e é preciso debater antes de escolher.
affaan-m/ECC