Telegram Bot API

Telegram Bot API 10.0–10.5: Pengaturan Bot, Widget, Rich Message, Ephemeral Message, Guest Mode, dan Lainnya

· 8 menit baca

Telegram Bot API 10.5, dirilis 22 November 2026, adalah versi Bot API terbaru dengan 194 metode. Seri 10.x yang dimulai dengan Bot API 10.0 pada 8 Mei 2026 membawa guest mode, live photo, rich message dengan draft streaming, ephemeral message, community, join request query, widget HTML interaktif di dalam pesan (10.4), serta di 10.5 metode setMySettings dan objek baru BotFullInfo yang dikembalikan getMe. Berikut fitur baru di setiap rilis, dengan contoh JSON singkat dan perubahan yang bisa merusak bot yang sudah berjalan.

Ringkasan Telegram Bot API 10

VersiTanggalSorotan
10.08 Mei 2026Guest mode, live photo, media di polling, penghapusan reaksi
10.111 Juni 2026Rich message dan rich draft, join request query
10.214 Juli 2026Ephemeral message, community, update subscription, proteksi origin Mini App
10.324 Agustus 2026EphemeralMessageParameters, draft yang bisa dihentikan, DisabledButton, tombol di rich message
10.49 November 2026Widget HTML, balasan ephemeral untuk callback query di chat mana pun, kutipan dari rich message, kartu wallet TON, tema share chat
10.522 November 2026setMySettings, BotFullInfo di getMe, callback_query_mode, link undangan bot, blok di expandable quotation

Bot API 10.0: guest mode, live photo, dan polling

Guest mode. Setelah Guest Mode diaktifkan di Mini App @BotFather, pengguna bisa me-mention bot di chat yang tidak diikuti bot. Bot menerima update guest_message dan bisa mengirim satu balasan dengan answerGuestQuery, berisi guest_query_id dari pesan dan sebuah InlineQueryResult:

{
  "guest_query_id": "<message.guest_query_id>",
  "result": {
    "type": "article",
    "id": "1",
    "title": "Terjemahan",
    "input_message_content": {"message_text": "Bonjour tout le monde"}
  }
}

Bot tamu tidak punya akses ke riwayat chat atau daftar anggota, dan tidak melihat pesan berikutnya kecuali di-mention atau dibalas lagi.

Bot API 10.1: rich message Telegram dan join request query

Rich message ditujukan untuk output terstruktur seperti laporan, dokumentasi, dan jawaban AI. sendRichMessage menerima objek rich_message dengan konten di html atau markdown (10.2 menambahkan blocks eksplisit dan daftar media). Yang didukung: heading, list dan task list, tabel, kutipan, detail yang bisa dilipat, catatan kaki, rumus LaTeX, peta, kolase, slideshow, dan blok media. Batasnya: 32768 karakter UTF-8, 500 blok, 16 level nesting, 50 media, dan 20 kolom tabel.

curl -X POST "https://api.telegram.org/bot123456789:AAEexampleTokenReplaceWithYours/sendRichMessage" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": 123456789,
    "rich_message": {
      "markdown": "# Laporan mingguan\n\n| Metrik | Nilai |\n|:-------|------:|\n| Pengguna | **1204** |\n| Error | 3 |\n\n- [x] Deploy v2.1\n- [ ] Perbarui dokumentasi\n\n$$E = mc^2$$"
    }
  }'

sendRichMessageDraft men-streaming rich message parsial ke chat pribadi selama masih dibuat. Draft hanya pratinjau sementara selama 30 detik, jadi akhiri dengan sendRichMessage. editMessageText kini juga menerima rich_message.

Join request query. Jika bot dipasang sebagai guard bot sebuah chat, update chat_join_request membawa query_id. Putuskan langsung dengan answerChatJoinRequestQuery (approve, decline, atau queue untuk menyerahkan keputusan ke admin lain), atau tampilkan dulu Mini App dengan sendChatJoinRequestWebApp; Mini App menerima chat_join_request_query_id di init data.

{"chat_join_request_query_id": "<chat_join_request.query_id>", "result": "approve"}

Polling juga mendapat media berupa link di 10.1.

Bot API 10.2: ephemeral message Telegram, community, dan keamanan Mini App

Ephemeral message adalah pesan grup yang hanya terlihat oleh satu pengguna dan bot, sehingga petunjuk, teks sambutan, dan hasil pribadi tidak memenuhi timeline bersama. Pengguna juga bisa mengirim perintah ephemeral (BotCommand.is_ephemeral) yang tidak dilihat orang lain. Aturan pengirimannya:

Ephemeral message punya metode sendiri: editEphemeralMessageText, editEphemeralMessageMedia, editEphemeralMessageCaption, editEphemeralMessageReplyMarkup, dan deleteEphemeralMessage:

{"chat_id": -1001234567890, "receiver_user_id": 123456789, "ephemeral_message_id": 15}

Bot API 10.3: EphemeralMessageParameters, draft yang bisa dihentikan, dan DisabledButton

Breaking change untuk ephemeral message. Parameter receiver_user_id dan callback_query_id dari 10.2 diganti di 13 metode kirim (sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendLivePhoto, sendSticker, sendVideoNote, sendVoice, sendContact, sendLocation, sendVenue) dengan satu objek, ephemeral_message_parameters. sendRichMessage juga menerimanya, dan field baru replace_callback_query_message menampilkan pesan ephemeral menggantikan pesan yang tombolnya ditekan:

{
  "chat_id": -1001234567890,
  "text": "Hanya kamu yang bisa melihat ini.",
  "ephemeral_message_parameters": {
    "receiver_user_id": 123456789,
    "callback_query_id": "<callback_query.id>",
    "replace_callback_query_message": true
  }
}

Draft yang bisa dihentikan. Kirim can_stop ke sendMessageDraft atau sendRichMessageDraft untuk menampilkan tombol Stop. Saat pengguna menekannya, bot menerima update stopped_message_generation berisi chat dan draft_id, sehingga kamu bisa menghentikan model. keep_on_stop membiarkan draft parsial tetap terlihat sebentar; kirim sebagai pesan biasa jika harus tetap ada.

import time
import requests

API = "https://api.telegram.org/bot123456789:AAEexampleTokenReplaceWithYours"
text, last = "", 0.0
for chunk in generate_reply():          # stream token dari LLM kamu
    text += chunk
    if time.monotonic() - last > 0.5:   # jangan kirim draft per token
        requests.post(f"{API}/sendMessageDraft", json={"chat_id": 123456789,
                      "draft_id": 1, "text": text, "can_stop": True}, timeout=10)
        last = time.monotonic()
requests.post(f"{API}/sendMessage", json={"chat_id": 123456789, "text": text}, timeout=10)
const API = "https://api.telegram.org/bot123456789:AAEexampleTokenReplaceWithYours";
const post = (method, body) => fetch(`${API}/${method}`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify(body),
  signal: AbortSignal.timeout(10_000),
});

let text = "", last = 0;
for await (const chunk of generateReply()) {  // stream token dari LLM kamu
  text += chunk;
  if (Date.now() - last > 500) {               // jangan kirim draft per token
    await post("sendMessageDraft", { chat_id: 123456789,
      draft_id: 1, text, can_stop: true });
    last = Date.now();
  }
}
await post("sendMessage", { chat_id: 123456789, text });

Bot API 10.4: widget Telegram, balasan ephemeral di chat mana pun, dan wallet TON

Widget. Bot kini bisa mengirim blok HTML interaktif kecil di dalam pesan. Widget adalah satu dokumen HTML (hingga 32768 byte, 4096 byte setelah kompresi zlib) yang dijalankan aplikasi di sandbox tanpa akses jaringan, plus state yang hanya bisa diubah bot: chat_data untuk satu pesan dan public_data yang dibagikan di mana pun widget ditampilkan. Metode baru: sendWidget, sendSharedWidget, answerWidgetQuery, editMessageWidgetData, dan editSharedWidgetData; update baru: widget_query dan shared_widget_query; inline mode mendapat InputWidgetMessageContent dan InputSharedWidgetMessageContent (untuk sementara hanya di server tes).

{
  "chat_id": 123456789,
  "html": "<h3>Pesanan #1042</h3><p>2 × Margherita, 1 × Lemonade</p><p><strong>Total: $23.50</strong></p>",
  "caption": "Pesanan #1042: $23.50"
}

Di produksi, widget saat ini hanya berfungsi di chat pribadi dan dikirim dengan protected content, sehingga tidak bisa diteruskan; grup, inline mode, dan forward hanya berfungsi di server tes. Pesan widget tidak bisa disalin dengan copyMessage / copyMessages, dan izin can_send_other_messages kini juga mencakup widget. Detailnya: penjelasan widget Telegram.

Balasan ephemeral untuk callback query di chat mana pun (kecuali chat direct messages channel). Kirim callback_query_id tanpa receiver_user_id di ephemeral_message_parameters, dan pesan hanya ditampilkan ke pengguna yang menekan tombol. receiver_user_id dan parameter chat_id di metode kirim kini opsional. Kamu tetap harus memanggil answerCallbackQuery.

{
  "text": "Hanya kamu yang bisa melihat jawaban ini.",
  "ephemeral_message_parameters": {"callback_query_id": "<callback_query.id>"}
}

Bot API 10.5: setMySettings, BotFullInfo, dan link undangan bot

Pengaturan bot dari kode. Metode baru setMySettings mengubah pengaturan yang sebelumnya hanya ada di @BotFather. Semua parameter opsional, jadi kirim hanya yang ingin diubah; metode ini mengembalikan True:

{
  "supports_inline_queries": true,
  "inline_query_placeholder": "Cari resep...",
  "can_join_groups": false,
  "has_topics_enabled": true,
  "callback_query_mode": "auto"
}

Kirim ke https://api.telegram.org/bot<token>/setMySettings atau coba dengan token kamu di Bot API Tester, lalu panggil getMe untuk mengecek hasilnya.

BotFullInfo (breaking change). getMe kini mengembalikan objek baru BotFullInfo, bukan User, dan field yang dulu hanya dikembalikan getMe dihapus dari User. BotFullInfo juga menambahkan active_usernames, inline_query_placeholder, needs_inline_query_location, dan has_topic_sidebar. Kode yang membaca field seperti can_join_groups, can_read_all_group_messages, atau supports_inline_queries dari hasil getMe tetap berfungsi, karena field tersebut ada di BotFullInfo. Yang rusak adalah kode yang mengharapkan field itu di objek User lain, serta kode bertipe yang mendeklarasikan hasil getMe sebagai User.

Cara upgrade bot ke Bot API 10.5

  1. Perbarui library kamu (python-telegram-bot, aiogram, grammY, Telegraf, dan lainnya) ke rilis yang mencantumkan dukungan Bot API 10.5 di changelog-nya.
  2. Pindahkan receiver_user_id dan callback_query_id gaya 10.2 ke dalam ephemeral_message_parameters.
  3. Jika kamu mengirim daftar allowed_updates eksplisit, tambahkan tipe baru yang kamu tangani: guest_message, subscription, stopped_message_generation, widget_query, shared_widget_query.
  4. Longgarkan validasi polling: satu opsi kini diperbolehkan.
  5. Untuk Mini App, pastikan setiap panggilan Telegram.WebApp berjalan di domain yang terdaftar.
  6. Ganti StoryAreaPosition menjadi AreaPosition jika kode kamu merujuk tipe itu berdasarkan nama.
  7. Perlakukan hasil getMe sebagai BotFullInfo, dan berhenti membaca field khusus getMe seperti can_join_groups dari objek User lain.
  8. Di rich message, susun expandable quotation dengan blocks, bukan text.
  9. Jika kamu mengganti callback_query_mode ke "auto" atau "inline", pastikan handler callback menerima inline_message_id saat message tidak ada.
  10. Coba metode baru dengan token kamu di Bot API Tester: setMySettings, sendWidget, sendRichMessage, deleteEphemeralMessage, dan answerChatJoinRequestQuery.

Ephemeral message dan pesan biasa punya dasar yang sama, jadi panduan kirim pesan lewat Bot API bagus untuk penyegaran, dan limit Telegram Bot API mencantumkan limit rich message di samping limit klasik. Riwayat lengkapnya ada di changelog Bot API resmi.

Pertanyaan umum

Apa versi Telegram Bot API terbaru?

Bot API 10.5, dirilis 22 November 2026, dengan 194 metode. Ini rilis keenam seri 10.x yang dimulai dengan Bot API 10.0 pada 8 Mei 2026. Versi ini menambahkan setMySettings, yang memungkinkan bot mengubah pengaturannya sendiri, dan getMe kini mengembalikan BotFullInfo. Versi sebelumnya, 10.4 (9 November 2026), menambahkan widget HTML di pesan.

Apa itu rich message di Telegram?

Rich message (Bot API 10.1) adalah pesan terstruktur yang dikirim dengan sendRichMessage: heading, list, tabel, rumus LaTeX, blok media, peta, dan sejak 10.3 juga tombol. Kontennya dikirim sebagai HTML, Markdown, atau blok di rich_message, hingga 32768 karakter UTF-8.

Apa itu ephemeral message di bot Telegram?

Ephemeral message (Bot API 10.2) adalah pesan di grup atau supergrup yang hanya bisa dilihat satu pengguna dan bot. Sejak 10.3 pesan ini dikirim dengan ephemeral_message_parameters di sendMessage dan metode kirim lainnya; sejak 10.4 bot juga bisa membalas callback query secara ephemeral di chat mana pun kecuali chat direct messages channel. Pengiriman tidak dijamin, terutama jika pengguna sedang offline.

Bagaimana cara streaming jawaban AI di bot Telegram?

Di chat pribadi, panggil sendMessageDraft atau sendRichMessageDraft berulang kali dengan draft_id yang sama, lalu kirim teks final dengan sendMessage atau sendRichMessage, karena draft hanya pratinjau sementara selama 30 detik. Dengan can_stop, pengguna mendapat tombol Stop dan bot menerima stopped_message_generation.

Apa itu setMySettings di Telegram Bot API 10.5?

setMySettings memungkinkan bot mengubah pengaturannya sendiri tanpa @BotFather: inline mode, privacy mode, bergabung ke grup, koneksi bisnis, guest query dan join request query, topik di chat pribadi, komunikasi antarbot, serta callback_query_mode. Kirim hanya field yang ingin diubah; hasilnya True. Nilai saat ini bisa dibaca dari getMe, yang kini mengembalikan BotFullInfo.

Apa itu guest mode di Telegram Bot API 10.0?

Guest mode memungkinkan bot membalas saat di-mention di chat yang tidak ia ikuti. Bot menerima update guest_message dan menjawab sekali dengan answerGuestQuery, tanpa akses ke riwayat chat. Fitur ini diaktifkan di Mini App @BotFather.

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.

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.

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.