Keyboard Bot Telegram: Inline Keyboard, Tombol Callback, dan Reply Keyboard
Inline keyboard Telegram adalah kumpulan tombol yang menempel pada pesan bot: kamu mengirim objek InlineKeyboardMarkup di parameter reply_markup pada sendMessage, dan menekan tombol callback akan mengirim update callback_query ke bot yang wajib dijawab dengan answerCallbackQuery. Sebaliknya, reply keyboard (ReplyKeyboardMarkup) menggantikan keyboard huruf pengguna dengan pilihan jawaban yang sudah disiapkan. Panduan ini membahas kedua jenis tombol bot Telegram, semua tipe tombol, cara mengedit pesan setelah tombol ditekan, dan contoh lengkap yang berjalan dalam Python dan JavaScript.
Inline keyboard vs reply keyboard
| Inline keyboard | Reply keyboard | |
|---|---|---|
| Objek | InlineKeyboardMarkup | ReplyKeyboardMarkup |
| Tempat muncul | Di bawah pesan tertentu | Menggantikan keyboard pengguna |
| Efek saat ditekan | Callback query, membuka URL, Mini App, inline mode, menyalin teks… | Mengirim teks tombol sebagai pesan, atau membagikan kontak, lokasi, pengguna, chat |
| Bisa diedit kemudian | Ya, dengan editMessageReplyMarkup | Tidak, kirim keyboard baru atau hapus |
| Channel | Didukung | Tidak didukung |
Keduanya dikirim lewat parameter reply_markup yang sama, bersama ReplyKeyboardRemove dan ForceReply. Satu pesan hanya bisa membawa salah satu dari empat objek ini.
Kirim inline keyboard Telegram
inline_keyboard adalah array baris, dan setiap baris berisi array tombol:
curl -X POST "https://api.telegram.org/bot123456789:AAEexampleTokenReplaceWithYours/sendMessage" \
-H "Content-Type: application/json" \
-d '{
"chat_id": 123456789,
"text": "Pilih salah satu:",
"reply_markup": {
"inline_keyboard": [
[{"text": "Suka", "callback_data": "like"}, {"text": "Bantuan", "callback_data": "help"}],
[{"text": "Dokumentasi Bot API", "url": "https://core.telegram.org/bots/api"}]
]
}
}'
Selain text, setiap tombol wajib punya tepat satu field yang menentukan tipenya:
| Field | Fungsi tombol |
|---|---|
callback_data | Mengirim callback query berisi string ini ke bot, 1–64 byte |
url | Membuka link HTTP atau tg:// |
web_app | Membuka Mini App; hanya di chat pribadi antara pengguna dan bot |
login_url | Membuka URL HTTPS dan mengotorisasi pengguna di situs kamu |
switch_inline_query, switch_inline_query_current_chat, switch_inline_query_chosen_chat | Menaruh username bot dan query ke kolom input chat lain, chat saat ini, atau chat dengan tipe yang dipilih |
copy_text | Menyalin {"text": "…"} (1–256 karakter) ke clipboard |
pay | Tombol bayar; hanya di pesan invoice, harus tombol pertama di baris pertama |
callback_game | Membuka game; harus tombol pertama di baris pertama |
disabled | DisabledButton yang tidak melakukan apa-apa (Bot API 10.3) |
Dua field opsional mengubah tampilan tombol (Bot API 9.4, juga tersedia di tombol reply keyboard): style dengan nilai "danger" (merah), "success" (hijau), atau "primary" (biru), dan icon_custom_emoji_id untuk emoji kustom sebelum teks. Emoji kustom hanya berfungsi jika bot boleh memakainya: bot sudah membeli username tambahan di Fragment, atau pemiliknya punya Telegram Premium dan pesan dikirim langsung ke chat pribadi, grup, atau supergrup.
Merancang callback_data
Batas 64 byte menghitung byte, bukan karakter, jadi buat nilainya pendek dan mudah dibaca mesin, misalnya like, page:3, atau del:8812, dan simpan data aslinya di database. API juga mengingatkan bahwa pesan mungkin tidak berisi tombol dengan data yang kamu terima, jadi perlakukan sebagai input pengguna yang tidak tepercaya: parse, validasi, dan cek apakah pengguna boleh melakukan aksi tersebut. Nilai yang terlalu panjang ditolak saat keyboard dikirim, biasanya dengan Bad Request: BUTTON_DATA_INVALID.
Jawab setiap tekanan tombol dengan answerCallbackQuery
Menekan tombol callback menghasilkan update dengan field callback_query: id, from (pengguna), data, dan untuk pesan yang dikirim bot, message berisi pesan aslinya. Setelah tombol ditekan, klien Telegram menampilkan indikator progres sampai bot memanggil answerCallbackQuery, jadi panggil metode ini setiap kali, meskipun tanpa parameter selain id.
| Parameter | Arti |
|---|---|
callback_query_id | Wajib, id dari callback query |
text | Teks notifikasi, 0–200 karakter; tidak ada yang ditampilkan jika dikosongkan |
show_alert | true menampilkan alert, bukan notifikasi di bagian atas chat |
url | URL game (untuk tombol callback_game) atau link seperti t.me/your_bot?start=XXXX |
cache_time | Berapa detik hasil boleh di-cache di klien, default 0 |
Jawab dengan cepat: query yang sudah lama gagal dengan Bad Request: query is too old and response timeout expired or query ID is invalid. Detailnya ada di referensi answerCallbackQuery.
Edit pesan setelah tombol ditekan
Memperbarui pesan yang sudah ada lebih cepat dan rapi daripada mengirim pesan baru, dan Telegram menyarankannya untuk menu pengaturan dan paginasi. Ambil chat.id dan message_id dari callback_query.message, lalu panggil:
editMessageTextuntuk mengubah teks, opsional denganreply_markupbaru;editMessageReplyMarkupuntuk mengganti keyboard saja; hilangkanreply_markupuntuk menghapusnya.
Jika teks dan keyboard baru sama persis dengan yang sekarang, API mengembalikan Bad Request: message is not modified, jadi bandingkan dulu sebelum mengedit atau abaikan error khusus itu.
Contoh lengkap: menu inline dengan tombol callback
Bot ini membalas /start dengan menu, menghitung jumlah suka per pesan, menampilkan alert untuk Bantuan, dan mengedit pesan setiap ada perubahan. Bot memakai long polling getUpdates, jadi bisa berjalan di localhost tanpa webhook. Set dulu BOT_TOKEN di environment.
import os
import requests
TOKEN = os.environ["BOT_TOKEN"]
API = f"https://api.telegram.org/bot{TOKEN}"
likes = {} # (chat_id, message_id) -> jumlah
def call(method, **params):
data = requests.post(f"{API}/{method}", json=params, timeout=40).json()
if not data["ok"]:
raise RuntimeError(f"{method}: {data['error_code']} {data['description']}")
return data["result"]
def menu(count):
return {"inline_keyboard": [
[{"text": f"Suka ({count})", "callback_data": "like", "style": "success"},
{"text": "Reset", "callback_data": "reset", "style": "danger"}],
[{"text": "Bantuan", "callback_data": "help"},
{"text": "Dokumentasi Bot API", "url": "https://core.telegram.org/bots/api"}],
]}
def on_callback(cq):
msg, data = cq.get("message"), cq.get("data")
if not msg or data not in ("like", "reset", "help"):
call("answerCallbackQuery", callback_query_id=cq["id"], text="Tombol tidak dikenal")
return
if data == "help":
call("answerCallbackQuery", callback_query_id=cq["id"], show_alert=True,
text="Suka menambah satu, Reset mengulang dari nol.")
return
key = (msg["chat"]["id"], msg["message_id"])
old = likes.get(key, 0)
new = old + 1 if data == "like" else 0
call("answerCallbackQuery", callback_query_id=cq["id"],
text="Terima kasih!" if data == "like" else "Penghitung direset")
if new != old: # hindari "message is not modified"
likes[key] = new
call("editMessageText", chat_id=key[0], message_id=key[1],
text=f"Suka: {new}", reply_markup=menu(new))
offset = 0
while True:
updates = call("getUpdates", offset=offset, timeout=30,
allowed_updates=["message", "callback_query"])
for update in updates:
offset = update["update_id"] + 1
if "callback_query" in update:
on_callback(update["callback_query"])
elif update.get("message", {}).get("text") == "/start":
chat_id = update["message"]["chat"]["id"]
call("sendMessage", chat_id=chat_id, text="Suka: 0", reply_markup=menu(0))const TOKEN = process.env.BOT_TOKEN;
const API = `https://api.telegram.org/bot${TOKEN}`;
const likes = new Map(); // "chatId:messageId" -> jumlah
async function call(method, params = {}) {
const res = await fetch(`${API}/${method}`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(params),
signal: AbortSignal.timeout(40_000),
});
const data = await res.json();
if (!data.ok) throw new Error(`${method}: ${data.error_code} ${data.description}`);
return data.result;
}
function menu(count) {
return { inline_keyboard: [
[{ text: `Suka (${count})`, callback_data: "like", style: "success" },
{ text: "Reset", callback_data: "reset", style: "danger" }],
[{ text: "Bantuan", callback_data: "help" },
{ text: "Dokumentasi Bot API", url: "https://core.telegram.org/bots/api" }],
] };
}
async function onCallback(cq) {
const msg = cq.message;
const data = cq.data;
if (!msg || !["like", "reset", "help"].includes(data)) {
await call("answerCallbackQuery", { callback_query_id: cq.id, text: "Tombol tidak dikenal" });
return;
}
if (data === "help") {
await call("answerCallbackQuery", { callback_query_id: cq.id, show_alert: true,
text: "Suka menambah satu, Reset mengulang dari nol." });
return;
}
const key = `${msg.chat.id}:${msg.message_id}`;
const old = likes.get(key) ?? 0;
const next = data === "like" ? old + 1 : 0;
await call("answerCallbackQuery", { callback_query_id: cq.id,
text: data === "like" ? "Terima kasih!" : "Penghitung direset" });
if (next !== old) { // hindari "message is not modified"
likes.set(key, next);
await call("editMessageText", { chat_id: msg.chat.id, message_id: msg.message_id,
text: `Suka: ${next}`, reply_markup: menu(next) });
}
}
let offset = 0;
while (true) {
const updates = await call("getUpdates", { offset, timeout: 30,
allowed_updates: ["message", "callback_query"] });
for (const update of updates) {
offset = update.update_id + 1;
if (update.callback_query) {
await onCallback(update.callback_query);
} else if (update.message?.text === "/start") {
await call("sendMessage", { chat_id: update.message.chat.id, text: "Suka: 0",
reply_markup: menu(0) });
}
}
}Simpan versi JavaScript sebagai bot.mjs (memakai top-level await) dan jalankan dengan Node.js 18+. Penghitung disimpan di memori; bot sungguhan menyimpannya di database. Hapus field style jika ingin warna tombol default.
Reply keyboard Telegram
Reply keyboard menawarkan jawaban yang sudah disiapkan. Tombol teks biasa, yang juga bisa ditulis sebagai string saja, mengirim teksnya ke chat seolah-olah diketik pengguna, sehingga bot menanganinya seperti pesan lain:
{
"keyboard": [
["Katalog", "Keranjang"],
[{"text": "Bagikan nomor HP", "request_contact": true},
{"text": "Kirim lokasi", "request_location": true}]
],
"resize_keyboard": true,
"one_time_keyboard": true,
"input_field_placeholder": "Pilih menu"
}
| Field | Efek |
|---|---|
resize_keyboard | Menyesuaikan tinggi dengan jumlah baris; secara default tingginya sama dengan keyboard standar |
one_time_keyboard | Menyembunyikan keyboard setelah ditekan; pengguna bisa membukanya lagi lewat ikon keyboard |
is_persistent | Selalu menampilkan keyboard saat keyboard biasa disembunyikan |
input_field_placeholder | Placeholder di kolom input, 1–64 karakter |
selective | Menampilkan keyboard hanya ke pengguna yang di-@mention atau pengirim pesan yang dibalas |
Tombol khusus hanya berfungsi di chat pribadi: request_contact mengirim nomor telepon pengguna sebagai kontak, request_location lokasi saat ini, request_poll meminta pengguna membuat polling, dan web_app membuka Mini App. request_users (KeyboardButtonRequestUsers) dan request_chat (KeyboardButtonRequestChat) membuka pemilih dan mengembalikan hasilnya di pesan layanan users_shared dan chat_shared; keduanya butuh request_id, angka signed 32-bit yang unik dalam pesan tersebut:
{"keyboard": [[
{"text": "Pilih pengguna", "request_users": {"request_id": 1, "user_is_bot": false, "max_quantity": 3}},
{"text": "Pilih grup saya", "request_chat": {"request_id": 2, "chat_is_channel": false, "chat_is_created": true}}
]], "resize_keyboard": true}
ReplyKeyboardRemove dan ForceReply
Reply keyboard tetap terlihat sampai bot mengirim keyboard lain. Untuk menghapusnya, kirim pesan dengan {"remove_keyboard": true}. ForceReply, misalnya {"force_reply": true, "input_field_placeholder": "Kota kamu"}, membuka antarmuka balasan ke pesan bot, seolah-olah pengguna menekan Reply. Ini berguna untuk input bertahap di grup, karena jawabannya tetap sampai ke bot meskipun privacy mode aktif. Sama seperti reply keyboard, kedua objek ini tidak berfungsi di channel.
Coba di Bot API Tester
- Buka sendMessage di Bot API Tester lalu masukkan token dan chat id kamu.
- Tempel salah satu keyboard JSON di atas ke
reply_markupdan jalankan. - Tekan tombol callback di Telegram, lalu jalankan
getUpdatesdi tester untuk melihat updatecallback_query, dan jawab dengan answerCallbackQuery.
Troubleshooting tombol bot Telegram
| Gejala | Penyebab dan solusi |
|---|---|
| Indikator loading setelah tombol ditekan | Tidak ada panggilan answerCallbackQuery. Jawab setiap callback query. |
Tidak ada update callback_query | allowed_updates tidak berisi callback_query, atau proses lain mengambil update (webhook atau instance polling kedua). |
BUTTON_DATA_INVALID | callback_data kosong atau lebih dari 64 byte. |
message is not modified | Edit tidak mengubah teks maupun keyboard. |
query is too old… | Jawaban terlambat, misalnya setelah restart bot memproses update lama. |
| Tombol kontak atau lokasi tidak berfungsi di grup | Tombol ini hanya tersedia di chat pribadi. |
Daftar lengkap pesan error ada di error Telegram Bot API. Format teks dan opsi sendMessage lainnya dibahas di cara kirim pesan lewat Bot API, dan tombol switch-to-inline cocok dipadukan dengan inline mode.
Pertanyaan umum
Apa bedanya inline keyboard dan reply keyboard di Telegram?
Inline keyboard (InlineKeyboardMarkup) menempel pada pesan tertentu; menekan tombolnya tidak mengirim apa pun ke chat. Reply keyboard (ReplyKeyboardMarkup) menggantikan keyboard huruf pengguna; tombol teks biasa mengirim teksnya sebagai pesan biasa.
Berapa panjang maksimal callback_data?
1–64 byte. Byte, bukan karakter: huruf non-Latin memakan 2 byte atau lebih di UTF-8. Simpan key pendek seperti item:42 dan taruh data aslinya di server.
Kenapa tombol terus menampilkan indikator loading setelah ditekan?
Bot tidak memanggil answerCallbackQuery. Klien Telegram menampilkan progress bar sampai kamu menjawab, jadi panggil metode itu untuk setiap callback query, meskipun tanpa text.
Bagaimana cara mengganti tombol setelah pengguna menekan salah satunya?
Panggil editMessageReplyMarkup dengan chat_id dan message_id dari callback_query.message untuk mengganti keyboard saja, atau editMessageText untuk mengubah teks dan keyboard sekaligus.
Bagaimana cara menghapus reply keyboard?
Kirim pesan dengan reply_markup berisi {"remove_keyboard": true} (ReplyKeyboardRemove). Jika hanya ingin menyembunyikannya setelah satu kali tekan tapi tetap tersedia, pakai one_time_keyboard.
Bisakah menambahkan tombol ke pesan di channel?
Inline keyboard bisa. Reply keyboard, ReplyKeyboardRemove, dan ForceReply tidak didukung di channel.
Panduan terkait
Cara Membuat Bot Telegram: dari BotFather sampai Pesan Pertama
Cara membuat bot telegram langkah demi langkah: daftar di @BotFather, simpan token, cek dengan getMe, lalu kirim pesan pertama lewat curl dan Python.
Cara Deploy Bot Telegram: Hosting di VPS, Docker, dan Serverless
Cara deploy bot Telegram: polling vs webhook, service systemd di VPS, Docker, Cloudflare Workers dengan secret_token, plus checklist sebelum bot online.
Telegram Bot API 10.0–10.5: Pengaturan Bot, Widget, Rich Message, Ephemeral Message, Guest Mode, dan Lainnya
Fitur baru Telegram Bot API 10.0–10.5: setMySettings dan BotFullInfo, widget HTML, rich message, ephemeral message, guest mode, lengkap dengan contoh JSON.
Error Telegram Bot API: Arti Setiap Error dan Cara Mengatasinya
Daftar error Telegram Bot API: 400 chat not found, 403 bot was blocked by the user, 409 Conflict, 429 retry_after. Penyebab, solusi, dan kode penanganan.
Limit Telegram Bot API: Rate Limit, Error 429, Ukuran File, dan Panjang Pesan
Limit Telegram Bot API: 30 pesan/detik, 1 pesan/detik per chat, 20/menit di grup, cara menangani 429 retry_after, batas ukuran file dan panjang pesan.
Perintah Bot Telegram: setMyCommands, Scope Perintah, dan Deep Link /start
Cara membuat perintah bot Telegram: /setcommands di @BotFather, setMyCommands dengan scope dan bahasa, parameter deep link /start, dan /cmd@bot di grup.
Integrasi n8n Telegram: Hubungkan Bot, Jalankan Workflow, dan Kirim Pesan
Cara menghubungkan n8n ke Telegram: token bot sebagai Access Token, webhook Telegram Trigger via HTTPS publik, kirim pesan via chat id, dan solusi error.
Kirim Pesan Bot Telegram dengan Telegram Bot API (sendMessage)
Kirim pesan bot telegram lewat Bot API: contoh sendMessage dengan curl, Python, dan JavaScript, format HTML/MarkdownV2, tombol inline, dan solusi error.
Telegram Bot Token: Cara Mendapatkan, Mengecek, dan Mencabut Token
Cara mendapatkan token bot telegram dari @BotFather, melihat token bot lama, mengecek dengan getMe, dan me-revoke token yang bocor. Lengkap dengan contoh.
Webhook Telegram Bot: Cara Setting setWebhook, Secret Token, dan Mengatasi Error
Panduan webhook telegram bot: syarat HTTPS dan port, setWebhook dengan secret_token, cek getWebhookInfo, deleteWebhook, serta solusi error 409 dan n8n.
Chat ID Telegram Dimana? Cara Mendapatkan Chat ID User, Grup, dan Channel
Chat id telegram dimana? Cara mendapatkan chat id user, grup, supergroup, dan channel lewat getUpdates, plus solusi saat result kosong atau error 409.
Bot Inline Telegram: Cara Mengaktifkan Mode Inline dan Menjawab Inline Query
Cara membuat bot inline Telegram: aktifkan mode inline lewat @BotFather atau setMySettings, tangani update inline_query, lalu balas via answerInlineQuery.
Pembayaran Telegram Stars untuk Bot: Invoice, Pre-Checkout, Refund, dan Langganan
Cara menerima pembayaran Telegram Stars di bot: sendInvoice dengan XTR, pre_checkout_query, successful_payment, refund, langganan, plus kode Python/JS.
Server Test Telegram: Cara Test Bot di Lingkungan Test Telegram
Cara memakai server test Telegram untuk bot: login ke lingkungan test, buat bot test, panggil Bot API lewat /test/, lalu aktifkan TEST di tester kami.
Widget Telegram untuk Website: Login dengan Telegram, Embed Post, Komentar, dan Tombol Share
Pasang widget telegram untuk website: login dengan Telegram (OIDC), Login Widget lama dengan cek hash, embed post, komentar channel, dan tombol share.
API JavaScript TelegramWidget: Referensi, Event, Kode Error, dan Batasan
Referensi API JavaScript TelegramWidget: properti, request(), event, kode error, variabel CSS, widget_query dan answerWidgetQuery, plus semua batasannya.
Contoh Widget Telegram: Kode HTML dan Bot Python Lengkap
Contoh widget telegram lengkap dengan kode: kartu pesanan statis, counter dengan request widget_query, polling live sebagai widget shared, preview lokal.
Widget Telegram: HTML Interaktif di Dalam Pesan Bot
Widget telegram (Bot API 10.4): apa itu, cara kerja sendWidget, chat_data dan public_data, di mana bisa dipakai saat ini, dan bedanya dengan Mini App.
Cara Tes Telegram Mini App: Dari Mock di Browser sampai Telegram Asli
Cara tes Telegram Mini App: mode mock di browser, localhost lewat tunnel HTTPS, test environment, DevTools per platform, dan validasi initData di server.