Basis pengetahuan GetMyBot

Pesan dan tombol

Susun balasan bot dengan teks, foto, dan tombol. Ajukan pertanyaan lalu simpan jawaban pelanggan.

Di halaman ini

Untuk mengirim teks, foto, dan tombol “Pilih”, tambahkan tindakan Kirim pesan. Balasan terdiri dari beberapa bagian yang disebut blok. Misalnya, Anda dapat mengirim foto produk lebih dulu, lalu deskripsi dengan tombol di bawahnya. Tombol di bawah pesan juga disebut tombol inline.

Dalam tindakan yang sama, bot dapat mengajukan pertanyaan dan menunggu jawabannya. Misalnya, bot meminta nomor telepon lalu menyimpannya dalam profil pelanggan. Di bawah ini dijelaskan blok, tombol, dan pengaturan pertanyaan.

Blok pesan

Klik Tambah blok dan pilih yang akan dikirim. Anda dapat menggabungkan teks sambutan, foto, dan berkas berisi jadwal kelas.

  • Teks: teks berformat hingga 4.096 karakter, dengan penggantian nilai dan tombol.
  • Foto: gambar dengan keterangan.
  • Berkas: dokumen dengan keterangan.
  • Pesan suara: OGG/OPUS, MP3, atau M4A hingga 50 MB yang ditampilkan Telegram sebagai pesan suara (sendVoice).
  • GIF: animasi atau MP4 tanpa suara hingga 50 MB (sendAnimation).
  • Pesan video bulat: MP4 persegi hingga 60 detik (sendVideoNote) tanpa keterangan. Berkas dari pustaka media diunggah lagi setiap kali dikirim karena Telegram tidak menerima file_id dari cara lain untuk sendVoice, sendAnimation, atau sendVideoNote.
  • Karusel: 2 sampai 10 kartu, masing-masing dengan foto, keterangan, dan tombol. Di Telegram, pengguna dapat berpindah kartu dengan “‹ ›” dalam satu pesan melalui editMessageMedia hanya jika setiap foto memiliki file_id yang sesuai, baik disimpan pada kartu maupun didapat dari pustaka media. Jika satu foto tidak memilikinya, semua kartu dikirim sebagai pesan foto terpisah. Begitu pula pada saluran lain seperti VK. Keterangan dan tombol setiap kartu tetap ada.
  • Jeda: tunggu beberapa detik sebelum blok berikutnya.
  • AI: balasan yang dibuat model berdasarkan instruksi Anda.
  • Reaksi: jalankan reaksi lain, jika perlu sambil menunggu hasilnya.

Pesan suara, GIF, pesan video bulat, dan karusel dapat digunakan dalam reaksi dan siaran cepat dari reaksi. Baca Siaran.

Anda dapat menyeret blok untuk mengubah urutannya. Pilih Berurutan atau Acak jika ingin variasi balasan. Menu utama bot dapat dibiarkan, diganti, atau disembunyikan.

Pengaturan blok

Pada blok teks dan media, Anda dapat mengaktifkan sematkan, kirim tanpa suara, lindungi dari penerusan, spoiler, tanpa pratinjau tautan, dan hapus otomatis setelah N detik.

Tombol di bawah pesan

Isi Teks tombol lalu pilih Tipe:

  • Teks: mengirim tulisan tombol sebagai jawaban pengguna. Di Telegram dan VK, tombol ini tampil pada papan tombol balasan; ketukannya dapat menjawab pertanyaan atau menjalankan reaksi yang mencari teks itu. Di WhatsApp, Instagram, Messenger, dan widget situs web, tombol tampil sebagai pilihan balasan tanpa papan tombol tetap.
  • Tautan: membuka alamat situs web.
  • Aplikasi web: membuka Telegram Mini App. Baca Mini App.
  • Reaksi: menjalankan reaksi lain ketika ditekan.
  • Inline query: menaruh “@bot pertanyaan” di kolom pesan saat ini atau meminta pengguna memilih obrolan lain (switch_inline_query / switch_inline_query_current_chat). Hanya tersedia di Telegram setelah mode inline diaktifkan melalui /setinline pada @BotFather. GetMyBot tidak menjawab permintaan inline karena answerInlineQuery belum tersedia. Tombol ini hanya menyiapkan teks, bukan melakukan pencarian.
  • Prefilled text: membuka https://t.me/<bot>?text=… dan menaruh teks dalam kolom pesan tanpa mengirimnya (prefill).
  • Payment link: membuka URL pembayaran yang wajib diisi. Pembayaran dibuat melalui tindakan Terbitkan tagihan. Ini membuka halaman pembayaran luar, bukan tagihan bawaan Telegram.
  • Notifikasi: menampilkan teks ketika ditekan, tanpa menjalankan reaksi atau mengirim data tombol Carry. Di Telegram, teks dapat tampil sebagai pemberitahuan singkat atau jendela hingga 200 karakter. Di VK, hanya pemberitahuan singkat hingga 90 karakter tanpa jendela.

Jawaban teks atau teks siap kirim

TujuanTipe dan pengaturanYang terjadi saat ditekan
Memilih “Ya” dalam formulirTeks, tulisan “Ya”; pesan harus menunggu jawabanLangkah percakapan menerima jawaban “Ya”
Menyiapkan pesan kepada botPrefilled text, tulisan “Tulis pesan”, isi “Saya ingin memesan”Teks muncul sebagai draf; pengguna dapat mengubah dan mengirimnya sendiri

Tulisan pada tombol dan isi draf adalah dua kolom berbeda. Teks siap kirim tidak mengirim pesan dan tidak menjalankan reaksi secara otomatis.

Tombol Reaksi mengirim ketukan sebagai peristiwa tersendiri kepada bot, yang disebut callback. Inline query dan Prefilled text bekerja di aplikasi Telegram tanpa mengirim callback ke bot. Karena itu, keduanya tidak mendukung answerCallbackQuery atau data Carry.

Ikon dan warna tombol

Anda dapat menampilkan emoji premium sebelum tulisan tombol. Isi ID pada icon_custom_emoji_id, berupa bilangan bulat positif hingga 64 bit. Misalnya, 007 dibaca sebagai 7. Huruf, nol, bilangan negatif, dan bilangan terlalu besar diabaikan; tombol akan tersimpan tanpa ikon.

Telegram hanya menampilkan ikon ini jika bot memiliki izin yang diperlukan: nama tambahan melalui Fragment, atau Telegram Premium milik pemilik bot saat mengirim langsung ke orang atau grup. Jika syaratnya tidak terpenuhi, Telegram mengabaikan ikon tanpa menggantinya dengan emoji biasa.

Gaya menentukan warna: Biasa tanpa warna tambahan, Utama biru, Sukses hijau, dan Berbahaya merah. Nama kolom teknisnya style.

Sekali pakai (single_use) membuat data tersimpan pada tombol hanya dapat digunakan satu kali, misalnya untuk mengonfirmasi pilihan. Penggantian tulisan tombol atau penghapusan pesan diatur secara terpisah dalam perilaku saat ditekan.

Pilihan tata letak tombol

Pilihan tambahan di editor:

  • Di baris baru: menaruh tombol pada baris berikutnya.
  • Rentangkan ke seluruh lebar: menaruh tombol sendirian dalam satu baris; tombol berikutnya juga mulai pada baris baru.

Contoh tampilan, dengan tanda kurung siku sebagai tombol:

Satu baris:       [Katalog] [Bantuan]

Baris baru:       [Katalog]
                  [Bantuan]

Lebar penuh:      [        Bantuan        ]

Baris dan warna tersedia di Telegram serta VK. Tata letak tetap tersimpan saat pesan dibuka kembali untuk diedit. Emoji premium hanya muncul di Telegram jika bot memenuhi syarat. Tidak ada pilihan “Buka di dalam Telegram”: Bot API tidak memberikan pengaturan tersebut untuk tombol.

Batas setiap saluran

Pilih saluran untuk blok atau tombol tertentu. Jika memilih Semua saluran, editor hanya menawarkan fitur yang tersedia di semuanya. Tipe tombol yang tidak didukung tidak dapat disimpan.

  • Telegram: tautan, Mini App, reaksi, notifikasi atau jendela, baris, warna, dan emoji khusus jika bot memiliki izin.
  • VK: tautan, reaksi, pemberitahuan singkat, baris, dan warna. VK Mini App dan VK Pay hanya tersedia jika Anda memilih koneksi VK yang sesuai.
  • WhatsApp: satu tombol tautan CTA tanpa tombol lain dalam pesan yang sama. Hingga tiga tombol jawaban tampil sebagai tombol biasa; empat sampai sepuluh tampil sebagai daftar. Tulisan tombol paling panjang 20 karakter. Tidak ada baris, warna, Mini App, atau notifikasi.
  • Instagram / Messenger: penghubung saat ini hanya mengirim tombol jawaban cepat, dengan tulisan hingga 20 karakter. Tautan, Mini App, notifikasi, baris, dan warna tidak tersedia.
  • Widget situs web: tautan dan tombol jawaban, tanpa pengaturan baris, warna, atau notifikasi.
  • Email: tautan, termasuk tautan pembayaran; tombol jawaban dan notifikasi tidak tersedia.

Untuk tombol yang dibuat dari daftar, jumlah kolom hanya dapat diatur pada saluran yang mendukung baris. Pada saluran lain, platform menentukan tata letaknya. Batas jumlah tombol dan panjang tulisan diperiksa saat pesan dikirim.

Perilaku saat tombol ditekan

Untuk tombol yang mengirim ketukan ke bot, Anda dapat mengganti isi pesan dengan teks atau isi reaksi lain, menghapus pesan, memberi label, atau menyimpan parameter jika saluran mendukungnya. Mengganti tulisan tombol itu sendiri setelah ditekan hanya tersedia di Telegram, misalnya dari “Daftar” menjadi “Dipilih”. Kemampuan VK untuk mengedit pesan tidak mencakup penggantian tulisan pada tombol.

Telegram menunggu konfirmasi ketukan dari bot melalui answerCallbackQuery. Biasanya GetMyBot mengirimnya otomatis sehingga tanda memuat pada tombol hilang. Lewati answerCallbackQuery mematikan konfirmasi ini.

Pada kolom Text on press (notification) untuk tombol reaksi, Anda dapat menulis konfirmasi seperti “Kelas dipilih”. Telegram menerima hingga 200 karakter dan VK hingga 90 karakter; penggantian nilai juga bekerja. Biasanya teks muncul sebentar di atas obrolan Telegram. Show as a popup (alert) hanya tersedia di Telegram dan memakai answerCallbackQuery dengan show_alert. Jika teks kosong, bot hanya menghilangkan tanda memuat. Jika Lewati answerCallbackQuery aktif, teks dan jendela tidak dikirim.

Data yang dibawa tombol (Carry)

Carry membantu tombol mengingat barang atau pilihan yang dimaksud. Misalnya, mantel dan gaun sama-sama memiliki tombol “Beli”. Simpan product_id=101 pada tombol mantel dan product_id=102 pada tombol gaun. Ketika tombol gaun ditekan, reaksi berikutnya menerima {{ctx.product_id}} dengan nilai 102.

Di editor, pengaturannya bernama Data saat diklik. Kunci adalah nama nilainya; nilainya dapat berupa angka, teks, atau penggantian. Bot menyimpannya saat pesan dikirim, lalu memasukkannya ke data sementara reaksi (ctx) saat tombol ditekan. Setiap tombol memiliki data sendiri.

Masa berlaku (ttl_seconds, TTL) dihitung dalam detik: 3600 berarti satu jam. Nilai 0 memakai masa bawaan 30 hari. Setelah masa itu lewat, data tidak tersedia. Sekali pakai (single_use) menghapus data setelah ketukan pertama. Harga yang tersimpan tidak berubah ketika katalog berubah, jadi periksa harga terbaru berdasarkan ID produk sebelum menerima pembayaran.

Baca Tombol dinamis dan parameter untuk langkah lengkap dan perbedaannya dari parameter pelanggan yang tersimpan.

Tombol dinamis

Jika produk atau kelas sudah ada dalam daftar, Anda tidak perlu menambah tombol satu per satu. Tombol dinamis dari daftar membuat satu tombol untuk setiap item. Pilih daftar dalam ctx, nama untuk satu item, jumlah tombol per baris, dan templat tulisannya. Misalnya, {{item.name}} menampilkan nama produk berikutnya. Baca Tombol dinamis dan parameter.

Emoji premium dalam teks

Pada blok teks, tombol format Emoji premium memasukkan <tg-emoji emoji-id="…">🙂</tg-emoji>. Penerima dengan Telegram Premium akan melihat emoji khusus, sedangkan yang lain melihat emoji biasa di dalam tag. Ini bekerja dalam format HTML dan Markdown. ID emoji berisi hingga 32 angka. Anda dapat memperolehnya melalui getCustomEmojiStickers atau meneruskan pesan berisi emoji tersebut ke bot seperti @idstickerbot.

Tautan bot dan teks siap kirim

Tautan t.me/<bot>?start=<nilai> menjalankan perintah /start <nilai> di Telegram. Tautan ini tidak dapat membuka obrolan dengan nilai tersebut tanpa menjalankan /start. Pilih cara yang sesuai:

  • /start tanpa balasan terlihat: buat reaksi untuk Perintah /start dengan Tag tautan mulai yang cocok, lalu biarkan tindakan Kirim pesan tanpa blok. Pengguna tidak melihat balasan untuk /start, tetapi nilai pada tautan dapat digunakan dalam kondisi dan tindakan reaksi itu.
  • Prefilled text: https://t.me/<bot>?text=<teks> membuka obrolan dan menaruh teks di kolom pesan, tanpa mengirimnya. Perintah /start tidak berjalan; pengguna sendiri yang mengirim pesan.
  • Pesan otomatis atas nama pengguna tidak dapat dibuat melalui Bot API. Bot tidak boleh mengirim pesan seolah-olah berasal dari pengguna. Pilihan terdekat adalah tautan ?start= yang memicu balasan dari bot sendiri.

Blok teks dapat menunggu jawaban pengguna. Pesan itu menjadi langkah percakapan dan menjeda alur sampai pengguna menjawab. Beberapa langkah berurutan dapat membentuk formulir dalam obrolan.

Jenis jawaban yang ditunggu

Bot dapat menunggu teks, pilihan dari beberapa opsi, foto, video, pesan video bulat, audio, dokumen, pesan suara, lokasi, kontak, kalender, atau dadu. Jika pengguna mengirim jenis yang berbeda, langkah tersebut menganggap jawabannya tidak sesuai.

Memeriksa teks jawaban

Untuk jawaban teks, Anda dapat memeriksa format nomor telepon, email, tautan, tanggal, waktu, atau hasil rumus. Misalnya, jika bot menunggu nomor telepon, teks acak akan ditolak dan bot menampilkan pesan kesalahan. Pemeriksaan dengan rumus memakai rumus lanjutan: hasil kosong berarti jawaban diterima, sedangkan teks berisi alasan penolakan.

Menyimpan jawaban

Jawaban dapat disimpan sebagai parameter pelanggan. Setelah itu, nilainya tersedia sebagai {{param.key}} dalam pesan dan kondisi. Dengan cara ini, setiap langkah mengisi profil pelanggan sedikit demi sedikit.

Kesalahan, pengingat, dan batas waktu

  • Pesan jika pemeriksaan gagal: yang dilihat pengguna jika jawabannya tidak sesuai.
  • Pengingat: pesan yang dikirim jika pengguna belum menjawab.
  • Akhiri penantian setelah batas waktu: tentukan berapa lama bot menunggu. Saat waktu habis, bot dapat menjalankan reaksi lain, misalnya untuk mengakhiri formulir dengan sopan. Hubungan ini terlihat di peta reaksi sebagai “Batas waktu menunggu”; reaksi yang menangani jawaban terlihat sebagai “Jawaban yang ditunggu”.

Keluar dari langkah dengan perintah

/cancel atau kata bahasa Rusia “отмена” menghentikan penantian dan mengirim “Отменено.”, atau menjalankan reaksi pembatalan jika sudah diatur. Secara bawaan, perintah lain dianggap sebagai jawaban dan diperiksa seperti teks biasa, sehingga bot tetap menunggu sampai pengguna menjawab. Jika Anda mengaktifkan Perintah bot (misalnya /start) menghentikan penantian (escape_on_command), perintah apa pun seperti /start akan menghentikan penantian tanpa pesan tambahan dan berjalan seperti biasa.

Penggantian nilai

Tombol Substitusi memasukkan data pengirim seperti {{first_name}} dan {{username}}, data peristiwa seperti {{text}} dan {{chat_id}}, atau parameter seperti {{param.key}}. Baca Penggantian nilai dan rumus untuk daftar lengkap.

Tombol menu bot

Tindakan Menu button memilih menu bot biasa, daftar perintah, atau tombol Mini App beserta teks dan URL. Anda dapat menerapkannya pada obrolan saat ini atau sebagai pengaturan umum bot. Misalnya, tampilkan Mini App pribadi hanya untuk pelanggan yang sedang berbicara. Ketersediaannya bergantung pada saluran.

Langkah berikutnya