Cara Membuat Bot Telegram dengan BotFather dan Menambahkan AI

Piotr Grudzień
Diterbitkan Waktu baca 17 menit
Membuat bot Telegram dengan BotFather dan Quickchat AI, di samping percakapan Fernway asli berisi jawaban kursus, lampiran PDF, dan balasan staf

Untuk membuat bot Telegram, buka BotFather, kirim /newbot, pilih nama dan nama pengguna, lalu salin token bot ke layanan yang akan menjalankannya. Dalam tutorial ini, layanan tersebut adalah Quickchat AI, yang menyediakan AI Agent untuk menjawab berdasarkan pengetahuan Anda sendiri tanpa menulis kode atau menjalankan server.

Anda akan membangun Fernway Languages, sekolah bahasa Inggris daring fiktif. Siswa dapat membuka bot Telegram-nya, memeriksa harga kursus, mengetuk /schedule, meminta panduan kursus PDF, dan meminta bantuan staf. Seluruh pengalaman berlangsung di percakapan Telegram siswa; tim Anda mengelola pengetahuan, Actions, dan percakapan di Quickchat AI.

Fernway Languages di Telegram menjawab pertanyaan harga dan jadwal kursus, lalu mengirim panduan kursus PDF yang diminta

Bot yang sudah selesai di Telegram. Jawaban kursus berasal dari pengetahuannya, dan brosur diterima sebagai lampiran PDF sungguhan.

Pengaturan inti dimulai dari membuat bot hingga menguji jawabannya. Kemudian tambahkan pengiriman PDF dan pengalihan ke staf. Bagian percakapan grup menjelaskan cara menjaga perilaku balasan tetap dapat diperkirakan dalam percakapan bersama.

Unduh kit pengaturan Fernway untuk mendapatkan pengetahuan, Main Prompt, daftar perintah, lembar pengujian, avatar, dan contoh PDF. File ini merupakan contoh yang dapat diedit dan ditempelkan ke dasbor, bukan impor Agent otomatis.

Tangkapan layar, label antarmuka, dan materi demo yang dapat disalin tetap dalam bahasa Inggris agar Anda dapat mereproduksi contoh yang ditampilkan.

Apa yang diperlukan untuk membuat bot Telegram tanpa kode?

Anda memerlukan akun Telegram, akun Quickchat AI, dan bot baru untuk latihan. BotFather membuat identitas Telegram; Quickchat AI menjalankan Agent di belakangnya.

  1. Masuk ke Telegram di ponsel atau desktop. Gunakan BotFather resmi yang ditautkan di Langkah 1, bukan akun bernama mirip.
  2. Buat akun Quickchat AI dan selesaikan verifikasi email jika diminta. Paket Free mendukung pembelajaran pribadi nonkomersial dengan kuota yang disertakan. Gunakan paket komersial untuk penerapan bisnis nyata. Balasan AI dan Simulation Testing menggunakan kredit; lihat paket dan kuota saat ini.
  3. Biarkan kedua aplikasi terbuka. Gunakan bot uji baru agar latihan tidak mengubah saluran dukungan yang sudah ada. Akun Telegram kedua berguna untuk memeriksa pengalaman pengunjung pertama kali.

Telegram tidak mengenakan biaya pendaftaran bot. Layanan yang menghasilkan jawaban AI memiliki kuota penggunaan sendiri. Pengaturan ini tidak memerlukan kunci API model terpisah.

Apa peran BotFather dan AI?

BotFather mengelola identitas dan pengaturan bot. Agent yang terhubung menentukan cara menjawab berdasarkan pengetahuan dan instruksinya. Membuat bot saja tidak memberinya informasi kursus atau program yang menanggapi pesan.

Diagram yang memisahkan pengaturan identitas BotFather dari pesan Telegram dan jawaban Quickchat AI Telegram mengirim pesan siswa ke layanan yang terhubung. Balasan Agent kembali ke percakapan yang sama.

KomponenYang Anda aturYang dilihat siswa
BotFatherNama, nama pengguna, foto profil, deskripsi, menu perintah, dan mode privasiIdentitas bot dan cara memulai interaksi
Quickchat AIKnowledge Base, Main Prompt, pesan sambutan, dan ActionsJawaban kursus, PDF yang diminta, dan pengalihan ke staf
Tim AndaInformasi kursus yang akurat dan Inbox yang dipantauBalasan manusia saat percakapan membutuhkannya

Langkah 1: Bagaimana cara membuat bot Telegram di BotFather?

Kirim /newbot ke BotFather resmi, lalu berikan nama tampilan dan nama pengguna yang unik.

  1. Buka @BotFather di Telegram dan pilih Start.
  2. Kirim /newbot.
  3. Saat diminta nama, kirim Fernway Languages. Inilah nama tampilan yang dilihat siswa.
  4. Saat diminta nama pengguna, pilih nama seperti fernway_lessons_yourname_bot. Ganti yourname dengan akhiran unik. Gunakan 5 hingga 32 huruf Latin, angka, atau garis bawah; nama pengguna tidak membedakan huruf besar dan kecil. Untuk pengaturan gratis standar ini, gunakan nama yang berakhiran bot. Jika nama sudah dipakai, coba akhiran lain. BotFather juga menawarkan akhiran lain bagi akun Premium yang memenuhi syarat.
  5. BotFather memberikan tautan bot dan token autentikasinya. Simpan tautan untuk membuka percakapan yang akan digunakan siswa. Jaga kerahasiaan token untuk Langkah 4.

Antarmuka perintah sudah cukup untuk tutorial ini. BotFather mungkin juga menawarkan Mini App untuk mengelola bot; gunakan perintah di bawah jika tampilan Anda berbeda.

Percakapan BotFather terverifikasi yang menunjukkan perintah newbot, nama Fernway Languages, dan konfirmasi pembuatan, dengan nama pengguna serta kredensial disamarkan

BotFather membuat identitas dan memberikan tautan serta kredensialnya. Nama pengguna pengujian dan seluruh kredensial disamarkan.

Di mana Anda menemukan token bot Telegram?

Kirim /mybots ke BotFather, pilih bot Anda, lalu buka API Token. Token mengautentikasi permintaan atas nama bot tersebut. Tempelkan hanya ke kolom kredensial khusus layanan, bukan ke prompt Agent, pengetahuan, percakapan dukungan, atau tangkapan layar.

Jika token terekspos, kirim /revoke ke BotFather, pilih bot, dan dapatkan penggantinya. Perbarui layanan yang terhubung dengan token baru dan uji balasan. Kredensial lama berhenti berfungsi; mengganti nama bot atau menghapus tangkapan layar tidak membatalkannya.

Webhook memiliki satu tujuan. Menghubungkan bot yang sama ke layanan lain dapat mengganti webhook yang mengirim pesan masuk ke Quickchat AI. Layanan terpisah dapat melakukan panggilan API keluar dengan token yang sama, tetapi masing-masing tidak otomatis menerima salinan pembaruan masuk. Telegram juga melarang polling dengan getUpdates saat webhook terpasang. Gunakan bot terpisah untuk alur pesan masuk terpisah. Dokumentasi pengiriman pembaruan Telegram menjelaskan kedua mekanisme tersebut.

Langkah 2: Bagaimana cara menambahkan gambar, deskripsi, dan menu perintah?

Gunakan perintah profil BotFather agar bot mudah dikenali sebelum siswa mengirim pesan pertama. Setelah setiap perintah, pilih bot Anda dan kirim nilai di bawah.

Kirim ke BotFatherLalu berikanTempat muncul
/setnameFernway LanguagesNama tampilan di Telegram
/setuserpicUnggah fernway-avatar.png dari kitFoto profil
/setdescriptionDeskripsi di bawahPengantar sebelum percakapan dimulai
/setabouttextTeks profil singkat di bawahProfil bot dan pratinjau tautan yang dibagikan
/setcommandsDaftar perintah di bawahMenu yang diketuk siswa dalam percakapan

Description (maksimal 512 karakter):

Ask Fernway Languages about English courses, prices and weekly class times. Request the course guide or ask to speak to the team. This is a fictional school built for a tutorial.

About text (maksimal 120 karakter):

English courses, prices and class times. A fictional school for a Quickchat AI tutorial.

Daftar perintah: tempelkan keempat baris ini sekaligus. Nama perintah tidak diawali garis miring dalam daftar BotFather ini.

prices - Course prices
schedule - Weekly class times
trial - Request a free trial lesson
help - Talk to a person

Buka profil bot untuk memeriksa nama, gambar, dan teks profilnya. Buka percakapan sebelum memilih Start untuk memeriksa pengantar. Telegram menjelaskan setiap pengaturan dalam panduan BotFather.

Setelah menghubungkan bot di Langkah 4 dan memilih Start, buka menu perintah dan periksa keempat entri. Pertahankan pergantian baris saat menempelkan daftar ke BotFather; jika tidak, beberapa entri bisa menjadi satu deskripsi perintah panjang.

Menu perintah Telegram Fernway Languages menampilkan prices, schedule, trial, dan help di bawah pesan sambutan yang dikonfigurasi

Menu yang selesai memiliki empat entri terpisah. Sambutan di atasnya dikonfigurasi di Quickchat AI pada Langkah 3.

Diagram alur perintah yang menunjukkan BotFather menambahkan item menu, Telegram mengirim teks perintah, dan Main Prompt menentukan maknanya Menambahkan /schedule ke menu tidak mengimplementasikan pencarian jadwal. Langkah berikutnya memberi tahu Agent arti pesan itu.

Langkah 3: Bagaimana membuat bot Telegram menjawab dari pengetahuan Anda?

Buat Agent, tambahkan fakta sekolah ke Knowledge Base, lalu masukkan aturan jawaban ke Main Prompt. Memisahkan fakta dari instruksi memudahkan perubahan harga tanpa mengubah perilaku bot.

Pilih tangkapan layar untuk membukanya dalam ukuran penuh. Gunakan blok yang dapat disalin untuk teks dan nilai permintaan yang persis.

Tambahkan informasi kursus

  1. Di Quickchat AI, buat Agent baru bernama Fernway Languages. Di Identity, atur namanya ke nilai yang sama.
  2. Buka Knowledge Base, pilih Add Article, dan gunakan Fernway Languages course guide sebagai Title.
  3. Tempelkan teks berikut ke Content, lalu pilih Save. Tunggu pemrosesan selesai dan artikel menampilkan Ready. Selesaikan langkah penerbitan/penerapan yang ditampilkan sebelum menguji saluran langsung.

Editor artikel pengetahuan Fernway yang menampilkan judul, harga kursus, dan jadwal kelas mingguan Tambahkan fakta di Knowledge Base. Artikel lengkap yang dapat disalin di bawah juga mencakup kebijakan kelas percobaan, pengembalian dana, dan penempatan tingkat.

Salin artikel pengetahuan Fernway
Fernway Languages is a fictional online English school used for this tutorial.

Courses
B1 English: EUR120 total for a four-week course. Classes are on Tuesdays and Thursdays, 18:00 to 19:00 UTC.
A2 English: EUR90 total for a four-week course. Classes are on Mondays and Wednesdays, 18:00 to 19:00 UTC.
Both courses meet online. Prices are for the complete four-week course, not per lesson.

Trial lessons
A free trial lesson lasts 20 minutes. Ask the student which course interests them and which day and time they prefer, including their time zone. A member of the Fernway team must confirm availability. The bot cannot book or confirm a trial lesson.

Refunds
Students can receive a full refund if they cancel at least 48 hours before their first class. The team reviews requests made later; no refund is promised for those requests.

Course brochure
The course guide contains the same course prices, weekly schedule, trial policy and refund policy. Send it only when the student asks for the brochure or course guide.

Placement
The team handles level placement. This knowledge base does not contain a placement-test score cutoff or rules that convert a test score into a course level. Do not invent a cutoff or interpret a student's score.

Tidak adanya ambang nilai penempatan memberi Anda pengujian yang bermakna. Agent dapat menjawab harga B1 dari sumber, tetapi tidak boleh mengarang nilai yang dibutuhkan siswa untuk bergabung.

Tentukan makna perintah

Buka Identity, pilih kartu Main Prompt bertanda Edit, lalu tempelkan seluruh prompt di bawah. Biarkan tersimpan otomatis, kemudian buka kembali untuk memeriksa teks yang tersimpan.

Halaman Identity Fernway Languages yang menampilkan Name dan kartu Main Prompt yang dapat diedit Buka Main Prompt dari Identity. Aturannya menentukan makna perintah Telegram.

Salin Main Prompt lengkap
You are the Fernway Languages assistant. Help prospective students understand the English courses using the Knowledge Base.

Answer the student's question directly. Use plain text, short paragraphs and no Markdown tables. Keep routine answers under 100 words. State prices in EUR and class times in UTC unless the student explicitly asks for a conversion.

Treat /prices as a request for the course prices. Treat /schedule as a request for the weekly class times. Treat /trial as a request for a free trial lesson: explain that it lasts 20 minutes, ask for the preferred course, day, time and time zone, and make clear that the team must confirm availability. Treat /help as a request to speak to a person. These commands may include a bot username after an @ sign; apply the same rule to /prices@username, /schedule@username, /trial@username and /help@username.

Call send_course_brochure only when the student explicitly asks to receive the brochure or course guide. Do not call it for a price or schedule question alone. Do not ask for a chat ID, token or email address to send it. Say that the brochure was sent only after the action succeeds. If it fails, say that the file could not be sent and offer to explain the courses in the chat.

Use only the Knowledge Base for course facts and policies. If a requested fact is missing, say that the team will need to confirm it. Never invent placement-test cutoffs, available trial slots, bookings, refunds or course discounts.

If the student asks for a person, use Human Handoff. Do not promise an immediate response or pretend a staff member has already replied.

Prompt ini mencakup langkah brosur dan pengalihan opsional yang akan dikonfigurasi nanti. Selesaikan langkah tersebut sebelum membagikan bot sebagai layanan dukungan siswa yang lengkap. Prompt dapat meminta Action, tetapi tidak membuat Action tersebut atau menghubungkan Telegram.

Bentuk perintah yang ditujukan ke bot, seperti /schedule@your_bot, penting saat bot bergabung ke grup. Instruksi teks biasa juga penting: balasan biasa melalui integrasi ini dikirim tanpa format Markdown Telegram.

Atur pesan sambutan

Buka Your Website, pilih tab Text Content, dan edit Welcome message. Sambutan bersama ini juga digunakan oleh koneksi bot Telegram milik sendiri:

Welcome to Fernway Languages. I can help with our English courses, prices and class times. Try /prices, /schedule or /trial, or ask a question. Use /help to ask for a person.

Kolom Welcome message berisi sambutan Fernway dan saran perintah Kolom Welcome message bersama berada di Your Website → Text Content; Telegram menggunakannya untuk /start.

Integrasi bot milik sendiri mengirim sambutan yang dikonfigurasi ini saat pengunjung mengirim /start. Sambutan tersebut terpisah dari deskripsi prapercakapan BotFather dan jawaban AI terhadap pertanyaan kursus.

Langkah 4: Bagaimana menghubungkan token ke Quickchat AI?

Hubungkan melalui Your own bot untuk menggunakan identitas Telegram yang baru Anda buat.

  1. Buka External Apps, pilih Telegram, lalu Your own bot.
  2. Pilih Connect to Telegram, tempelkan token BotFather ke Bot Token, lalu pilih Connect to Telegram di dalam dialog untuk mengirimkannya.
  3. Aktifkan Enable your own bot, lalu pilih Save.
  4. Buka tautan t.me bot di Telegram. Pilih Start atau kirim /start untuk memeriksa sambutan.

Pengaturan Telegram Quickchat AI menunjukkan bot Fernway yang terhubung di Your own bot dengan Enable your own bot aktif Panel koneksi langsung menunjukkan identitas bot dan status aktifnya. Gunakan Your own bot untuk identitas yang dibuat di BotFather.

Dialog Connect to Telegram di Quickchat AI dengan kolom Bot Token kosong Masukkan kredensial di kolom ini. Tangkapan layar sengaja tidak memuat token.

Opsi Quickchat AI bot bersama di dasbor merupakan pengaturan berbeda. Opsi ini menyediakan tautan percakapan khusus Agent tanpa membuat bot sendiri; panduan utama menggunakan identitas dan kredensial Anda sendiri. Panduan chatbot AI Telegram membahas jalur bersama tersebut.

Jika dialog koneksi menjelaskan penonaktifan mode privasi untuk grup, tetap aktifkan privasi untuk alur perintah beralamat dalam tutorial ini. Percakapan pribadi bekerja terlepas dari pengaturan privasi grup. Bagian grup menjelaskan konsekuensinya.

Langkah 5: Bagaimana menguji bot Telegram Anda?

Periksa jawaban Agent sekaligus pesan yang diterima di Telegram. Pengujian dasbor memverifikasi logika jawaban; hanya percakapan Telegram yang memverifikasi keseluruhan saluran.

Uji jawaban di Quickchat AI

Buka Testing, pilih Create Dataset, beri nama Fernway course answers, dan tambahkan pesan berikut sebagai baris terpisah:

How much is the B1 English course?
/prices
/schedule
/schedule@fernway_demo_bot
/trial
I scored 62 on your placement test. Do I qualify for B1?

Baris perintah beralamat memakai contoh nama pengguna untuk memeriksa aturan prompt. Untuk pengujian langsung di Telegram, gunakan nama pengguna bot Anda yang sebenarnya.

Di Evaluation criteria, gunakan:

Fernway Languages is a fictional English school. B1 costs EUR120 total for four weeks and meets Tuesdays and Thursdays, 18:00 to 19:00 UTC. A2 costs EUR90 total for four weeks and meets Mondays and Wednesdays, 18:00 to 19:00 UTC. A free trial lasts 20 minutes and requires team confirmation; no booking may be claimed. Commands must be treated as requests for the corresponding information. No placement-score cutoff is known, so the Agent must not decide a level from a score. Replies should be brief, plain text and based on these facts. Evaluate reply content only. This test cannot verify Telegram delivery, a received PDF or human assignment.

Pilih Run dengan kredit AI yang tersedia. Setiap baris memulai percakapan terpisah. Gunakan satu percakapan AI Preview berkelanjutan untuk menguji pertanyaan lanjutan, bukan menganggap baris dataset berikutnya sebagai giliran berikutnya.

Enam pengujian Simulation Fernway yang selesai, menampilkan jawaban harga dan perintah serta hasil pertanyaan penempatan tingkat Hasil Simulation lokal yang nyata. Jawaban penempatan mendapat skor lebih rendah karena evaluator tidak dapat mengamati pengalihannya; Inbox mengonfirmasi perubahan penugasan yang sebenarnya.

Uji pengalaman siswa di Telegram

Kirim pesan berikut dalam percakapan pribadi bot asli, dan tunggu setiap balasannya. Gunakan Inbox untuk menemukan pertanyaan dan jawaban terkait.

Simpan pertanyaan nilai tes penempatan untuk terakhir, setelah Langkah 6 dan 7. Pertanyaan ini dapat mengalihkan percakapan ke staf dan menghentikan sementara balasan otomatis.

Pesan atau tindakanHasil yang memenuhi syarat
/startPesan sambutan yang dikonfigurasi muncul
How much is the B1 English course?EUR120 untuk keseluruhan kursus empat minggu
Ketuk /schedule di menuKedua jadwal mingguan, dengan penanda UTC yang jelas
Ketuk /trialPermintaan kelas percobaan 20 menit, dengan ketersediaan ditentukan tim
I scored 62 on your placement test. Do I qualify for B1?Tidak mengarang ambang nilai atau keputusan kelayakan; tim harus mengonfirmasi

Fernway Languages di Telegram menolak menentukan kelayakan B1 berdasarkan nilai tes penempatan 62

Balasan langsung menyerahkan keputusan penempatan kepada tim. Brosur dan balasan staf sebelumnya tetap terlihat dalam percakapan yang sama.

Quickchat AI Inbox menampilkan pertanyaan penempatan Telegram yang sama, jawaban Agent, dan percakapan Unassigned Tampilan Inbox yang sesuai menunjukkan jawaban sekaligus status Unassigned percakapan.

Dalam pengujian langsung, Agent tidak menyimpulkan tingkat dari nilai. Setelahnya, Inbox menunjukkan percakapan sebagai Unassigned, dengan pengalihan Lack Of Knowledge aktif. Periksa jawaban dan penugasan secara terpisah; evaluator jawaban tidak dapat memastikan siapa yang menangani percakapan. Jalankan pemeriksaan penempatan ini setelah pengujian percakapan lain, atau pilih AI Agent di menu penerima tugas Inbox sebelum melanjutkan balasan otomatis.

Jika jawaban salah, periksa artikel pengetahuan terkait dan prompt yang tersimpan, ubah satu hal, lalu ulangi pesan yang sama dalam percakapan baru. Untuk kegagalan perintah, periksa aturan perintah persisnya; untuk harga kursus yang salah, periksa pengambilan dan penerbitan pengetahuan. Catat jawaban yang sebenarnya, bukan menganggap pengaturan lolos hanya karena koneksi berwarna hijau.

Dataset enam pesan ini adalah titik awal. Panduan pengujian agent dukungan AI menjelaskan cara memperluasnya dengan kasus kegagalan realistis dan rubrik penilaian sebelum peluncuran.

Langkah 6: Bagaimana membuat bot mengirim PDF?

Tambahkan satu API Action yang mengirim panduan kursus tetap ke percakapan Telegram saat ini. Agent menentukan apakah siswa memintanya; integrasi menyediakan kredensial dan tujuan.

Diagram tiga sumber tetap untuk Action dokumen: System Token, metadata saluran percakapan saat ini, dan URL PDF publik Siswa tidak memberikan token atau ID percakapan. Action tidak memiliki parameter yang diisi model.

Unduh fernway-course-guide.pdf dari kit untuk memeriksa contoh. Resep ini menggunakan URL publiknya di situs ini. Untuk file Anda sendiri, gunakan URL HTTPS langsung yang dapat diambil Telegram tanpa masuk, dan mengembalikan PDF dengan jenis konten yang benar. Ukuran dokumen yang diambil melalui URL harus di bawah 20 MB. Telegram membedakan pengambilan URL dari unggahan file dalam dokumentasi pengiriman file.

Buka Actions & MCPs, pilih Add Action, pilih pembuat API Action, lalu atur kolom berikut. Jika pembuat menawarkan draf otomatis, periksa permintaan sebenarnya terhadap resep sebelum mengaktifkannya.

Editor API Action dengan POST sendDocument, referensi System Token Telegram, dan metadata percakapan saat ini dalam isi JSON Chip token ditempatkan di URL; chip metadata percakapan di Body. URL PDF tetap.

API Action Name

send_course_brochure

What to ask the user first

FormatNameDescriptionRequired
Tanpa parameterTidak adaBiarkan bagian ini kosong. Semua nilai permintaan berasal dari koneksi atau resep tetap.Tidak berlaku

API Endpoint: method and URL

Pilih POST dan masukkan:

https://api.telegram.org/bot{{telegram_bot_token}}/sendDocument

Gunakan Add AI Data untuk memasukkan telegram_bot_token dari System Tokens. Ini adalah referensi ke kredensial bot yang terhubung, bukan tempat menempelkan token itu sendiri.

Headers

KunciNilai
Content-Typeapplication/json

Body: tempelkan ke tab Body di API Endpoint.

{
  "chat_id": "{{metadata_telegram_chat_id}}",
  "document": "https://quickchat.ai/blog-assets/tutorials/create-telegram-bot/fernway-course-guide.pdf",
  "caption": "Fernway Languages course guide (fictional tutorial example)"
}

Masukkan telegram_chat_id dari metadata percakapan melalui Add AI Data. Bentuk templatnya adalah {{metadata_telegram_chat_id}}. Saluran Telegram mengaturnya dari percakapan masuk, sehingga PDF kembali ke percakapan tersebut. Biarkan URL dokumen dan keterangan tetap.

API Action Description

Send the Fernway Languages course guide PDF to the current Telegram chat when the student explicitly asks to receive the brochure or course guide. Do not call this action for a price, schedule or trial question alone. No information needs to be collected from the student: the current chat and bot credentials are supplied automatically. Call it once per explicit request. Confirm delivery only if the request succeeds.

Simpan dan aktifkan Action. Main Prompt lengkap sudah berisi aturan permintaan eksplisitnya. Metode Bot API didokumentasikan di sendDocument.

Verifikasi file, bukan hanya balasannya

  1. Di Telegram, kirim How much is the B1 English course?. Pastikan Anda menerima harga tanpa file yang tidak diminta.
  2. Kirim Can you send me the brochure?.
  3. Pastikan lampiran PDF diterima dan dapat dibuka sebagai panduan kursus Fernway.
  4. Di Inbox, buka percakapan itu dan perluas kartu Action yang dipanggil. Pada kartu Action di Actions & MCPs, buka View logs untuk memeriksa permintaan dan hasilnya. Token harus disamarkan sebelum membagikan tangkapan layar.
  5. Pastikan tujuannya adalah percakapan saat ini dan satu dokumen dikirim untuk permintaan tersebut.

Dalam pengujian langsung, send_course_brochure mengembalikan HTTP 200 dengan respons Telegram ok: true. Tangkapan layar pembuka menampilkan lampiran fernway-course-guide.pdf yang diterima di percakapan siswa. Hasil permintaan dan file yang diterima bersama-sama memverifikasi pengiriman; teks konfirmasi Agent saja tidak cukup.

Jalankan pengujian pengiriman di Telegram. Percakapan Simulation tidak memiliki konteks token bot Telegram asli. Gunakan Simulation untuk memeriksa jawaban dan percakapan Telegram sebenarnya untuk memeriksa pengiriman file.

Langkah 7: Bagaimana mengalihkan percakapan Telegram ke staf?

Aktifkan Human Handoff agar permintaan berbicara dengan seseorang mengubah penanggung jawab percakapan, lalu minta anggota tim membalas dari Inbox.

  1. Buka Actions & MCPs, aktifkan Human Handoff, dan pilih Edit Action.
  2. Pertahankan Handoff Rules bawaan: Media Message, User Frustration, Customer Support Suggestion, dan Lack Of Knowledge aktif, sedangkan Irrelevant Advice nonaktif. Main Prompt sudah memetakan /help ke permintaan berbicara dengan seseorang; demo ini tidak menambahkan aturan pengalihan khusus.
  3. Untuk latihan yang diawasi, biarkan Human Agents’ availability nonaktif dan minta anggota tim memantau Inbox selama pengujian. Biarkan Email notifications nonaktif. Inilah pengaturan yang dipakai dalam demo; pengalihan tanpa pembatasan tidak berarti seseorang selalu tersedia.
  4. Sebelum peluncuran, aktifkan jadwal ketersediaan dan atur zona waktu serta jam kerja sesuai waktu tim benar-benar bertugas. Sesuaikan pesan di luar jam kerja.
  5. Simpan Action. Dalam percakapan pribadi bot, kirim I want to talk to a person. Jika bot meminta konfirmasi, jawab Yes.
  6. Di Inbox, pastikan percakapan tidak lagi ditugaskan ke AI. Pilih Assign to me dan kirim Hi, this is Alex from Fernway. Which course would you like help with?. Pastikan pesan diterima di Telegram.
  7. Kirim satu pesan siswa lagi saat staf menangani percakapan. Pastikan AI tetap diam. Buka menu penerima tugas dan pilih AI Agent, lalu kirim pertanyaan kursus baru untuk memastikan balasan otomatis kembali berjalan.

Percakapan Telegram langsung di Quickchat AI Inbox dengan permintaan berbicara dengan staf, status Unassigned, dan tombol Assign to me Permintaan tersebut membuat percakapan langsung berstatus Unassigned, siap diambil anggota tim melalui Assign to me. Balasan brosur sebelumnya juga memiliki penanda panggilan Action yang diciutkan.

Siklus pengalihan ke staf, dari jawaban kursus AI, penghentian sementara otomatisasi, balasan staf dari Inbox, hingga penugasan ulang Siswa tetap di Telegram. Pengalihan yang berhasil memerlukan perubahan penugasan dan balasan manusia yang diterima. Pilih AI Agent di menu penerima tugas saat otomatisasi perlu dilanjutkan.

Percakapan Telegram Fernway menampilkan permintaan berbicara dengan staf, konfirmasi pengalihan, balasan operator Alex, dan pesan lanjutan siswa

Balasan operator dari Inbox diterima di percakapan Telegram yang sama. Siswa dapat melanjutkan tanpa berpindah aplikasi.

Quickchat AI Inbox menampilkan balasan operator, pesan lanjutan siswa, dan percakapan yang ditugaskan kembali ke AI Agent Setelah giliran operator, penugasan dikembalikan ke AI Agent. Pertanyaan penempatan berikutnya mendapat jawaban AI yang ditampilkan di Langkah 5.

Fakta yang tidak tersedia dapat memicu pengalihan, seperti pada pengujian penempatan lokal. Periksa kedua hasil secara terpisah: jawaban tidak boleh menebak, dan setiap klaim pengalihan harus mengubah penerima tugas di Inbox. Panduan Human Handoff menjelaskan ketersediaan dan perutean lebih lanjut.

Panduan pengalihan chatbot ke staf menambahkan pengujian permintaan di luar jam kerja dan memastikan balasan otomatis tetap berfungsi setelah penugasan ulang.

Bagaimana perilaku bot dalam grup Telegram?

Mode privasi menentukan pesan grup mana yang dikirim Telegram ke bot. Koneksi bot milik sendiri di Quickchat AI memproses pesan yang diterimanya; koneksi ini tidak menambahkan filter terpisah untuk hanya menjawab sebutan.

Bagan pengiriman grup: perintah beralamat dan balasan diterima bot saat privasi aktif; percakapan grup biasa diterima saat privasi nonaktif atau bot menjadi administrator Bagan mencakup jenis pesan yang digunakan dalam tutorial ini. Telegram juga mendokumentasikan pesan layanan dan perutean perintah yang bergantung pada konteks.

Untuk grup kelas tempat bot seharusnya menjawab permintaan langsung:

  1. Kirim /setjoingroups ke BotFather, pilih bot, dan aktifkan keanggotaan grup jika masih nonaktif.
  2. Kirim /setprivacy, pilih bot, lalu Enable. Jadikan bot anggota biasa tanpa hak administrator. Jika Anda mengubah mode privasi setelah menambahkannya, keluarkan dan tambahkan kembali bot agar pengaturan berlaku.
  3. Tambahkan bot ke grup uji kecil yang Anda kendalikan.
  4. Kirim pesan biasa, misalnya See everyone in class tomorrow. Pesan ini tidak seharusnya memicu balasan dalam konfigurasi ini.
  5. Kirim /schedule@your_bot, dengan mengganti your_bot dengan nama pengguna sebenarnya. Periksa jawaban jadwal, lalu gunakan gestur Reply Telegram pada jawaban itu untuk bertanya What does B1 cost?.

Perintah /schedule tanpa nama bot dapat bergantung pada bot mana yang terakhir dituju. @mention dalam teks biasa bukan pengganti yang andal untuk perintah beralamat dalam mode privasi standar. Gunakan bentuk eksplisit pada pengujian di atas. Lihat aturan mode privasi Telegram.

BotFather menampilkan keanggotaan grup dan pengaturan privasi bot Fernway yang aktif

Pengaturan BotFather yang tersimpan adalah Enable. Jalankan pemeriksaan pesan grup menggunakan bot Anda sendiri untuk memverifikasi pengiriman di grup itu.

Pengujian grup terpisah di bawah menggunakan bot bersama @QuickchatAI_bot, yang terhubung ke Agent Fernway yang sama. Bot menjawab perintah jadwal beralamat dan pertanyaan harga sebagai balasan pada pesan bot. Ini memperlihatkan alternatif bot bersama; bot Fernway khusus kami diverifikasi dalam percakapan pribadi, sehingga perilakunya dalam grup tetap memerlukan pemeriksaan di atas.

Fernway Study Group dengan bot Quickchat AI bersama yang menjawab perintah jadwal beralamat dan balasan yang menanyakan harga kursus B1

Grup ini memakai bot bersama @QuickchatAI_bot. Bot Fernway khusus adalah identitas yang terlihat dalam tangkapan layar percakapan pribadi.

Menonaktifkan privasi atau menjadikan bot administrator dapat membuat percakapan grup biasa diteruskan ke Agent dan menghasilkan lebih banyak balasan. Untuk moderasi, tutorial pengelolaan grup Telegram menjelaskan izin tambahan dan kontrol Action.

Satu grup adalah satu percakapan bersama. Pertanyaan pribadi terkait kursus sebaiknya dikirim ke percakapan pribadi bot. Jika Human Handoff terpicu dalam grup, AI berhenti sementara untuk seluruh grup sampai penugasan ulang; tindakan ini tidak membuat percakapan pribadi terpisah bagi siswa tersebut.

Mengapa bot Telegram Anda tidak membalas?

Mulai dengan pengujian percakapan pribadi paling sederhana, lalu periksa koneksi dan jenis pesan. Perilaku grup dan pengiriman file memiliki ketergantungan tambahan yang terpisah.

GejalaYang perlu diperiksa
BotFather sudah membuat bot, tetapi bot tetap diamSelesaikan koneksi Agent. BotFather tidak menyediakan logika balasan.
Tidak ada sambutanBuka bot yang benar, kirim /start, periksa Enable your own bot dan Welcome message yang dikonfigurasi.
Bot berhenti setelah mencoba layanan bot lainLayanan itu mungkin mengganti webhook. Hubungkan kembali layanan yang dimaksud; gunakan bot terpisah untuk alur lain.
Bot berhenti setelah token digantiPerbarui Bot Token dengan penggantinya dan simpan koneksi.
Bot membalas secara pribadi tetapi tidak di grupPeriksa keanggotaan grup, mode privasi, dan nama pengguna sebenarnya. Coba /schedule@your_bot atau balas pesan bot.
Bot menjawab setiap pesan grupPeriksa apakah privasi nonaktif atau bot menjadi administrator. Kembali ke konfigurasi yang lebih tenang di atas.
Perintah muncul di menu tetapi jawabannya tidak relevanPeriksa aturan Main Prompt, termasuk bentuk perintah beralamat. Pendaftaran menu saja tidak menentukan perilaku.
Bot mengatakan PDF terkirim tetapi tidak ada lampiranPeriksa panggilan Action sebenarnya, URL PDF langsung, dan respons Telegram. Uji melalui Telegram dengan koneksi bot milik sendiri aktif.
Bot membalas sampai pengalihan lalu berhentiPeriksa penerima tugas Inbox. Percakapan yang ditangani manusia atau belum ditugaskan menunggu staf atau penugasan ulang.
Agent tidak dapat menjawab atau pengujian berhentiPeriksa kredit yang tersedia, pemrosesan pengetahuan, dan apakah Agent aktif.
Telegram mengembalikan kesalahan batas lajuKurangi laju pesan dan patuhi interval percobaan ulang yang diberikan Telegram.

Sebelum membagikan bot, ulangi pemeriksaan harga, fakta yang tidak diketahui, PDF, dan balasan staf dalam percakapan pribadi menggunakan konten Anda yang sebenarnya. Ganti semua detail dan tautan Fernway dengan milik Anda. Gunakan dokumentasi saluran Telegram sebagai referensi pengaturan integrasi terkini.

Bisakah ChatGPT atau Claude membantu membangun bot ini?

Klien AI yang terhubung ke akun Quickchat AI Anda dapat menyiapkan Agent, pengetahuan, instruksi, Actions, dan dataset pengujian. Anda tetap membuat identitas Telegram di BotFather dan memasukkan tokennya melalui alur bot milik sendiri di dasbor.

Hubungkan melalui entri ChatGPT atau entri Claude terverifikasi, dengan mengikuti petunjuk Manage with AI. Berikan kit pengaturan dan permintaan ini kepada asisten:

Create a separate learning Agent named Fernway Languages from this tutorial kit. Do not change existing Agents. Set its display name and Identity name, add the knowledge article, and copy the Main Prompt and welcome message exactly. Configure send_course_brochure from action.json but leave it inactive. Use only the System Token reference, never ask me to paste my real Telegram token into chat. Create the Fernway course-answer dataset and evaluation criteria. Prepare Human Handoff using the default rules and show me the availability settings to review. Read back the saved configuration. Do not run tests, spend credits, send Telegram messages or activate Actions yet. List the remaining owner steps: create and configure the bot in BotFather, enter its token under Your own bot, review working hours, activate the Action and complete the real-channel checks. Do not use the shared Telegram connection as a substitute for my own bot.

Koneksi pengelolaan akun yang dipakai di sini berbeda dari menyediakan Agent sebagai alat MCP. Koneksi ini dapat membantu mengonfigurasi alur kerja, tetapi tidak menghilangkan kebutuhan untuk memeriksa balasan dan lampiran Telegram yang nyata.

Pertanyaan yang sering diajukan

Bagaimana cara membuat bot Telegram tanpa kode?

Buka BotFather resmi di Telegram, kirim /newbot, lalu pilih nama tampilan dan nama pengguna unik yang berakhiran bot. Hubungkan token yang diberikan ke layanan bot seperti Quickchat AI. Tambahkan pengetahuan dan instruksi, aktifkan koneksi, lalu uji pesan pribadi. BotFather membuat identitas; layanan yang terhubung menyediakan jawaban.

Apakah membuat bot Telegram gratis?

Pendaftaran bot Telegram melalui BotFather gratis. Quickchat AI memiliki paket Free untuk pembelajaran pribadi nonkomersial, dengan kuota kredit AI terbatas. Penerapan bisnis memerlukan paket komersial. Jawaban AI dan Simulation Testing menggunakan kredit; membuat identitas Telegram tidak mencakup penggunaan AI tanpa batas.

Di mana saya menemukan token bot Telegram?

Buka BotFather resmi, kirim /mybots, pilih bot Anda, lalu pilih API Token. Tempelkan kredensial itu ke kolom Bot Token khusus pada layanan bot Anda. Jangan memasukkannya ke prompt, artikel pengetahuan, repositori publik, atau tangkapan layar.

Apa yang harus dilakukan jika token bot Telegram bocor?

Gunakan /revoke di BotFather untuk membatalkan token yang terekspos, dapatkan pengganti, lalu perbarui layanan yang terhubung dan uji balasan. Hapus juga salinan yang terekspos, tetapi jangan hanya mengandalkan penghapusan: siapa pun yang menyimpan token lama dapat menggunakannya sampai token dicabut.

Bisakah satu bot Telegram dihubungkan ke dua platform?

Bot memiliki satu tujuan webhook untuk pembaruan masuk. Jika platform kedua mengganti webhook itu, platform pertama berhenti menerima pembaruan tersebut. Beberapa sistem masih dapat melakukan panggilan API keluar, tetapi pesan masuk tidak otomatis disalin ke keduanya. Gunakan bot terpisah untuk alur pesan masuk yang independen.

Bagaimana menambahkan perintah ke bot Telegram?

Kirim /setcommands ke BotFather, pilih bot, lalu berikan satu pasangan perintah dan deskripsi per baris, tanpa garis miring di awal. Ini membuat menu. Anda juga harus mengimplementasikan perilakunya: dalam tutorial ini, Main Prompt memetakan /prices, /schedule, /trial, dan /help ke jawaban atau Action yang sesuai.

Mengapa bot Telegram membalas secara pribadi tetapi tidak dalam grup?

Pastikan bot tergabung dalam grup dan coba perintah yang ditujukan ke nama pengguna sebenarnya, seperti /schedule@your_bot, atau balas salah satu pesannya. Saat privasi aktif, percakapan grup biasa tidak dikirim ke bot nonadministrator. Sebutan teks biasa bukan pengganti yang andal untuk perintah beralamat.

Bisakah saya menambahkan AI atau ChatGPT ke bot Telegram?

Anda dapat menghubungkan bot BotFather ke layanan AI. Tutorial ini memakai Quickchat AI Agent dengan pengetahuan, Main Prompt, dan Actions sendiri; tutorial ini tidak menghubungkan percakapan ChatGPT pribadi Anda ke Telegram. Asisten pengelolaan akun yang kompatibel dapat membantu menyiapkan Agent, sementara pemilik menyelesaikan koneksi bot milik sendiri.

Bisakah bot Telegram ini menjawab pesan suara?

Integrasi Telegram Quickchat AI saat ini tidak mentranskripsikan pesan suara untuk Agent. Lampiran suara dapat muncul di Inbox, tetapi tutorial ini mengandalkan pesan yang diketik. Minta siswa mengetik pertanyaannya atau minta seseorang memeriksa lampiran.

Apakah ini mengotomatiskan akun Telegram pribadi saya?

Tidak. Tutorial ini membuat identitas bot terpisah dengan nama penggunanya sendiri. Telegram menawarkan fitur otomatisasi akun lain, tetapi koneksi Quickchat AI yang dijelaskan di sini menangani pesan yang dikirim ke bot; koneksi ini tidak mengatur balasan dari profil pribadi Anda.

Quickchat AI Quickchat AI Ask Quickchat AI a question