Telegram Serverless Mulai Menghosting Mini App di Domain tgcloud.ai

Pada 6 Oktober, Telegram memperbarui Serverless, platformnya untuk kode bot. Kini, platform tersebut juga menghosting frontend Mini App: build-nya diunggah bersama bot dengan satu perintah dan dapat diakses di alamat seperti app<id>.tgcloud.ai. Mini App kini memiliki fungsi server yang dipanggilnya dari telegram-web-app.js. Pembaruan ini berlaku untuk semua yang mengelola backend bot atau Mini App di server mereka sendiri, dan mereka yang telah memindahkan bot ke Serverless pada bulan Juli: proyek lama perlu diubah ke tata letak folder baru satu kali.

Serverless adalah backend untuk bot yang dijalankan oleh Telegram. Kode ditulis dalam modul JavaScript biasa dan dieksekusi dalam isolat V8, yaitu, dalam sandbox ringan di dalam satu proses, di samping Bot API. Kode tersebut dilengkapi dengan database SQLite dan HTTP keluar. Anda tidak memerlukan server, kontainer, atau webhook sendiri. Versi pertama utilitas baris perintah @tgcloud/cli dirilis di npm pada 12 Juli, halaman dokumentasi muncul di web archive pada 13 Juli. Saat itu, platform hanya mampu merespons update bot: dalam versi dokumentasi Juli, tidak ada bagian tentang frontend, maupun kata "endpoint".

Apa yang Berubah pada 6 Oktober

Mini App tidak lagi memerlukan hosting terpisah, sertifikat, dan server dengan API. Frontend dapat di-build dengan bundler apa pun, utilitas membandingkan file berdasarkan hash dan hanya mengunggah yang berubah. Alamat yang dicetak oleh push dimasukkan ke @BotFather sebagai alamat Mini App.

Apa yang Harus Dilakukan dengan Proyek Versi 0.1

Utilitas 0.2.0 akan menolak bekerja dengan tata letak lama sampai proyek diubah ke tata letak baru. Konversi dengan satu perintah:

• npx tgcloud upgrade memindahkan schema.js, lib/, dan handlers/ ke folder tgcloud/. Nama modul (lib/cart, handlers/message) tidak berubah.
• Impor berdasarkan nama modul tetap berfungsi, tetapi dokumentasi menyarankan untuk beralih ke jalur relatif dengan .js.

Bagi mereka yang menghubungkan Mini App:

• push mengunggah folder build apa adanya dan tidak melakukan build apa pun. Jika dijalankan setelah mengedit frontend tanpa build, versi sebelumnya akan terunggah ke produksi. Skrip npm run deploy, yang ditambahkan oleh template proyek, pertama-tama melakukan build, lalu mengunggah.
• Telegram Web membuka Mini App dalam iframe, sehingga header X-Frame-Options dan frame-ancestors yang ketat tidak boleh digunakan.
• Jalur /api/ pada alamat yang sama digunakan oleh endpoint, jadi jangan meletakkan file Anda sendiri di sana.
• immutable dalam konfigurasi — hanya untuk file dengan hash di namanya. Browser akan menyimpan yang lain dalam cache selama satu tahun, dan tidak ada cara untuk mencabutnya.
• Next.js, Nuxt, SvelteKit, dan Angular tidak dikenali secara otomatis oleh utilitas: Anda harus terlebih dahulu mengonfigurasi ekspor statis dan memasukkan foldernya ke "source" secara manual.

Bagaimana Mini App Memanggil Backend-nya

Pada hari yang sama, pukul 09:27 UTC, Telegram memperbarui telegram-web-app.js, skrip yang menghubungkan setiap Mini App. Di dalamnya, muncul objek Telegram.WebApp.Serverless dengan satu-satunya metode call. Metode ini melakukan POST ke alamat relatif /api/<nama>, yaitu ke host yang sama tempat aplikasi dibuka. Oleh karena itu, panggilan hanya berfungsi untuk Mini App yang dihosting di tgcloud.ai: dari domain Anda sendiri, permintaan akan dikirim ke server Anda sendiri.

Dalam header Authorization, skrip menempatkan string TMA dan initData dalam base64. initData adalah kumpulan bidang yang ditandatangani oleh Telegram tentang pengguna dan obrolan tempat klien membuka Mini App. Platform memeriksa tanda tangan sebelum menjalankan kode, dan tanpa itu, permintaan akan menerima 401. Endpoint menerima pengguna yang sudah diverifikasi di ctx.initData.user. Memeriksa tanda tangan initData secara manual, seperti yang harus dilakukan di server Anda sendiri, tidak lagi diperlukan, dan backend semacam itu tidak memiliki API terbuka yang perlu dilindungi.

Kesalahan dibagi menjadi dua jenis. EndpointError, yang sengaja dilemparkan oleh kode, mencapai klien dengan teks dan parameter yang dapat digunakan frontend untuk bercabang. Setiap pengecualian lain akan terlihat oleh klien sebagai kesalahan internal, dan teks sebenarnya tetap ada di log, agar struktur backend tidak bocor keluar.

Apa yang dilaporkan server tentang dirinya tanpa token

Utilitas mengakses API di cloud.telegram.org. Salah satu metodenya, /capabilities, menjawab tanpa otorisasi: ia menjelaskan tata letak proyek, template AGENTS.md dan docs/tgcloud-sdk.md, serta daftar jenis update yang dapat ditangani. Ada 27 jenis update tersebut. Utilitas memverifikasi nomor skema proyek dengan respons ini dan memperingatkan jika server sudah mengetahui folder yang belum diketahuinya. Dalam kode utilitas juga terdapat sakelar TGCLOUD_BETA=1, yang mengarahkan permintaan ke /beta. Pada 6 Oktober, respons beta sama dengan respons utama.

Mengapa Domain Disebut .ai

Domain tgcloud.ai terdaftar pada 11 September 2026 melalui GoDaddy. Pada hari yang sama, sertifikat *.tgcloud.ai dikeluarkan untuknya, satu untuk semua subdomain seperti app<id>. Alamat domain, 149.154.166.100, berada di jaringan Telegram_Messenger_Network (AS62041). Root domain mengembalikan 404 kosong: platform tidak memiliki etalase, hanya subdomain aplikasi.

Ekstensi itu sendiri belum membuktikan apa pun: .ai adalah domain nasional Anguilla yang telah lama digunakan oleh proyek teknologi. Dan tgcloud.com telah ditempati sejak 2011 oleh pemilik pihak ketiga, jadi pilihannya mungkin hanya masalah nama yang tersedia.

Namun, platform ini sejak awal dibangun di sekitar agen AI yang menulis kode, dan di sekitar bot yang menghasilkan respons.

• Kode ditulis oleh agen. Bagian "Building with AI" telah ada dalam dokumentasi sejak Juli. Setiap proyek baru menerima AGENTS.md, yang, menurut template itu sendiri, secara otomatis dibaca oleh Claude Code, Cursor, dan alat serupa, serta referensi SDK di docs/. Dokumentasi menyarankan untuk membuka proyek di agen dan menjelaskan bot dengan kata-kata, dan menyebut langkah itu sebagai yang pertama.
• Lingkungan dirancang untuk kode yang dihasilkan. Tidak ada paket npm, satu SDK, aturan ketat seperti satu file per jenis update. Semakin sedikit varian, semakin jarang agen membuat kesalahan, dan dokumentasi secara langsung mencantumkan perjanjian yang "generasi kode biasa" lewatkan.
• Bot yang menghasilkan respons. Di antara 27 jenis update yang diterima Serverless, ada stopped_message_generation dan guest_message. Keduanya muncul di Bot API pada musim semi dan musim panas bersama dengan fungsi lain untuk bot berbasis model bahasa.

Apa yang belum ada di Serverless adalah model itu sendiri. SDK terdiri dari tiga bagian: database (sdk/db), Bot API (sdk/api), dan fetch. Agar bot di Serverless merespons dengan teks dari model bahasa, ia menggunakan fetch ke API eksternal dengan kuncinya sendiri. Dokumentasi fetch secara terpisah membahas pembacaan respons secara streaming sebagai cara untuk menerima output API AI per token.

Telegram memiliki kapasitasnya sendiri untuk jaringan saraf. Cocoon, sebuah jaringan komputasi rahasia di GPU dengan pembayaran dalam TON, diperkenalkan oleh Durov di Blockchain Life 2025, dan situs webnya dilayani dari alamat yang sama di jaringan Telegram dengan telegram.org. Dari sini muncul hipotesis: bagian selanjutnya dari SDK mungkin adalah panggilan model bawaan, tanpa kunci eksternal dan dengan pembayaran melalui Telegram. Hipotesis kedua berkaitan dengan @BotFather: editor untuk handler, basis data, dan berkas Telegram Mini App sudah ada di dalamnya di ponsel, dan mendeskripsikan bot dengan kata-kata alih-alih kode tampaknya menjadi langkah selanjutnya untuk editor semacam itu. Tidak satu pun dari hipotesis ini yang dikonfirmasi oleh apa pun, kecuali domain dan arah pembaruan terbaru: dalam dokumentasi, command-line tool (CLI), dan respons /capabilities dari 6 Oktober, tidak ada modul untuk jaringan saraf.