PHPackages                             mbindi/telebridge - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. mbindi/telebridge

ActiveLibrary[API Development](/categories/api)

mbindi/telebridge
=================

The most complete yet lightweight Telegram connector for Laravel. Long polling, notifications, multi-bots, DTOs, and more!

2.2.0(6mo ago)01MITPHPPHP ^8.1|^8.2|^8.3

Since Oct 24Pushed 6mo agoCompare

[ Source](https://github.com/mediasystem237/telebridge)[ Packagist](https://packagist.org/packages/mbindi/telebridge)[ Docs](https://github.com/mbindi/telebridge)[ RSS](/packages/mbindi-telebridge/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (6)Versions (4)Used By (0)

TeleBridge: Le Connecteur Telegram pour Laravel
===============================================

[](#telebridge-le-connecteur-telegram-pour-laravel)

TeleBridge est un **package Laravel léger** conçu pour connecter votre application Laravel avec l'API Telegram Bot. Il agit comme un **connecteur pur**, gérant uniquement la communication avec Telegram et laissant toute la logique métier (IA, base de connaissances, etc.) à votre application Laravel.

✨ Philosophie
-------------

[](#-philosophie)

**TeleBridge = Connecteur Uniquement**

✅ **Son rôle :**

- Recevoir les webhooks Telegram
- Router les messages vers votre backend Laravel
- Envoyer les réponses formatées à Telegram
- Gérer les claviers interactifs Telegram
- Supporter tous les types de messages (texte, photo, document, vidéo, audio, etc.)

❌ **Pas son rôle :**

- Intelligence artificielle (IA)
- Détection d'intention
- Génération de réponses
- Gestion des licences
- Base de connaissances
- Logique métier

> **Principe :** Votre application Laravel contient toute l'intelligence. TeleBridge est juste le pont entre Telegram et votre app.

---

🚀 Installation
--------------

[](#-installation)

### Étape 1 : Installer via Composer

[](#étape-1--installer-via-composer)

```
composer require mbindi/telebridge
```

### Étape 2 : Publier les migrations

[](#étape-2--publier-les-migrations)

```
php artisan vendor:publish --tag=telebridge-migrations
php artisan migrate
```

### Étape 3 : Publier la configuration (optionnel)

[](#étape-3--publier-la-configuration-optionnel)

```
php artisan vendor:publish --tag=telebridge-config
```

### Étape 4 : Configuration

[](#étape-4--configuration)

Ajoutez vos tokens Telegram dans `.env` :

```
TELEGRAM_BOT_TOKEN=123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
TELEGRAM_WEBHOOK_SECRET=votre_secret_pour_webhook
```

---

📊 Architecture
--------------

[](#-architecture)

```
┌─────────────────────────────────────────────────────────┐
│                   TELEGRAM BOT API                       │
└──────────────────────┬──────────────────────────────────┘
                       │ Webhook
                       ↓
┌─────────────────────────────────────────────────────────┐
│              TELEBRIDGE (Connecteur)                     │
│  - TeleBridgeController (webhook)                       │
│  - MessageRouter (dispatch)                             │
│  - TelegramClient (API Telegram)                        │
└──────────────────────┬──────────────────────────────────┘
                       │ Dispatch Job
                       ↓
┌─────────────────────────────────────────────────────────┐
│            VOTRE APPLICATION LARAVEL                     │
│  - Votre logique métier                                 │
│  - Votre IA / Intelligence                              │
│  - Votre base de données                                │
│  - Vos services                                         │
└──────────────────────┬──────────────────────────────────┘
                       │ Retour réponse
                       ↓
┌─────────────────────────────────────────────────────────┐
│              TELEBRIDGE (Connecteur)                     │
│  - TelegramClient envoie à Telegram                     │
└──────────────────────┬──────────────────────────────────┘
                       │
                       ↓
┌─────────────────────────────────────────────────────────┐
│                UTILISATEUR TELEGRAM                      │
└─────────────────────────────────────────────────────────┘

```

---

🎯 Guide de Démarrage Rapide
---------------------------

[](#-guide-de-démarrage-rapide)

### 1. Créer un bot Telegram

[](#1-créer-un-bot-telegram)

Parlez à [@BotFather](https://t.me/BotFather) sur Telegram pour créer un bot et obtenir un token.

### 2. Créer un bot dans votre application

[](#2-créer-un-bot-dans-votre-application)

```
use Mbindi\Telebridge\Models\TelegramBot;

$bot = TelegramBot::create([
    'user_id' => auth()->id(),
    'token' => env('TELEGRAM_BOT_TOKEN'),
    'name' => 'Mon Bot Assistant',
    'is_active' => true,
]);
```

### 3. Configurer le webhook

[](#3-configurer-le-webhook)

```
php artisan telebridge:set-webhook
```

Ou manuellement :

```
use Mbindi\Telebridge\Services\TelegramClient;

$client = new TelegramClient();
$client->setWebhook(
    token: env('TELEGRAM_BOT_TOKEN'),
    url: route('telebridge.webhook', ['bot_token' => env('TELEGRAM_BOT_TOKEN')])
);
```

### 4. Créer un Job pour traiter les messages

[](#4-créer-un-job-pour-traiter-les-messages)

**C'est ici que VOUS mettez votre logique !**

```