Pular para o conteúdo
Skillpedia
Diversos48 mil · #4336

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

https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/telegram-bot-builder/SKILL.md

Mensagem pronta para colar

Use esta skill para me ajudar: https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/telegram-bot-builder/SKILL.md Leia o arquivo SKILL.md desse link e siga as instruções dele na minha tarefa.
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-builder

Ou 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.md
Conteú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.

repo: sickn33/agentic-awesome-skills

Popularidade

Estrelas no GitHub
48 mil
Posição no ranking
#4336
Licença
MIT
Atualizada em
15/10/2026

Essa skill é útil?

0

Entre para votar.

Comentários

  • …

Mais skills deste repositório

Skills parecidas