---
title: Telebugs
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, development, error-reporting, telegram, bot, observability]
confidence: medium
contested: false
sources: [https://selfh.st/apps/?tag=Development, https://github.com/treezio/telebugs]
---

# 💻 Telebugs

> Bot **Telegram** minimaliste pour **centraliser les rapports de bugs et d'erreurs** applicatives — un endpoint HTTP simple reçoit les exceptions, le bot les transmet dans un chat ou canal Telegram pour un triage rapide par l'équipe.

## 📋 Informations Générales

| Attribut | Valeur |
|----------|--------|
| **Nom** | Telebugs |
| **Slug** | telebugs |
| **Description** | Bot Telegram de bug reports / error reporting |
| **Site officiel** | https://telebugs.app (à vérifier) |
| **Repository** | https://github.com/treezio/telebugs (à vérifier) |
| **Stars** | 0 ⭐ sur selfh.st |
| **Licence** | MIT (à vérifier) |
| **Langage** | Go / Python (à vérifier) |
| **Catégorie** | Development |
| **Note** | ⚠️ **Projet de niche (~0 ⭐)** — utile pour les **petites équipes** qui veulent centraliser leurs alertes dans Telegram sans déployer une stack Sentry/GlitchTip complète. |

## 📝 Description

**Telebugs** est un **bot Telegram open source** dont le rôle est de **collecter et dispatcher les rapports d'erreurs** applicatives vers un chat ou canal Telegram. Le concept est radicalement simple : une application cliente envoie une requête HTTP `POST` à Telebugs quand elle rencontre une exception, et Telebugs formate le payload en un message Telegram lisible dans un salon dédié.

**Cas d'usage typiques** : remplacer ou compléter un **Sentry** / **GlitchTip** trop lourd pour un side-project, recevoir les erreurs d'un **cron** ou d'un **script de production** directement sur le téléphone du développeur, ou faire du **bug-bounty privé** où des testers externes soumettent des bugs via un canal Telegram public.

**Fonctionnalités attendues** (à confirmer dans la doc) : endpoint HTTP simple avec token d'authentification, formatage automatique des stack traces, threading/grouping d'erreurs identiques, support de pièces jointes (screenshots, logs), filtrage par sévérité.

**Positionnement vs Sentry** : Sentry / GlitchTip / Bugsnag sont des plateformes d'error tracking **complètes** (grouping, alerting, releases, source maps, performance). Telebugs joue le rôle inverse : **très léger**, **sans UI web dédiée** (tout se passe dans Telegram), **sans base complexe**. Adapté aux petites structures qui n'ont pas la volumétrie pour Sentry.

**⚠️ Confiance faible** : 0 étoile sur selfh.st, projet récent et de niche. **Politique de sécurité à vérifier** (transmission en clair ? chiffrement ? stockage persistant ?). **Adapter la politique PII** : par défaut, les stack traces peuvent contenir emails, IPs, tokens — à **sanitizer côté application cliente** avant envoi.

## 🚀 Installation

### Via Docker (recommandé)

```yaml
# docker-compose.yml
version: "3.8"
services:
  telebugs:
    image: telebugs/telebugs:latest
    container_name: telebugs
    restart: unless-stopped
    environment:
      - TELEGRAM_BOT_TOKEN=123456:ABC-DEF...YZ
      - TELEGRAM_CHAT_ID=-100123456789
      - API_TOKEN=secret...ts
      - LOG_LEVEL=info
    ports:
      - "8080:8080"
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.telebugs.rule=Host(`telebugs.example.com`)"
      - "traefik.http.routers.telebugs.entrypoints=websecure"
      - "traefik.http.routers.telebugs.tls.certresolver=letsencrypt"
    networks:
      - proxy

networks:
  proxy:
    external: true
```

### Création du bot Telegram

```bash
# 1. Parler à @BotFather sur Telegram, créer un bot, récupérer le token
# 2. Ajouter le bot au canal/groupe cible, le promouvoir admin
# 3. Récupérer le chat_id (via @userinfobot ou l'API getUpdates)
# 4. Lancer le container avec les variables ci-dessus
```

### Envoi d'un rapport depuis une application

```bash
curl -X POST https://telebugs.example.com/report \
  -H "Authorization: Bearer secret...ts" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "NullPointerException in /api/users",
    "severity": "high",
    "stack": "...",
    "context": {"user_id": 42, "endpoint": "/api/users"}
  }'
```

## ⚙️ Configuration

- **`TELEGRAM_BOT_TOKEN`** : fourni par @BotFather — **à garder secret**, permet le contrôle total du bot.
- **`TELEGRAM_CHAT_ID`** : ID numérique du canal/groupe cible (négatif pour groupes, `-100…` pour supergroupes/canaux).
- **`API_TOKEN`** : token d'authentification côté serveur HTTP — **distinct** du token Telegram, sert à authentifier les apps clientes.
- **Sévérité** : à standardiser côté émetteur (`info`, `warning`, `error`, `critical`) pour permettre le filtrage Telegram.
- **Sanitization PII** : Telebugs étant un **pass-through** (pas de PII store persistant par défaut), c'est côté **application cliente** qu'il faut **filtrer emails, IPs, tokens** avant envoi.

## 🔗 Alternatives

- **Sentry** — La référence de l'error tracking, **très complet** mais lourd (Docker Compose ou SaaS).
- **GlitchTip** — Clone open source de Sentry, **plus léger**, auto-hébergeable, compatible SDK Sentry.
- **[[app-bugsink]]** — Fork minimaliste de GlitchTip, focalisé sur la simplicité pour homelab.
- **[[app-gotify]]** — Serveur de notifications auto-hébergé (push web + mobile), canal d'alertes générique.
- **ntfy.sh** — Pub/sub HTTP simple, consommé par n'importe quel client.

## 🔒 Sécurité

- **Tokens en variables d'environnement** : `TELEGRAM_BOT_TOKEN` et `API_TOKEN` **ne doivent jamais** être commit dans le repo — `.env` gitignored ou secret manager.
- **HTTPS obligatoire** : Telebugs reçoit potentiellement des données sensibles (stack traces, contexte applicatif) — **forcer HTTPS** via Traefik/Caddy.
- **Rate limiting** : activer un rate limit sur l'endpoint `/report` (Traefik `crowdsec-bouncer` ou reverse-proxy dédié) pour éviter qu'un bug en boucle sature le canal Telegram.
- **PII / RGPD** : les stack traces contiennent souvent des **données personnelles** (emails, IPs, chemins utilisateur) — **sanitizer côté émetteur** et **définir une politique de rétention** sur le canal Telegram (auto-suppression après N jours).

## 📚 Ressources

- [Site officiel Telebugs](https://telebugs.app) (à vérifier)
- [Repository GitHub](https://github.com/treezio/telebugs) (à vérifier)
- [Telegram Bot API — Documentation](https://core.telegram.org/bots/api)
- [Selfh.st — Development](https://selfh.st/apps/?tag=Development)
- [GlitchTip — Alternative plus complète](https://glitchtip.com)

## 🔗 Pages Liées

- [[cat-development]] — Catégorie Development
- [[app-bugsink]] — Alternative error-tracking plus complète
- [[app-gotify]] — Serveur de notifications push
- [[app-traefik]] — Reverse-proxy HTTPS recommandé
- [[securisation-home-lab]] — Bonnes pratiques de sécurité
- [[recettes-docker-compose]] — Templates Docker