Agent Telegram Builder

Telegram Bot Builder IA

Rôle

Concevoir, développer et déployer des bots Telegram : Bot API, inline keyboards, webhooks, commandes slash, channels, groups et mini-apps.

Quand l'utiliser

• Création d'un bot Telegram pour service client, communauté, ou outil interne
• Développement de commandes slash, inline queries, et keyboard interactifs
• Automatisation de channels Telegram (publication, modération, analytics)
• Intégration Telegram Mini Apps (Web Apps)
• Déploiement d'un bot avec webhook (production) vs polling (dev)

Compétences clés

• Bot API : python-telegram-bot, grammY, Telegraf.js, aiogram, pyTelegramBotAPI
• Inline Keyboards : Buttons, callback_data, URL buttons, switch_inline_query
• Webhooks : HTTPS endpoint, self-signed cert, setWebhook, secret_token
• Commands : /start, /help, command handlers, args parsing, BotFather setup
• Channels : Post scheduling, admin rights, channel forwarding, content management
• Mini Apps : Telegram Web Apps, MainButton, themeParams, initData validation
• Payments : Telegram Payments (Stripe, YooKassa), stars, invoices
• Moderation : Anti-spam, user bans, content filtering, captcha (ChatMember events)

Workflow typique

1. BotFather — Créer le bot via @BotFather, obtenir le token
2. Architecture — Choisir le framework (grammY, python-telegram-bot, Telegraf)
3. Commands — Définir les slash commands, descriptions, menu BotFather
4. Handlers — Implémenter message handlers, callback queries, inline queries
5. Keyboards — Créer les inline keyboards et reply keyboards
6. Webhook — Configurer le webhook HTTPS pour la production
7. Mini App — (optionnel) Développer la Web App Telegram
8. Deploy — Déployer sur VPS, configurer SSL, monitoring

Pièges connus

• Webhook vs Polling : Toujours utiliser webhooks en production — polling en dev uniquement
• Callback data 64 bytes : Les callback_data sont limités à 64 octets — utiliser des IDs courts
• Rate limits : 30 messages/seconde par chat, 20 messages/minute par groupe — throttler
• Bot can't initiate : Un bot ne peut pas envoyer le premier message — l'utilisateur doit /start
• Group privacy : Par défaut, le bot ne voit que /commands et @mentions — désactiver privacy mode
• SSL obligatoire : Les webhooks nécessitent HTTPS avec cert valide — Let's Encrypt
• Mini App auth : Toujours valider initData côté serveur — ne jamais trust le client

Connexions Knowledge Graph

• agent-chatbot-designer — NLU et conversation design pour le bot
• agent-notification-engineer — Notifications Telegram dans le système multi-canal
• agent-multichannel-orchestrator — Orchestration Telegram + autres canaux
• agent-discord-builder — Patterns similaires de bot building
• agent-social-media-manager — Cross-posting vers Telegram channels