🏠 BERANDA Selamat Membaca, Sobat MasAnam!
📚 BLOG →
📌 Keamanan & Integrasi Sistem 📅 16 Nov 2026 👁️ 11x dibaca

Cara Menghubungkan Bot Telegram & AI Agent ke Website Laravel + MySQL secara Aman (Arsitektur REST API & Token)

📢 Bagikan Edukasi Ini:

🌉 Menyambungkan Dua Dunia: Website di Cloud Hosting & AI Agent di Server Lokal

Di artikel sebelumnya, kita sudah menemukan racikan infrastruktur paling hemat dan tangguh: menaruh Website Utama (Laravel + MySQL) di Shared Hosting cPanel, lalu menjalankan Otak AI Agent (seperti Hermes Agent + Bot Telegram) di STB Linux Armbian rumah.

Namun muncul satu pertanyaan teknis yang sangat krusial: "Bagaimana caranya agar AI Agent di STB rumah bisa membaca stok barang atau rekap kas di dalam Database MySQL yang ada di Hosting cPanel dengan cepat dan 100% aman dari hacker?" Mari kita bedah arsitektur jembatannya lewat 4 diagram workflow!

1. Kesalahan Fatal Pemula: Membuka "Remote MySQL" (Port 3306) ke Internet!

Saat ingin menghubungkan program luar ke database cPanel, banyak pemula mengambil jalan pintas dengan membuka menu Remote MySQL di cPanel lalu mengizinkan semua alamat IP (simbol %) untuk mengakses Port 3306 secara langsung.
Ini sangat berbahaya! Membuka pintu MySQL langsung ke internet umum sama saja dengan menaruh brankas uang di pinggir jalan raya. Bot scanner milik peretas bisa melakukan tebak password (brute-force), atau jika AI Agent Anda salah menulis query, ia bisa tidak sengaja menghapus tabel penting!

📊 Workflow 1: Cara Berbahaya (Direct DB) vs Cara Aman (Jembatan REST API Laravel)

flowchart TD subgraph Bahaya ["❌ CARA BERBAHAYA: Buka Port MySQL 3306 Langsung ke Internet"] B1(["🤖 AI Agent di STB"]) -->|"Koneksi Langsung Port 3306"| B2[("🗄️ Database MySQL Hosting")] H1(["🏴‍☠️ Hacker / Bot Scanner"]) -->|"Ikut Masuk Menyerang Port 3306!"| B2 B2 --> B3["💥 Risiko: Password Ditebak & AI Bisa Salah Hapus Tabel!"] end subgraph Aman ["✅ CARA AMAN PROFESIONAL: Lewat Pintu Satpam REST API Laravel"] A1(["🤖 AI Agent di STB"]) -->|"1. Kirim Permintaan HTTPS + Token Rahasia"| A2["🛡️ Satpam Laravel (Middleware API Token)"] A2 -->|"2. Token Valid! Jalankan Controller"| A3["⚙️ Laravel Controller (Query Sudah Dibatasi Aman)"] A3 <-->|"3. Ambil Data Lokal (Port 3306 Tertutup Rapat)"| A4[("🗄️ Database MySQL Hosting")] end style B3 fill:#fecaca,stroke:#dc2626,stroke-width:2px style H1 fill:#fecaca,stroke:#dc2626,stroke-width:2px style A2 fill:#fef08a,stroke:#ca8a04,stroke-width:2px style A4 fill:#bbf7d0,stroke:#16a34a,stroke-width:2px

2. Analogi Pelayan Restoran: Memahami REST API & Bearer Token

Agar database MySQL tetap terkunci rapat di dalam server hosting, kita menugaskan Laravel sebagai perantara melalui jalur REST API (biasanya berada di rute domainanda.com/api/...):

🍽️ 1. Endpoint API (Buku Menu)

Kita hanya menyediakan "menu" tertentu yang boleh diminta oleh AI Agent, misalnya: /api/cek-stok atau /api/rekap-harian. AI tidak bisa meminta di luar menu itu!

🪪 2. Bearer Token / API Key (Kartu VIP)

Kode acak panjang (misal dari Laravel Sanctum atau Secret Header) yang wajib ditunjukkan oleh AI Agent di setiap permintaan. Tanpa kartu ini, pintu langsung ditolak (Error 401 Unauthorized)!

📦 3. Format JSON (Kotak Makan Rapi)

Laravel tidak mengirim tampilan HTML yang berat ke AI Agent, melainkan hanya mengirim teks ringkas berformat JSON sehingga sangat hemat kuota Token LLM!

📊 Workflow 2: Cara Kerja Pemeriksaan "Kartu VIP" (Bearer Token) di Pintu Laravel

flowchart TD Req(["📡 Ada Request Masuk ke https://site.domain.com/api/laporan"]) --> CekToken{"Apakah Membawa Header Authorization: Bearer TOKEN_RAHASIA?"} CekToken -->|"TIDAK ADA / TOKEN SALAH"| Tolak["🚫 Ditolak Mentah-Mentah! Return 401 Unauthorized (Database Aman 100%)"] CekToken -->|"YA, TOKEN COCOK!"| Terima["✅ Diizinkan Masuk ke Controller Laravel"] Terima --> Olah["🧮 Laravel Hitung SUM / Ambil Data Seperlunya dari MySQL"] Olah --> Kirim(["📤 Kirim Balasan JSON Ringkas (< 1 KB) ke AI Agent"]) style Req fill:#fef08a,stroke:#ca8a04,stroke-width:2px style Tolak fill:#fecaca,stroke:#dc2626,stroke-width:2px style Terima fill:#bbf7d0,stroke:#16a34a,stroke-width:2px style Kirim fill:#bfdbfe,stroke:#1d4ed8,stroke-width:2px

3. Urutan Kerja Lengkap (End-to-End): Dari Chat Telegram Sampai Dibalas AI!

Mari kita lihat betapa indahnya kerja sama antara HP Anda (Telegram) → STB Rumah (Hermes Agent) → Otak LLM Cloud → Hosting cPanel (Laravel + MySQL) yang semuanya berlangsung hanya dalam waktu ~2 detik:

📊 Workflow 3: Sequence Diagram Integrasi Bot Telegram + Hermes AI + Laravel API

sequenceDiagram autonumber actor User as 📱 Kita (di Telegram) participant STB as 📦 Hermes Agent (di STB Linux) participant LLM as 🧠 Otak LLM (API Gemini/Groq) participant LV as 🛡️ Laravel API (di Hosting cPanel) participant DB as 🗄️ MySQL (di Hosting cPanel) User->>STB: Chat: "Ndan, berapa total pengadaan bulan ini?" STB->>LLM: Kirim pertanyaan user + daftar Tool API yang tersedia LLM-->>STB: Perintah: Panggil Tool get_pengadaan_bulanan() STB->>LV: HTTP GET /api/pengadaan-bulanan (Bawa Header: Bearer TOKEN_RAHASIA) LV->>LV: Cek Keaslian Token (Valid!) LV->>DB: SELECT SUM(total), COUNT(id) FROM pengadaan WHERE bulan = INI DB-->>LV: Hasil: Rp 45.200.000 (18 Transaksi) LV-->>STB: Kirim JSON Ringkas: {"total": 45200000, "jumlah_po": 18} STB->>LLM: Berikan data JSON ke LLM untuk dirangkai jadi kalimat sopan LLM-->>STB: "Siap Ndan! Total pengadaan bulan ini Rp 45.200.000 dari 18 transaksi." STB->>User: Tampilkan balasan ke layar Telegram!

💡 Keuntungan Ganda Arsitektur Ini: Selain 100% aman karena MySQL tidak terekspos ke luar, perhatikan Langkah 7 & 8: karena Laravel sudah menghitungkan SUM(total) di server hosting, data yang dikirim ke AI Agent hanyalah 1 baris JSON kecil. Kuota Token API gratis Anda jadi irit luar biasa!

4. Contoh Kode Jembatan API Sederhana di Laravel (Tanpa Ribet!)

Anda bahkan tidak wajib menginstal pustaka tambahan yang rumit untuk membuat pintu API yang aman bagi AI Agent pribadi Anda. Cukup tambahkan 1 baris kunci rahasia di file .env Laravel Anda, misalnya: AGENT_API_KEY=KunciRahasiaMasAnam2026, lalu pasang rute ini di routes/api.php (atau routes/web.php):

// Contoh Route API Aman untuk AI Agent di Laravel
use IlluminateHttpRequest;
use IlluminateSupportFacadesDB;
use IlluminateSupportFacadesRoute;

Route::get("/api/agent/rekap-kas", function (Request $request) {
    // 1. Satpam Penjaga: Cek apakah Bearer Token sesuai dengan .env
    $tokenMasuk = $request->bearerToken();
    if ($tokenMasuk !== env("AGENT_API_KEY")) {
        return response()->json(["error" => "Akses Ditolak! Token Salah."], 401);
    }

    // 2. Ambil rekap ringkas dari MySQL (Hemat Token LLM!)
    $rekap = DB::table("transaksi")
        ->whereMonth("tanggal", date("m"))
        ->selectRaw("COUNT(id) as total_trx, SUM(nominal) as total_rupiah")
        ->first();

    // 3. Kembalikan dalam bentuk JSON bersih ke AI Agent
    return response()->json([
        "status" => "sukses",
        "bulan"  => date("F Y"),
        "data"   => $rekap
    ]);
});

5. Dua Arah Komunikasi: AI Bertanya (Pull API) vs Laravel Melapor Otomatis (Push Webhook)

Selain AI Agent yang aktif bertanya ke Laravel saat kita mengirim chat (Pull / Request API), kita juga bisa membalik arahnya (Push / Webhook): setiap kali ada admin menginput transaksi baru di website Laravel, Laravel otomatis menembak pesan notifikasi ke grup Telegram detik itu juga!

📊 Workflow 4: Perbandingan Mode Tanya-Jawab (API Pull) vs Notifikasi Otomatis (Webhook Push)

flowchart TD subgraph Mode_Pull ["🔍 MODE 1: API PULL (Kita Tanya -> AI Cek ke Laravel)"] P1(["📱 Kita Chat ke Bot Telegram: Stok barang X tinggal berapa?"]) --> P2["🤖 Hermes Agent Panggil API Laravel"] P2 --> P3["🗄️ Laravel Cek MySQL & Balas ke Bot"] end subgraph Mode_Push ["🔔 MODE 2: WEBHOOK PUSH (Ada Input di Web -> Otomatis Lapor ke Telegram)"] W1(["💻 Staf Input Barang Masuk di Web Laravel"]) --> W2["🗄️ Data Tersimpan di MySQL Hosting"] W2 --> W3["🚀 Laravel Otomatis Tembak API Bot Telegram / Agent"] W3 --> W4(["📱 HP Bos Langsung Bunyi: Notif Transaksi Baru Masuk!"]) end style P1 fill:#fef08a,stroke:#ca8a04,stroke-width:2px style P3 fill:#bbf7d0,stroke:#16a34a,stroke-width:2px style W1 fill:#e0f2fe,stroke:#0284c7,stroke-width:2px style W4 fill:#bbf7d0,stroke:#16a34a,stroke-width:2px

📌 3 Aturan Emas Integrasi AI Agent & Website Laravel:

  • Jangan Pernah Buka Port MySQL ke Luar: Biarkan database MySQL tetap terkunci di dalam hosting (`localhost`), dan bangun jembatan resmi melalui rute REST API Laravel.
  • Wajib Pasang Satpam Token (Bearer Token): Pastikan setiap rute API memeriksa kunci rahasia di Header Authorization dan gunakan selalu jalur terenkripsi HTTPS.
  • Olah Angka di Laravel, Bukan di Otak LLM: Biarkan MySQL dan PHP yang menghitung penjumlahan ribuan baris data (`SUM`, `COUNT`, `GROUP BY`), lalu kirimkan hasil akhirnya saja ke AI Agent agar respon super cepat dan hemat kuota token!

💡 Artikel & Workflow Ini Bermanfaat?

Yuk bagikan ke grup WhatsApp, Telegram, atau teman developer agar makin banyak yang paham!

🔥 Artikel Terkait yang Wajib Dibaca

Lihat Semua →