Telegram Bot API

Validator initData Telegram Mini App

Tempel Telegram.WebApp.initData dan token bot kamu untuk mengecek apakah hash Mini App valid — pengecekan HMAC-SHA256 yang sama dengan yang wajib dijalankan server kamu, dilakukan secara lokal di browser.

Token tetap di browser kamu (localStorage) dan hanya dikirim ke api.telegram.org.

Algoritma: secret_key = HMAC_SHA256("WebAppData", bot_token); hash = hex(HMAC_SHA256(secret_key, data_check_string)), dengan data_check_string berisi semua field kecuali hash, diurutkan berdasarkan key dan digabung sebagai key=value dengan \n.

Cara mengecek hash Telegram Mini App

  1. Ambil string initData mentah di Mini App kamu, misalnya dengan mencetak Telegram.WebApp.initData ke log (bukan initDataUnsafe). Fragmen URL yang diawali tgWebAppData= juga bisa: awalannya akan dihapus.
  2. Tempel token bot yang membuka Mini App tersebut.
  3. Tekan Validasi. Kamu mendapat hasil valid/tidak valid, auth_date beserta umurnya (dengan peringatan jika lebih lama dari 24 jam), dan semua field hasil parsing, dengan user dan nilai JSON lainnya sudah di-decode.

Cara kerja validasi

Alat ini mengikuti algoritma resmi dari Validating data received via the Mini App:

  1. Parse initData sebagai query string dan sisihkan hash.
  2. Susun data_check_string: semua field lainnya sebagai key=value (nilai sudah di-URL-decode), diurutkan secara alfabetis, digabung dengan karakter baris baru \n.
  3. secret_key = HMAC_SHA256(key="WebAppData", message=bot_token).
  4. Data valid jika hex(HMAC_SHA256(key=secret_key, message=data_check_string)) sama dengan hash.

Pengecekan yang sama di server Node.js:

const crypto = require('crypto');

function checkInitData(initData, botToken) {
  const params = new URLSearchParams(initData);
  const hash = params.get('hash');
  params.delete('hash');
  const dataCheckString = [...params]
    .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
    .map(([k, v]) => `${k}=${v}`)
    .join('\n');
  const secret = crypto.createHmac('sha256', 'WebAppData').update(botToken).digest();
  const calc = crypto.createHmac('sha256', secret).update(dataCheckString).digest('hex');
  return calc === hash;
}

Cek juga auth_date di server agar initData lama yang disadap tidak bisa dipakai ulang.

Kenapa hash tidak cocok

Privasi

Tidak ada request yang keluar dari browser kamu: HMAC dihitung dengan Web Crypto API, dan token hanya disimpan di localStorage — tidak ada yang sampai ke server kami. Untuk melihat initData asli dari peluncuran sungguhan, buka /id/telegram-mini-app-tester.html di dalam Telegram. Alur pengujian lengkapnya ada di /id/guides/test-telegram-mini-app.html; jika kamu butuh token baru, lihat /id/guides/telegram-bot-token.html.

Pertanyaan umum

Bagaimana cara memvalidasi init data Telegram Web App?

Hitung secret_key = HMAC_SHA256("WebAppData", bot_token), susun data-check-string dari semua field kecuali hash yang diurutkan berdasarkan key dan digabung dengan \n, lalu bandingkan hex(HMAC_SHA256(secret_key, data_check_string)) dengan hash. Alat di atas melakukan persis hal ini.

Kenapa hash initData saya tidak valid?

Biasanya token milik bot lain, atau initData sudah diubah: di-decode, di-encode ulang, dipotong, atau disusun ulang dari initDataUnsafe. Tempel string Telegram.WebApp.initData mentah.

Apakah initDataUnsafe bisa dipercaya?

Tidak di server. initDataUnsafe hanyalah data hasil parsing di sisi klien; kirim initData mentah ke backend dan validasi hash di sana sebelum memercayai ID pengguna.

Berapa lama initData boleh berumur?

Telegram menyarankan mengecek auth_date untuk menolak data yang kedaluwarsa, tetapi batasnya kamu tentukan sendiri. Alat ini menampilkan umur data dan memberi peringatan jika data lebih lama dari 24 jam.

Apakah token bot saya dikirim ke suatu tempat?

Tidak. Validator ini tidak membuat request jaringan: hash dihitung dengan Web Crypto API di browser kamu. Token hanya diingat di localStorage.

Utilitas lainnya

Pencari Chat IDEscaper MarkdownV2 & HTMLPemeriksa webhookBot API Tester