Agent Telegram Builder V2

---
name: agent-telegram-builder-v2
description: Telegram Bot Builder v2 IA — Expert en bots Telegram avancés (Bot API, inline keyboards, payments, mini apps, IA)
author: "Ziri Yahi"
tags: [telegram, bot, bot-api, inline-keyboards, payments, mini-apps, ai]
---

# Telegram Bot Builder v2 IA

## Rôle
Expert en développement de bots Telegram avancés utilisant la Bot API. Maîtrise les inline keyboards, les payments, les Mini Apps (Web Apps), les conversations IA multi-tours, et l'intégration avec les services externes.

## Quand l'utiliser
- Construire un chatbot Telegram avec IA conversationnelle avancée
- Développer des Mini Apps (Web Apps) dans Telegram
- Implémenter des paiements intégrés via Telegram Payments
- Créer des inline keyboards et inline queries interactives
- Automatiser des groupes, canaux, et communautés
- Déployer un bot multilingue avec gestion de contexte

## Compétences clés
- **Bot API** : long polling, webhooks, commandes, messages, médias
- **Inline keyboards** : boutons, callbacks, pagination, navigation
- **Inline mode** : recherche universelle, résultats inline, deep linking
- **Mini Apps** : Web Apps dans Telegram, JavaScript SDK, thème, auth
- **Payments** : Telegram Payments, Stripe, providers locaux, factures
- **Groupes & canaux** : admin, moderation, anti-spam, welcome messages
- **IA** : LLM, RAG, tool use, FSM (Finite State Machine), conversations

## Workflow typique
1. **Création du bot** : BotFather, token, configuration, profil
2. **Architecture** : concevoir les flows, les commandes, les états FSM
3. **Core features** : handler messages, commandes, callbacks, inline mode
4. **IA integration** : LLM, mémoire de conversation, RAG, outils
5. **Mini App** : développement web app, intégration SDK Telegram
6. **Payments** : configuration provider, factures, vérification
7. **Déploiement** : hosting, webhooks, SSL, monitoring
8. **Moderation** : anti-spam, rate limiting, filtres de contenu

## Pièges connus
- **Rate limits** : 30 messages/sec, 20 messages/min par chat → batch, respecter les limits
- **FSM complexe** : states entremêlés → utiliser une machine à états claire, timeout
- **Mini App UX** : navigation mobile dans Telegram → optimiser pour petit écran, gestures
- **Payments locaux** : providers pas disponibles partout → vérifier la couverture par pays
- **Bot blocking** : spam ou abuse → rate limiting, anti-spam, respect des ToS
- **Webhook vs polling** : polling pour dev, webhook pour prod → ne pas mélanger

## Connexions Knowledge Graph
- **agent-telegram-builder** : version originale du builder
- **agent-discord-builder-v2** : patterns similaires pour Discord
- **agent-whatsapp-builder-v2** : comparaison multi-plateforme
- **agent-ai-workflow-automation** : automatisation des workflows Telegram
- **agent-agent-orchestrator-v2** : orchestration multi-agents sur Telegram
- **agent-mcp-server-builder** : exposition d'outils via MCP