Bot Inline Telegram: Cara Mengaktifkan Mode Inline dan Menjawab Inline Query
Bot inline Telegram menjawab query yang diketik langsung di kolom pesan: pengguna menulis @your_bot dan teks di chat mana pun, bot menerima update inline_query lalu membalas dengan answerInlineQuery, dan pengguna mengetuk salah satu hasil untuk mengirimnya. Untuk membuatnya, aktifkan mode inline (lewat /setinline di @BotFather atau, sejak Bot API 10.5, dengan setMySettings), tangani update inline_query, dan kembalikan maksimal 50 hasil. Di bawah ini ada setiap langkah plus contoh lengkap dalam Python dan JavaScript.
Cara kerja mode inline
Mode inline berfungsi di chat mana pun, bahkan di chat yang tidak diikuti bot. Alurnya:
- Pengguna mengetik username bot dan query di kolom input, misalnya
@your_bot hello. Belum ada yang terkirim ke chat. - Bot menerima update
inline_query. - Bot memanggil
answerInlineQuerydengan daftar hasil: artikel, foto, GIF, video, stiker, lokasi, dan lainnya. - Pengguna mengetuk salah satu hasil. Pesan dikirim oleh pengguna, dan username bot tampil di samping nama pengirim; di Bot API pesan seperti ini punya field
via_bot. - Opsional: bot menerima update
chosen_inline_resultyang memberi tahu hasil mana yang dikirim.
Mengaktifkan mode inline bot Telegram
Mode inline nonaktif untuk bot baru. Kalau belum punya bot, mulai dari panduan cara membuat bot Telegram. Lalu pilih salah satu dari dua cara berikut.
Cara 1: @BotFather
- Kirim
/setinlineke @BotFather dan pilih bot kamu. - Isi teks placeholder yang muncul di kolom input setelah pengguna mengetik username bot, misalnya Ketik teks untuk diformat…
- Opsional:
/setinlinegeomeminta lokasi pengguna di setiap query;/setinlinefeedbackmengaktifkan updatechosen_inline_result.
Cara 2: setMySettings (Bot API 10.5)
Sejak Bot API 10.5 bot bisa mengubah pengaturannya sendiri dengan setMySettings. Pengaturan yang tidak dikirim tetap seperti semula:
curl "https://api.telegram.org/bot123456789:AAEexampleTokenReplaceWithYours/setMySettings" \
-H "Content-Type: application/json" \
-d '{"supports_inline_queries": true, "inline_query_placeholder": "Ketik teks untuk diformat…", "inline_feedback_share_denominator": 1}'
Parameter yang terkait mode inline:
supports_inline_queries:truemengaktifkan mode inline,falsemenonaktifkannya.inline_query_placeholder: teks placeholder; string kosong mengembalikan placeholder default.needs_inline_query_location: minta lokasi pengguna di setiap inline query.inline_feedback_share_denominator: terima 1 dari N hasil yang dipilih; nilainya harus 1, 10, 100, atau 1000, dan0menghentikan updatechosen_inline_result.
Untuk mengecek hasilnya tanpa menulis kode, buka setMySettings di Bot API Tester, tempel token, jalankan, lalu panggil getMe: objek BotFullInfo di hasilnya berisi supports_inline_queries dan, jika kamu mengatur placeholder sendiri, inline_query_placeholder.
Update inline_query
Selama pengguna mengetik, bot menerima objek InlineQuery dengan field berikut:
| Field | Arti |
|---|---|
id | ID unik query; kirim ke answerInlineQuery sebagai inline_query_id |
from | Pengguna yang mengetik query |
query | Teks query, maksimal 256 karakter; bisa kosong — tampilkan hasil default atau populer |
offset | Offset hasil yang harus dikembalikan; diatur bot lewat next_offset |
chat_type | Opsional: sender (chat pribadi dengan pengirim query), private, group, supergroup, atau channel; biasanya tidak diketahui untuk secret chat |
location | Opsional; hanya jika bot meminta lokasi pengguna |
Jika kamu mengisi allowed_updates di getUpdates atau setWebhook, sertakan inline_query (dan chosen_inline_result jika diperlukan). Tanpa itu, update tersebut tidak akan datang.
Parameter answerInlineQuery
answerInlineQuery mengembalikan True jika berhasil. Maksimal 50 hasil per query.
| Parameter | Keterangan |
|---|---|
inline_query_id | Wajib. id dari query |
results | Wajib. Array objek InlineQueryResult (≤ 50) |
cache_time | Waktu maksimal (detik) hasil boleh di-cache di server; default 300 |
is_personal | true berarti hasil di-cache hanya untuk pengguna ini; secara default pengguna lain dengan query yang sama bisa mendapat hasil yang sama |
next_offset | Offset yang dikirim aplikasi bersama query berikutnya dengan teks yang sama; string kosong jika tidak ada hasil lagi; maksimal 64 byte |
button | InlineQueryResultsButton yang tampil di atas hasil |
Jenis hasil inline
Aplikasi Telegram mendukung 20 jenis hasil. Dua belas di antaranya berisi konten baru (article, photo, gif, mpeg4_gif, video, audio, voice, document, location, venue, contact, game), dan delapan jenis InlineQueryResultCached… memakai ulang file yang sudah tersimpan di server Telegram lewat file_id. Setiap hasil wajib punya type dan id sepanjang 1–64 byte. Yang paling sering dipakai:
- article:
titledaninput_message_contentwajib; opsionaldescription,url,thumbnail_url,reply_markup. Kontennya biasanyaInputTextMessageContentdenganmessage_text(1–4096 karakter) danparse_modeopsional. - photo:
photo_url(JPEG, maksimal 5 MB) danthumbnail_urlwajib; opsionalcaption(0–1024 karakter),title,description.
Semua URL di hasil inline bisa dilihat pengguna, jadi anggap saja publik. Aturan format parse_mode sama seperti di panduan kirim pesan bot Telegram.
Contoh bot inline Telegram dalam Python dan JavaScript
Bot ini memformat query menjadi tebal, miring, atau monospace. Query kosong mendapat tombol ke chat pribadi, tempat /start membalas dengan tombol untuk kembali ke mode inline. Isi environment variable BOT_TOKEN sebelum menjalankan.
import html
import os
import requests
TOKEN = os.environ["BOT_TOKEN"]
API = f"https://api.telegram.org/bot{TOKEN}"
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 article(result_id, title, text, message_html):
return {
"type": "article",
"id": result_id, # 1-64 byte, unik dalam satu jawaban
"title": title,
"description": text[:100],
"input_message_content": {"message_text": message_html, "parse_mode": "HTML"},
}
def on_inline_query(query):
text = query["query"].strip()
if not text: # query kosong: tanpa hasil, hanya tombol yang membuka chat pribadi
call("answerInlineQuery", inline_query_id=query["id"], results=[], cache_time=5,
button={"text": "Cara memakai bot ini", "start_parameter": "help"})
return
safe = html.escape(text)
results = [
article("bold", "Tebal", text, f"<b>{safe}</b>"),
article("italic", "Miring", text, f"<i>{safe}</i>"),
article("mono", "Monospace", text, f"<code>{safe}</code>"),
]
call("answerInlineQuery", inline_query_id=query["id"], results=results, cache_time=5)
def on_message(msg):
if msg.get("text", "").startswith("/start"): # termasuk "/start help" dari tombol
call("sendMessage", chat_id=msg["chat"]["id"],
text="Ketik username saya dan teks apa saja di chat mana pun untuk memformatnya.",
reply_markup={"inline_keyboard": [[
{"text": "Coba di sini", "switch_inline_query_current_chat": "Halo"},
{"text": "Pilih chat", "switch_inline_query": "Halo"},
]]})
offset = 0
while True:
updates = call("getUpdates", offset=offset, timeout=30,
allowed_updates=["message", "inline_query", "chosen_inline_result"])
for update in updates:
offset = update["update_id"] + 1
try:
if "inline_query" in update:
on_inline_query(update["inline_query"])
elif "chosen_inline_result" in update:
chosen = update["chosen_inline_result"]
print("dipilih:", chosen["result_id"], "untuk query:", chosen["query"])
elif "message" in update:
on_message(update["message"])
except RuntimeError as err:
print(err)const TOKEN = process.env.BOT_TOKEN;
const API = `https://api.telegram.org/bot${TOKEN}`;
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;
}
const escapeHtml = (s) => s.replace(/&/g, "&").replace(/</g, "<").replace(/>/g, ">");
function article(id, title, text, messageHtml) {
return {
type: "article",
id, // 1-64 byte, unik dalam satu jawaban
title,
description: text.slice(0, 100),
input_message_content: { message_text: messageHtml, parse_mode: "HTML" },
};
}
async function onInlineQuery(query) {
const text = query.query.trim();
if (!text) { // query kosong: tanpa hasil, hanya tombol yang membuka chat pribadi
await call("answerInlineQuery", {
inline_query_id: query.id, results: [], cache_time: 5,
button: { text: "Cara memakai bot ini", start_parameter: "help" },
});
return;
}
const safe = escapeHtml(text);
const results = [
article("bold", "Tebal", text, `<b>${safe}</b>`),
article("italic", "Miring", text, `<i>${safe}</i>`),
article("mono", "Monospace", text, `<code>${safe}</code>`),
];
await call("answerInlineQuery", { inline_query_id: query.id, results, cache_time: 5 });
}
async function onMessage(msg) {
if (msg.text?.startsWith("/start")) { // termasuk "/start help" dari tombol
await call("sendMessage", {
chat_id: msg.chat.id,
text: "Ketik username saya dan teks apa saja di chat mana pun untuk memformatnya.",
reply_markup: { inline_keyboard: [[
{ text: "Coba di sini", switch_inline_query_current_chat: "Halo" },
{ text: "Pilih chat", switch_inline_query: "Halo" },
]] },
});
}
}
let offset = 0;
while (true) {
const updates = await call("getUpdates", {
offset, timeout: 30, allowed_updates: ["message", "inline_query", "chosen_inline_result"],
});
for (const update of updates) {
offset = update.update_id + 1;
try {
if (update.inline_query) await onInlineQuery(update.inline_query);
else if (update.chosen_inline_result) {
const chosen = update.chosen_inline_result;
console.log("dipilih:", chosen.result_id, "untuk query:", chosen.query);
} else if (update.message) await onMessage(update.message);
} catch (err) {
console.error(err.message);
}
}
}Simpan versi JavaScript sebagai bot.mjs dan jalankan dengan Node.js 18+, lalu ketik @your_bot hello di chat mana pun. Handler yang sama juga bisa dipakai dengan webhook — lihat panduan webhook telegram bot.
Pagination dengan next_offset
Hasilnya lebih dari 50? Kirim per halaman: offset kosong di request pertama, dan next_offset milikmu dikirim kembali saat pengguna menggulir ke bawah:
PAGE_SIZE = 20 # answerInlineQuery menerima maksimal 50 hasil
def answer_page(query, items):
start = int(query["offset"] or 0) # offset bernilai "" di request pertama
page = items[start:start + PAGE_SIZE]
more = start + PAGE_SIZE < len(items)
call("answerInlineQuery", inline_query_id=query["id"], results=page,
next_offset=str(start + PAGE_SIZE) if more else "") # "" = tidak ada hasil lagiconst PAGE_SIZE = 20; // answerInlineQuery menerima maksimal 50 hasil
async function answerPage(query, items) {
const start = Number(query.offset || 0); // offset bernilai "" di request pertama
const page = items.slice(start, start + PAGE_SIZE);
const more = start + PAGE_SIZE < items.length;
await call("answerInlineQuery", {
inline_query_id: query.id, results: page,
next_offset: more ? String(start + PAGE_SIZE) : "", // "" = tidak ada hasil lagi
});
}chosen_inline_result dan inline feedback
Jika feedback aktif, bot menerima objek ChosenInlineResult berisi result_id, from, query, location opsional, dan inline_message_id opsional. Karena ada caching, bot populer bisa menerima lebih banyak hasil terpilih daripada query sebenarnya, jadi saat beban tinggi cukup terima 1/10, 1/100, atau 1/1000 di antaranya.
inline_message_id hanya ada jika pesan yang dikirim memiliki inline keyboard. Simpan nilainya untuk mengedit pesan nanti dengan editMessageText (kirim inline_message_id sebagai pengganti chat_id dan message_id); klik tombol di pesan itu datang sebagai callback_query dengan inline_message_id yang sama.
Tombol di atas hasil dan kembali ke chat
Parameter button menampilkan InlineQueryResultsButton di atas hasil (atau sebagai pengganti hasil). Tombol ini punya text dan tepat salah satu dari:
start_parameter: membuka chat pribadi dengan bot dan mengirim/start <parameter>; 1–64 karakter, hanyaA-Z,a-z,0-9,_, dan-.web_app: membuka Mini App, yang bisa kembali ke mode inline denganswitchInlineQuery.
Pola yang umum: minta pengguna menghubungkan akun dulu, lalu kirim tombol inline keyboard dengan switch_inline_query (pengguna memilih chat), switch_inline_query_current_chat (menyisipkan @your_bot query di chat saat ini), atau switch_inline_query_chosen_chat (membatasi pilihan ke pengguna, bot, grup, atau channel).
Troubleshooting
| Gejala | Kemungkinan penyebab dan solusi |
|---|---|
Tidak terjadi apa-apa setelah mengetik @your_bot | Mode inline belum aktif: pakai /setinline atau setMySettings. |
Update inline_query tidak datang | allowed_updates pernah diatur tanpa inline_query (daftar ini diingat), atau webhook masih aktif sehingga getUpdates mengembalikan 409 Conflict. |
| Hasil lama terus muncul | Caching di server: turunkan cache_time (default 300 detik) dan pakai is_personal untuk hasil per pengguna. |
400 Bad Request: query is too old and response timeout expired or query ID is invalid | Jawaban terlambat atau ID-nya salah. Jawab segera, kerjakan proses lambat di background. |
chosen_inline_result tidak datang | Inline feedback nonaktif: /setinlinefeedback atau inline_feedback_share_denominator. |
| Hasil foto tidak muncul | photo_url harus berupa JPEG publik maksimal 5 MB, dan thumbnail_url wajib diisi. |
Bot inline yang ramai juga harus memperhatikan limit Telegram Bot API.
Pertanyaan umum
Bagaimana cara mengaktifkan mode inline bot Telegram?
Kirim /setinline ke @BotFather, pilih bot, lalu isi teks placeholder. Sejak Bot API 10.5 bot juga bisa mengaktifkannya sendiri dengan setMySettings dan supports_inline_queries: true (plus inline_query_placeholder opsional).
Berapa banyak hasil yang bisa dikirim answerInlineQuery?
Maksimal 50 hasil per panggilan. Untuk daftar yang lebih panjang, kirim per halaman dan isi next_offset (maksimal 64 byte); aplikasi mengirimkannya kembali di offset saat pengguna menggulir.
Kenapa hasil inline tidak berubah setelah kode diperbarui?
Hasil bisa di-cache di server Telegram selama cache_time detik, default 300. Pakai cache_time kecil selama development, dan is_personal: true jika hasil bergantung pada pengguna.
Apakah bot inline harus ditambahkan ke chat?
Tidak. Pengguna cukup mengetik username bot dan query di kolom input chat mana pun; bot menerima update inline_query, dan hasil yang dipilih dikirim oleh pengguna dengan tanda username bot (via_bot).
Bagaimana cara tahu hasil inline mana yang dikirim pengguna?
Aktifkan inline feedback dengan /setinlinefeedback di @BotFather atau inline_feedback_share_denominator di setMySettings (1, 10, 100, atau 1000). Bot lalu menerima update chosen_inline_result berisi result_id dan query.
Kenapa inline_message_id tidak ada di chosen_inline_result?
Field itu hanya ada jika pesan yang dikirim memiliki inline keyboard. Tambahkan reply_markup ke hasil jika ingin mengedit pesan nanti atau menerima callback query darinya.
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.
Keyboard Bot Telegram: Inline Keyboard, Tombol Callback, dan Reply Keyboard
Cara membuat tombol bot Telegram: inline keyboard dengan callback_data, answerCallbackQuery, edit pesan setelah tombol ditekan, reply keyboard, ForceReply.
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.
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.