Kami mengesyorkan agar anda membaca artikel Button.

Anda boleh menggunakan kedua-dua butang balas (butang biasa atau butang papan kekunci) dan butang Inline (butang dalam teks) di Telegram.

Penting: had butang

Sila ambil perhatian tentang had platform berikut semasa mencipta butang:

  • Butang balas (papan kekunci): maksimum 12 butang setiap baris.
  • Butang Inline: Maksimum 8 butang setiap baris.
  • Teks butang: Terhad kepada 32 aksara.
  • Warna butang: tidak boleh disesuaikan. Butang menggunakan gaya platform lalai.

Cara mencipta butang dalam blok

Untuk mencipta sebarang butang dalam chatbot, pergi ke tetapan blok dan klik pada tab "Buttons":

Kemudian tetapan untuk menambah dan mengedit butang akan dibuka. Kemudian klik Add:

Tetingkap tetapan akan dibuka, membolehkan anda menentukan label, tindakan dan pilihan tambahan butang.

Jenis butang berikut hanya tersedia untuk bot Telegram:

  • Butang Kongsi – membolehkan pengguna berkongsi kandungan.
  • Butang Callback – menghantar pertanyaan callback senyap ke bot anda.
  • Telegram WebApp – membuka aplikasi mini (cth., widget atau laman web) dalam Telegram.
  • Log masuk Telegram – membenarkan pengguna melalui akaun Telegram mereka.

Terdapat juga butang lain yang tersedia di Telegram, seperti pembayaran, permintaan nombor telefon atau geolokasi, dan menghantar pautan.

Butang Kongsi

Semasa mencipta butang, pilih "Share (Telegram only)" dan isikan medan (medan teks tambahan pilihan):

Butang ini membolehkan anda memajukan maklumat dengan memilih kenalan daripada senarai anda.

Masukkan URL yang ingin anda kongsi dalam medan "Share link" butang.

Setelah kenalan dipilih, kandungan daripada medan "Share link" dan "Additional text" akan dihantar. Gunakan ini untuk berkongsi pautan ke siaran saluran Telegram dan kandungan lain.

Perhatian! Ia mungkin tidak berfungsi dengan betul pada sesetengah peranti iOS.

Butang log masuk laman web

Untuk butang log masuk berfungsi, bot anda mesti terlebih dahulu dibenarkan untuk domain sasaran. Konfigurasi ini dilakukan melalui @BotFather.

Langkah-langkah untuk mengkonfigurasi:

  1. Buka sembang dengan @BotFather.
  2. Pilih bot anda daripada senarai.
  3. Pilih Bot Settings > Domain dan tambah domain laman web anda.

Seterusnya, pergi ke butang Domain:

Nota: Butang akan membaca Edit domain jika domain wujud, atau Set domain jika perlu ditambah.

Anda akan diminta untuk menyediakan domain untuk bot anda:

Format domain yang betul:

Masukkan domain anda sebagai mavibot.ai atau sebagai yourdomain.com jika anda mempunyai laman web yang disambungkan ke MaviBot.

Langkah seterusnya:

Setelah domain anda disahkan dan dikonfigurasikan, anda boleh meneruskan untuk mencipta butang kebenaran.

Dalam medan Text, masukkan label yang akan muncul pada butang.

Kemudian, berikan URL halaman dalam medan Link di mana kebenaran akan berlaku.

Medan yang selebihnya akan diperlukan jika bot berasingan digunakan untuk kebenaran (anda perlu mendapatkan kebenaran untuk menghantar mesej untuk bot ini): khususnya, anda perlu menentukan nama bot.

Jika anda perlu dapat menghantar mesej daripada bot yang ditentukan, maka pastikan anda menandai kotak untuk "Request permission from the user to send messages from the bot":

Butang log masuk Telegram

Butang Callback

Butang Callback ialah butang maklum balas apabila pelanggan melihat satu perkara, dan dalam bot kami mendapat callback yang kami perlukan untuk melancarkan mana-mana blok corong.

Ia agak mudah untuk menciptanya: dalam medan Buttons, klik butang Add. Dalam borang yang terbuka, masukkan teks, nyatakan jenis - Callback button (Telegram) dan masukkan Callback text yang harus dikembalikan apabila anda mengklik pada butang:

Secara visual, butang itu kelihatan seperti butang inline biasa:

Selepas mengklik pada butang, anda akan melihat Callback yang dikonfigurasikan dalam kad pelanggan:

Ia penting!

Telegram tidak menyokong butang papan kekunci Callback.

Sila ambil perhatian!

Jika jenis butang "Callback" dipilih, butang akan dipaparkan sebagai callback hanya jika teks butang berbeza daripada teks callback.

Butang Aplikasi Web Telegram

Butang ini membolehkan anda membuka laman web sebagai aplikasi web dalam Telegram.

Semasa menambah butang, nyatakan labelnya, pilih jenis butang Telegram Web App, dan berikan pautan ke laman web yang akan dibuka sebagai aplikasi web:

  • Anda boleh menentukan pautan melalui pembolehubah:

Menggunakan pembolehubah untuk pautan sangat praktikal apabila halaman sasaran atau alamat laman web kerap berubah.

Bagaimana ia berfungsi:

  1. Tentukan pembolehubah (cth., landing_page_url) dalam tetapan projek anda.
  2. Rujuk pembolehubah ini (cth., #{landing_page_url}) dalam semua butang Web App di seluruh aliran anda.

Faedah: daripada mengemas kini URL secara manual dalam setiap blok butang individu, anda hanya perlu menukar nilai pembolehubah sekali dalam tetapan projek, dan semua butang akan dikemas kini secara automatik.

Alternatif: anda, sudah tentu, masih boleh menentukan URL statik terus dalam tetapan butang.

Cara mencipta butang untuk fungsi API Telegram

Walaupun bekerja secara langsung dengan API Bot Telegram boleh menjadi mencabar, terutamanya untuk pemula, MaviBot menawarkan alternatif yang lebih mudah diakses.

Kaedah: gunakan kod yang dijana

Anda boleh menggunakan kod butang pra-jana daripada tetapan lanjutan, menghapuskan keperluan untuk menulis panggilan API secara manual.

Langkah-langkah:

  1. Navigasi ke tetapan blok anda dan buka bahagian Buttons.
  2. Gunakan antara muka untuk menambah dan mengkonfigurasi semua butang yang diperlukan (teks, pautan, fungsi).
  3. Sistem akan menjana kod API Telegram yang betul secara automatik di latar belakang.

Pendekatan ini membolehkan anda mencipta papan kekunci yang kompleks secara visual sementara platform mengendalikan pelaksanaan teknikal yang mendasari.

Klik "Advanced Settings" untuk melihat kod API Telegram yang dijana untuk butang anda.

Uji butang anda, kemudian salin kod yang dijana daripada Advanced Settings ke dalam pembolehubah seperti buttons.

Fungsi ini menghantar mesej melalui API Telegram dengan parameter berikut: tg_send_message (platform_id, text,client_message_id, reply_markup, sparse_mode, disable_web_page_preview, protect_content, disable_notification, message_thread_id, entities):

Luluskan pembolehubah butang ke fungsi dalam parameter reply_markup:

Butang anda akan muncul dalam sembang dengan susun atur dan gaya yang anda tetapkan.

Cara memadam butang balas

Walaupun butang papan kekunci biasanya hilang secara automatik, ia kadangkala boleh kekal kelihatan.

Untuk mengosongkan butang balas yang berlarutan secara paksa, masukkan kod berikut ke dalam medan Advanced Settings:

[{"buttons":[],"one_time":true,"index_in_line":0,"line":0}]

Konfigurasi butang kosong ini mengarahkan Telegram untuk menyembunyikan papan kekunci tersuai.

Butang menu papan kekunci di Telegram

Kami mengesyorkan menggunakan ciri ini hanya untuk pengguna lanjutan!

Butang papan kekunci

Untuk dapat menggunakan butang papan kekunci (balas) sebagai menu Telegram kekal, cukuplah dengan memberikan sebarang nilai kepada pembolehubah tg_permanent_reply_buttons (pembolehubah diisytiharkan sebagai pemalar projek).

Pembolehubah: tg_permanent_reply_buttons

Menetapkan pembolehubah tg_permanent_reply_buttons memberikan anda kawalan manual sepenuhnya ke atas keterlihatan papan kekunci balas (butang di bawah mesej). Semua tingkah laku penyembunyian automatik oleh platform dilumpuhkan.

Skop: tetapan ini digunakan untuk semua butang balas yang dibuat dalam bot semasa pembolehubah aktif.

Kembali kepada tingkah laku automatik

Untuk memulihkan penyembunyian papan kekunci automatik standard:

  1. Alih keluar pembolehubah tg_permanent_reply_buttons daripada tetapan projek anda.
  2. Cipta semula sebarang butang balas yang asalnya dibuat semasa pembolehubah aktif. Butang yang dibuat di bawah peraturan "kekal" mengekalkan keadaan itu dan mesti dicipta semula untuk mewarisi tingkah laku automatik baharu.

Cara mencipta menu di Telegram

Orang yang mencipta bot Telegram boleh membuat menu sedemikian.

Untuk melakukan ini, tulis kepada Botfather di Telegram.

Masukkan arahan /mybots, dan senarai bot anda dibuka. Pilih yang anda perlukan. Menu dibuka untuk anda. Di sini anda perlu memilih Edit Bot, dan kemudian Edit Commands.

Masukkan semua arahan dan penerangannya dalam satu mesej, menggunakan huruf kecil untuk nama arahan. Anda akan menerima pengesahan apabila senarai dikemas kini.

Anda kini boleh melihat dan menggunakan menu dalam sembang Telegram anda dengan bot.

Apabila anda mengklik pada butang menu, senarai arahan yang sebelum ini didaftarkan dalam BotFather akan dibuka:

Seterusnya, pergi ke Mavibot, buka projek yang disambungkan dengan bot telegram ini.

Cipta blok Start atau Trigger, tulis arahan dalam syarat, dan dalam medan "Message text" — teks yang akan diterima sebagai balasan.

Contoh:

Cara menggabungkan dua jenis butang

Cipta blok dengan butang balas (papan kekunci), yang perlu anda visualisasikan.

Cipta blok seterusnya (pemasa 0 saat) dengan butang inline (butang dalam teks), yang mesti diletakkan tanpa mengalih keluar butang balas. Contohnya: [{"type": "inline", "text": "BUTTON NAME", "line": 0, "index_in_line": 0}]

Inilah hasilnya:

Penting: anda mesti mengikut susunan ini semasa menambah butang dalam blok yang sama:

  1. Pertama, tambah semua butang Balas (papan kekunci).
  2. Kemudian, tambah sebarang butang Inline.

Jika urutan ini diterbalikkan, butang balas akan dialih keluar apabila blok mesej seterusnya dihantar.