Telegram Bot API

Bot Inline Telegram: Cara Mengaktifkan Mode Inline dan Menjawab Inline Query

· 8 menit baca

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:

  1. Pengguna mengetik username bot dan query di kolom input, misalnya @your_bot hello. Belum ada yang terkirim ke chat.
  2. Bot menerima update inline_query.
  3. Bot memanggil answerInlineQuery dengan daftar hasil: artikel, foto, GIF, video, stiker, lokasi, dan lainnya.
  4. 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.
  5. Opsional: bot menerima update chosen_inline_result yang 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

  1. Kirim /setinline ke @BotFather dan pilih bot kamu.
  2. Isi teks placeholder yang muncul di kolom input setelah pengguna mengetik username bot, misalnya Ketik teks untuk diformat…
  3. Opsional: /setinlinegeo meminta lokasi pengguna di setiap query; /setinlinefeedback mengaktifkan update chosen_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:

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:

FieldArti
idID unik query; kirim ke answerInlineQuery sebagai inline_query_id
fromPengguna yang mengetik query
queryTeks query, maksimal 256 karakter; bisa kosong — tampilkan hasil default atau populer
offsetOffset hasil yang harus dikembalikan; diatur bot lewat next_offset
chat_typeOpsional: sender (chat pribadi dengan pengirim query), private, group, supergroup, atau channel; biasanya tidak diketahui untuk secret chat
locationOpsional; 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.

ParameterKeterangan
inline_query_idWajib. id dari query
resultsWajib. Array objek InlineQueryResult (≤ 50)
cache_timeWaktu maksimal (detik) hasil boleh di-cache di server; default 300
is_personaltrue berarti hasil di-cache hanya untuk pengguna ini; secara default pengguna lain dengan query yang sama bisa mendapat hasil yang sama
next_offsetOffset yang dikirim aplikasi bersama query berikutnya dengan teks yang sama; string kosong jika tidak ada hasil lagi; maksimal 64 byte
buttonInlineQueryResultsButton 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:

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, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");

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 lagi
const 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:

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

GejalaKemungkinan penyebab dan solusi
Tidak terjadi apa-apa setelah mengetik @your_botMode inline belum aktif: pakai /setinline atau setMySettings.
Update inline_query tidak datangallowed_updates pernah diatur tanpa inline_query (daftar ini diingat), atau webhook masih aktif sehingga getUpdates mengembalikan 409 Conflict.
Hasil lama terus munculCaching 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 invalidJawaban terlambat atau ID-nya salah. Jawab segera, kerjakan proses lambat di background.
chosen_inline_result tidak datangInline feedback nonaktif: /setinlinefeedback atau inline_feedback_share_denominator.
Hasil foto tidak munculphoto_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.

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.