Laravel Simple Telegram

Mengenal devaspid/laravel-simple-telegram: Package Notifikasi Telegram Satu Arah untuk Laravel

Dalam pengembangan aplikasi web modern mulai dari platform Direct-to-Consumer (D2C), toko online, hingga sistem Point of Sale (POS) notifikasi real-time untuk admin sangatlah krusial. Saat transaksi baru masuk atau pembayaran berhasil terverifikasi, tim operasional harus segera mendapatkan informasi tanpa perlu terus-menerus memantau dashboard.

Salah satu kanal notifikasi paling praktis dan handal adalah Telegram Group/Topic. Namun, menuliskan kode HTTP request ke API Telegram secara manual berulang kali di berbagai controller dapat membuat kode aplikasi tidak rapi (spaghetti code).

Untuk mengatasi hal tersebut, kami merilis devaspid/laravel-simple-telegram sebuah package open-source Laravel yang dirancang khusus untuk pengiriman notifikasi Telegram satu arah secara bersih, ringan, dan terstruktur.

Spesifikasi & Kompatibilitas

• PHP: ^8.2 | ^8.3
• Laravel: ^11.0 | ^12.0 | ^13.0
• Lisensi: MIT License (Open Source)

Panduan Instalasi & Konfigurasi

1. Instalasi via Composer

Jalankan perintah berikut pada terminal project Laravel Anda:

composer require devaspid/laravel-simple-telegram

2. Publish File Konfigurasi

Publish file telegram.php ke folder config/ project Anda:

php artisan vendor:publish --tag="telegram-config"

3. Setup Environment Variables (.env)

Tambahkan variabel berikut ke dalam file .env:

TELEGRAM_ENABLE=true
TELEGRAM_BOT_TOKEN="123456789:ABCdefGHIjklMNOpqrsTUVwxyZ"
TELEGRAM_CHAT_ID="-100123456789"
TELEGRAM_TOPIC_TRANSACTION=123

Contoh Penggunaan

Pada Controller / Livewire Component

namespace App\Http\Controllers;

use Devaspid\Telegram\Facades\Telegram;
use App\Models\Order;

class CheckoutController extends Controller
{
    public function store(Order $order)
    {
       
        $message = "📦 <b>Order Baru Masuk!</b>\n\n"
            . "Nomor Order : <b>#{$order->order_number}</b>\n";

        // Kirim ke Telegram Group Topic tertentu
        Telegram::send($message, config('telegram.topics.transaction'));
    }
}