Générateur de Badge Telegram

Ce projet génère des badges SVG avec le nombre actuel de membres de vos groupes et chaînes Telegram. Parfait pour afficher l'activité de la communauté dans les fichiers README GitHub ou sur les sites web.

Prend en charge les deux :

👥 Groupes Telegram - Communautés interactives où tous les membres peuvent envoyer des messages
📢 Chaînes Telegram - Chaînes de diffusion où seuls les administrateurs peuvent publier des messages

Les groupes et les chaînes utilisent le même point de terminaison API et fonctionnent de manière identique avec ce générateur de badges.

Démarrage Rapide

Utilisez simplement les paramètres d'URL pour générer des badges pour n'importe quel groupe ou chaîne Telegram :

https://telegram-badge.vercel.app/api/telegram-badge?channelId=@votre_chaine_ou_groupe

Stack Technologique

Node.js / TypeScript pour un développement robuste
API Bot Telegram pour des données en temps réel
Vercel (API Serverless) pour une disponibilité mondiale
Jest pour les tests
Biome pour le linting et le formatage

Utilisation

Méthode Principale : Paramètres d'URL (Aucune Configuration Requise !)

Ajoutez simplement votre ID de groupe ou chaîne Telegram à l'URL :

![Badge Telegram](https://telegram-badge.vercel.app/api/telegram-badge?channelId=@votre_chaine_ou_groupe)

Fonctionne avec :

Chaînes publiques : @votre_chaine
Groupes publics : @votre_groupe
Groupes/chaînes privés : -1001234567890 (ID de chat numérique)

C'est tout ! Aucun déploiement, aucun token de bot nécessaire pour les groupes et chaînes publics.

Méthode Alternative : Déploiement Auto-Hébergé

Pour les chaînes privées ou les déploiements personnalisés :

Cloner le dépôt :

git clone https://github.com/chatman-media/telegram-badge.git
cd telegram-badge

Installer les dépendances :
```
npm install
```

Configurer les variables d'environnement :

cp .env.example .env
# Modifiez .env avec votre BOT_TOKEN

Déployer sur Vercel :
```
npm run deploy
```

Paramètres de Style

Personnalisez l'apparence de votre badge :

Paramètre	Description	Défaut	Exemple
`style`	Style du badge	`flat`	`flat`, `plastic`, `flat-square`, `for-the-badge`, `social`
`label`	Texte de gauche	`Members`	`Membres`, `Abonnés`
`color`	Couleur de droite	`2AABEE`	`brightgreen`, `red`, `blue`
`labelColor`	Couleur de gauche	`555555`	`orange`, `lightgrey`
`logo`	Ajouter un logo	`telegram`	`telegram`, `discord`
`logoColor`	Couleur du logo	`white`	`white`, `black`

Styles de Badge

Style	Exemple
`flat`
`plastic`
`flat-square`
`for-the-badge`
`social`

Exemples d'Utilisation

<!-- Badge basique -->
![Telegram](https://telegram-badge.vercel.app/api/telegram-badge?channelId=@votre_chaine)

<!-- Style personnalisé -->
![Telegram](https://telegram-badge.vercel.app/api/telegram-badge?channelId=@votre_chaine&style=for-the-badge&label=Communauté&color=blue)

<!-- Avec logo -->
![Telegram](https://telegram-badge.vercel.app/api/telegram-badge?channelId=@votre_chaine&logo=telegram&logoColor=white)

Fonctionnalités

🔄 Nombre de membres en temps réel - Données toujours à jour
🎨 Entièrement personnalisable - Couleurs, styles, étiquettes
🚀 Auto-hébergeable - Déployez sur votre propre infrastructure
📦 Package NPM disponible - Intégration facile dans vos projets
🌐 CDN Global - Temps de réponse rapides dans le monde entier
🔒 API Sécurisée - Aucun stockage de données sensibles
📱 Design Responsive - Fonctionne sur tous les appareils
🎯 Configuration Zéro - Fonctionne immédiatement

Utilisation de l'API

En tant que package NPM :

npm install @chatman-media/telegram-badge

import badgeHandler from "@chatman-media/telegram-badge";

// Utilisez dans votre fonction serverless
export default badgeHandler;

En tant que package Deno/JSR :

# Avec JSR
deno add @chatman-media/telegram-badge

# Ou importez directement
import badgeHandler from "jsr:@chatman-media/telegram-badge";

import badgeHandler from "@chatman-media/telegram-badge";

// Utilisez dans votre fonction serverless Deno
export default badgeHandler;

Appels API directs :

GET /api/telegram-badge?channelId=@votre_chaine&style=flat&label=Membres&color=2AABEE&labelColor=555555

Tests

Exécuter la suite de tests :

npm test

Exécuter la vérification de type :

npm run type-check

Construire le projet :

npm run build

FAQ

Quelle est la différence entre les groupes et chaînes Telegram ?

Groupes Telegram :

👥 Communautés interactives où tous les membres peuvent envoyer des messages
Les membres peuvent se voir et interagir entre eux
Peuvent avoir jusqu'à 200 000 membres
Exemple : @votre_groupe

Chaînes Telegram :

📢 Chaînes de diffusion où seuls les administrateurs peuvent publier des messages
Les abonnés ne peuvent pas se voir entre eux
Peuvent avoir un nombre illimité d'abonnés
Exemple : @votre_chaine

Pour ce générateur de badges : Les groupes et chaînes fonctionnent exactement de la même manière ! L'API Bot Telegram les traite de manière identique pour obtenir le nombre de membres/abonnés.

Comment trouver mon ID de groupe/chaîne ?

Pour les groupes/chaînes publics :

Utilisez le nom d'utilisateur : @votre_chaine ou @votre_groupe

Pour les groupes/chaînes privés :

Utilisez un bot comme @userinfobot
Transférez n'importe quel message de votre groupe/chaîne au bot
Il affichera l'ID du chat (comme -1001234567890)

Ai-je besoin d'un token de bot ?

Aucun token de bot nécessaire pour les groupes et chaînes publics lors de l'utilisation du service hébergé sur telegram-badge.vercel.app.

Token de bot requis uniquement pour :

Les groupes/chaînes privés
Les déploiements auto-hébergés

Contribution

Forkez le dépôt
Créez votre branche de fonctionnalité (git checkout -b feature/amazing-feature)
Commitez vos changements (git commit -m 'Add some amazing feature')
Poussez vers la branche (git push origin feature/amazing-feature)
Ouvrez une Pull Request