Chatbot AI Telegram dapat menjawab pertanyaan berdasarkan pengetahuan bisnis Anda dalam grup maupun percakapan pribadi. Quickchat AI menghubungkan AI Agent ke Telegram melalui bot bersama: tambahkan ke grup, konfirmasikan koneksi di dasbor, lalu anggota dapat menyebut bot untuk bertanya. Jalur ini tidak memerlukan kode atau token BotFather.
Tutorial ini membangun Saltmarsh Sailing School, sekolah fiktif dengan grup anggota dan layanan pertanyaan pribadi. Dua Agent memakai fakta sekolah yang sama: Saltmarsh Group menjawab pertanyaan publik, sedangkan Saltmarsh Sailing School menangani permintaan kelas percobaan pribadi dan melibatkan staf untuk pengembalian dana. Permintaan merupakan pertanyaan untuk kantor, bukan pemesanan yang sudah dikonfirmasi.
Dua Agent memisahkan tanggung jawab. Agent grup tidak memiliki Action pencatatan atau pengalihan; Agent pribadi menangani permintaan dan balasan staf.
Ikuti alur berikut. Ekstensi Google Sheets bersifat opsional; Anda dapat menyelesaikan alur jawaban dan pengalihan terlebih dahulu.
| Tahap | Titik pemeriksaan pembaca |
|---|---|
| 1. Pengetahuan dan instruksi | Agent mengetahui harga kursus dan tidak mengarang fakta yang belum tersedia. |
| 2. Koneksi grup | Sebutan mendapat jawaban; obrolan biasa tidak memicu balasan. |
| 3. Chat pribadi | Tautan lengkap membuka percakapan dengan Agent yang benar. |
| 4. Permintaan percobaan opsional | Detail wajib menjadi baris yang dapat ditindaklanjuti staf. |
| 5. Human Handoff | Staf mengambil alih percakapan dan AI berhenti sementara. |
| 6. Pengujian | Periksa jawaban, pengalihan, dan dampak eksternal secara terpisah. |
Unduh kit Saltmarsh Telegram untuk pengetahuan, Main Prompt, resep Action, kriteria evaluasi, dan pesan uji yang persis digunakan di sini. File ini dapat diedit untuk langkah berikut, bukan impor Agent sekali klik. Materi demo yang dapat disalin dan tangkapan layar tetap berbahasa Inggris.
Apa yang diperlukan untuk membuat chatbot Telegram?
Anda memerlukan akun Quickchat AI, dua Agent, dan akun Telegram yang berwenang menambahkan bot ke grup uji. Langkah pencatatan permintaan opsional juga memerlukan akun Google yang dapat mengizinkan Google Sheets.
- Buat akun Quickchat AI dan verifikasi email jika diminta. Free mendukung pembelajaran pribadi nonkomersial. Paket berlaku per Agent, sehingga bisnis nyata yang memakai keduanya memerlukan cakupan komersial yang sesuai untuk kedua Agent. Preview dan Simulation memakai kredit AI. Lihat paket saat ini.
- Buat grup Telegram bernama
Saltmarsh Members. Gunakan grup uji untuk memeriksa sebutan, keheningan, dan pesan lanjutan sebelum mengundang pelanggan. - Gunakan akun Telegram Anda sendiri untuk mengikuti panduan, termasuk mengirim pesan pengunjung. Anda juga dapat mengoperasikan Inbox Quickchat AI. Sebelum mengundang pelanggan, minta rekan memeriksa pengalaman dari akun lain.
- Ekstrak kit. Simpan fakta contoh sekolah sebagai satu kesatuan; ganti dengan kebijakan Anda yang sudah diverifikasi sebelum penerapan.
Tangkapan layar Quickchat App menampilkan aplikasi yang berjalan secara lokal dengan konfigurasi Saltmarsh fiktif; data uji koneksi dijelaskan dalam keterangannya. Tangkapan layar Telegram dan Google Sheets menunjukkan balasan nyata serta permintaan yang tersimpan dari demo terhubung. Detail akun pribadi dipotong atau disembunyikan secara jelas. Gunakan daftar periksa terakhir untuk mengulangi pengujian dengan pengetahuan dan akun terhubung Anda sendiri.
Langkah 1: bagaimana mengajarkan bisnis Anda kepada chatbot Telegram?
Masukkan fakta bisnis ke Knowledge Base dan instruksi operasional ke Main Prompt. Memisahkan keduanya memudahkan koreksi jawaban tanpa mengubah perilaku Agent.
Harga dan kebijakan merupakan fakta sumber. Keringkasan, ketidakpastian, dan pengalihan merupakan instruksi.
Buat Agent dan tambahkan pengetahuannya
- Pada akun baru, pilih Set up manually. Pada akun yang sudah ada, pilih Add new AI Agent dahulu, lalu jalur manual.
- Di Identity, masukkan
Saltmarsh Grouppada Name your AI Agent. Tempelgroup-main-prompt.txtdari kit ke Describe what you want your agent to do. - Lanjutkan penyiapan tanpa menghubungkan aplikasi eksternal dahulu. Selesaikan langkah paket; gunakan Skip for now jika memulai dengan akun belajar.
- Buka Knowledge Base > Add Article. Masukkan
Courses and trial enquiriespada Create custom article, pilih Create article, tempelsaltmarsh-courses.txtke Content, lalu Save. - Ulangi untuk
Weather, parking and personal enquiriesmenggunakansaltmarsh-policies.txt. Tunggu kedua artikel menampilkan Ready. - Buka Actions & MCPs pada Saltmarsh Group. Biarkan Human Handoff nonaktif dan jangan tambahkan Action permintaan kelas percobaan.
- Pilih Add new AI Agent dan ulangi penyiapan manual untuk
Saltmarsh Sailing School, memakaimain-prompt.txtdan dua file pengetahuan yang sama. Agent kedua menangani percakapan pribadi. Pilih Agent yang dimaksud di pemilih akun sebelum mengubah pengaturannya.
Dua sumber singkat memperjelas fakta yang dimiliki Agent. Ready menjadi titik pemeriksaan sebelum menguji pengetahuan.
| Pengetahuan | Fakta persis dalam contoh ini |
|---|---|
| Kursus | Start Sailing: dua hari, EUR 240. Day Skipper theory: lima malam, EUR 310. Kelas privat: 90 menit, EUR 95. |
| Jadwal | Musim April sampai Oktober; jadwal diterbitkan satu bulan sebelumnya. Tidak ada ketersediaan langsung atau tanggal berikutnya. |
| Perlengkapan | Jaket tahan air, sepatu yang tidak meninggalkan bekas, dan pakaian ganti. Alat bantu apung disediakan. |
| Cuaca | Lebih dari 25 knot atau badai petir: pindah ke tanggal tersedia berikutnya tanpa biaya tambahan. Instruktur memutuskan pada pagi hari tersebut. |
| Parkir | Gratis di clubhouse. Kode gerbang dikirim sehari sebelumnya; kodenya sendiri tidak tercantum. |
| Permintaan percobaan | Kumpulkan nama, hari pilihan, dan pengalaman berlayar. Kantor mengonfirmasi ketersediaan dan harga. |
Informasi penyewaan wetsuit sengaja tidak disertakan. Jawaban yang benar adalah Agent tidak dapat memastikannya, bukan mengarang ya atau tidak. Aturan cuaca juga tidak memberi prakiraan hari ini, dan harga kelas privat tidak menentukan harga kelas percobaan.
Atur Main Prompt dan periksa jawaban
- Buka Identity > Main Prompt pada tiap Agent dan periksa prompt Saltmarsh yang sesuai. Prompt grup menjawab pertanyaan umum dan mengarahkan ke tautan pribadi yang disematkan; prompt pribadi mengumpulkan permintaan dan menggunakan Human Handoff.
- Buka AI Preview dan tanyakan
How much is Start Sailing?. Periksa jawaban dua hari dan EUR 240. - Tanyakan
Do you rent wetsuits?. Pastikan jawabannya mengakui informasi yang tidak tersedia.
Prompt Agent pribadi mengatur pengumpulan dan pengalihan. Agent grup memakai prompt terpisah dan menonaktifkan kedua Action.
Dua potongan pengaturan nyata Agent grup. Agent dapat menjawab pertanyaan pengetahuan, tetapi tidak memiliki Action pencatatan atau pengalihan untuk dijalankan.
Dua Agent memperjelas pengalihan. Agent grup tidak memiliki kemampuan handoff yang dapat terpicu tanpa sengaja; Agent pribadi dapat meneruskan pengembalian dana tanpa menghentikan grup. Preview memeriksa fakta sekolah; langkah berikut memverifikasi setiap koneksi Telegram.
Langkah 2: bagaimana menambahkan chatbot AI ke grup Telegram?
Buka External Apps > Telegram, tambahkan bot bersama ke grup, lalu kembali ke Quickchat AI untuk Confirm grup. Agent tetap diam di grup sampai Anda mengonfirmasikannya.
Keanggotaan Telegram dan konfirmasi Quickchat AI merupakan langkah terpisah.
- Pilih Saltmarsh Group pada pemilih Agent. Buka External Apps, pilih Telegram, lalu cari Quickchat AI bot.
- Pilih Add to a Telegram group. Di Telegram, pilih
Saltmarsh Membersdan setujui penambahan bot. - Kembali ke Quickchat AI. Di Waiting for your confirmation, periksa nama grup dan informasi Added by.
- Pilih Confirm untuk grup yang benar. Grup akan berpindah ke Connected chats dengan sakelar aktif.
- Di Telegram, ketik
@dan pilih bot dari pemilih sebutan. TanyakanHow much is Start Sailing?. Nama pengguna bot bersama biasanya@QuickchatAI_bot; gunakan nama yang benar-benar ditampilkan di grup Anda. - Balas jawaban itu langsung dengan
What should I bring?. Lalu kirim pesan terpisah tanpa sebutan:Does anyone know the gate code?. Bot bersama seharusnya menjawab balasan langsung dan diam pada pesan biasa.
Pilih Saltmarsh Members di Telegram, lalu kembali ke Quickchat AI untuk mengonfirmasi koneksi.
UI lokal nyata dengan data grup uji, menunjukkan lokasi Confirm. Ini memperlihatkan kontrol, bukan bukti bot bergabung ke grup Telegram langsung.
Grup yang telah dikonfirmasi menerima jawaban kursus yang diharapkan. Sebut bot menggunakan nama pengguna aslinya.
Membalas pesan bot berfungsi tanpa menyebutnya lagi. Jawaban mencantumkan fakta perlengkapan yang diberikan.
Konfirmasi penting karena muatan undangan terlihat di grup. Quickchat AI memerlukan keputusan dari akun sebelum menjadikan grup sebagai tujuan Agent. Jangan konfirmasi grup yang tidak Anda kenal. Referensi koneksi Telegram menjelaskan batas ini.
Selesaikan konfirmasi sebelum meninggalkan pengaturan. Jika bot keluar dari grup yang belum dikonfirmasi, buat tautan Add to a Telegram group baru, tambahkan lagi, lalu segera konfirmasi grup yang tertunda di Quickchat AI. Menambahkan bot melalui pencarian anggota Telegram tidak menggantikan alur koneksi ini.
Lencana Admin menunjukkan status bot di Telegram. Status ini tidak diperlukan untuk jawaban biasa bot bersama. Menjadikannya admin juga tidak mengubah aturan sebutan atau balasan.
Langkah 3: bagaimana mengaktifkan chat Telegram pribadi?
Aktifkan Direct message link dan bagikan URL lengkap yang dihasilkan. Tautan memilih Agent Anda di dalam bot Telegram bersama, sehingga pelanggan dapat bertanya secara pribadi tanpa menambahkannya ke grup.
Grup merupakan percakapan bersama. Pindahkan detail pribadi dan pengalihan ke staf ke DM.
- Pilih Saltmarsh Sailing School, Agent pribadi. Buka External Apps > Telegram dan aktifkan Direct message link. Biarkan koneksi grupnya kosong.
- Salin tautan yang dihasilkan. Pertahankan parameter
start=; tautan dasar bot bersama tidak mengidentifikasi Agent Anda. - Buka di Telegram dan tekan Start jika diminta.
- Tanyakan
How much is Start Sailing?tanpa menyebut bot. Verifikasi jawaban sekolah dan temukan percakapannya di Inbox. - Sematkan tautan pada pesan sambutan grup agar anggota menemukannya sebelum membagikan informasi pribadi.
Gunakan tautan yang dibuat untuk Agent Anda sendiri. Konfigurasi lokal ini bukan bukti pengiriman Telegram langsung.
Telegram mengirimkan sambutan Saltmarsh setelah Start. Selanjutnya periksa jawaban berbasis pengetahuan; sapaan saja tidak menguji pengambilan informasi.
Dua potongan dari layar Telegram yang sama menunjukkan undangan yang disematkan. Nilai start pada tautan demo tidak ditampilkan; sematkan tautan lengkap yang dihasilkan untuk Anda sendiri.
Chat pribadi dengan bot bersama terikat pada satu Agent pada satu waktu. Membuka tautan Agent lain dapat mengganti ikatan tersebut. Untuk identitas Telegram sendiri dan utas bot khusus, gunakan jalur bot sendiri.
Menonaktifkan Direct message link mencegah koneksi baru melalui tautan itu. Untuk menghentikan chat yang sudah terhubung, gunakan sakelar chat tersebut atau Disconnect. Perlakukan tautan sebagai pintu masuk publik, bukan pembatas akses pengetahuan rahasia.
Langkah 4: bagaimana menyimpan permintaan kelas percobaan ke Google Sheets?
Integrasi Google Sheets membuat spreadsheet dan Action penambahan baris. Sesuaikan Action untuk mencatat tiga kolom wajib permintaan percobaan, lalu verifikasi baris sebenarnya. Langkah ini opsional dan mendukung bot Telegram bersama.
Hasilnya berupa permintaan untuk ditindaklanjuti seseorang. Ini tidak memesan tempat atau menetapkan harga percobaan.
Hubungkan Sheets dan konfigurasikan satu Action
- Pada Saltmarsh Sailing School, buka Actions & MCPs > Add Action > Google Sheets dan pilih Connect Google Sheets. Masuk ke akun Google yang dimaksud dan setujui akses yang diminta.
- Buka spreadsheet Quickchat Leads yang dihasilkan. Pertahankan nama tab Leads karena URL Action mengarah ke tab itu.
- Ganti baris judul secara berurutan dengan
Name,Preferred weekday,Sailing experience,Conversation link,Channel. - Buka Actions & MCPs dan edit Action
log_lead_to_google_sheetyang dihasilkan. Gunakan resep berikut. Ubah parameter, isi permintaan, dan judul spreadsheet bersama-sama agar posisinya cocok.
API Action Name
Record trial-lesson request
What to ask the user first
| Format | Name | Description | Required |
|---|---|---|---|
| Text | name | Nama yang diberikan orang tersebut untuk permintaan kelas percobaan ini. Tanyakan jika belum ada. | Yes |
| Text | preferred_weekday | Hari pilihan untuk kelas percobaan, misalnya Selasa. Ini preferensi, bukan tanggal yang dikonfirmasi. | Yes |
| Text | sailing_experience | Pengalaman berlayar yang dinyatakan orang tersebut, misalnya pemula. Tanyakan jika belum ada; jangan menyimpulkan sendiri. | Yes |
Atur ketiga parameter ke No default dan hapus parameter email serta pertanyaan bawaan. Hanya tiga kolom ini yang ditanyakan dalam resep. Nama pengguna Telegram opsional dan tidak dapat diandalkan sebagai kontak wajib; tautan percakapan yang dicatat memberi staf jalan kembali ke permintaan.
Metode dan URL: pertahankan URL POST yang dihasilkan. URL sudah berisi ID spreadsheet, tab Leads, dan valueInputOption=RAW. Tidak ada ID spreadsheet contoh yang perlu diganti.
Header: pertahankan konfigurasi integrasi.
| Nama header | Nilai |
|---|---|
Authorization | Bearer {{google_sheets_access_token}} |
Content-Type | application/json |
Pada tab Body di API Endpoint, gunakan:
{"values":[["{{name}}","{{preferred_weekday}}","{{sailing_experience}}","{{conversation_url}}","{{conversation_channel}}"]]}
Gunakan Add AI Data untuk memasukkan chip parameter dan variabel percakapan bila diperlukan. Tiga nilai pertama berasal dari percakapan; dua terakhir disediakan Quickchat AI.
API Action Description
In a private chat only, call this once when the person has requested a trial lesson and provided their name, preferred weekday and sailing experience. Ask for the next missing required field before calling. Do not call it for general course questions, in groups, or to confirm a booking. A successful call records an enquiry for the office; it does not reserve a place.
Buka Advanced settings > Run only when dan tambahkan telegram_chat_type equals private. Gunakan kunci metadata saja, tanpa metadata_ atau kurung kurawal. Ini mencegah permintaan HTTP untuk pesan grup walaupun model mencoba menjalankannya. Referensi kondisi eksekusi menjelaskan pemeriksaan ini.
Atur Response filter ke $.updates.updatedRows agar Action mengembalikan jumlah baris, bukan respons penyedia yang tidak diperlukan. Biarkan Action aktif.
Kunci yang digunakan adalah telegram_chat_type. Kondisi diperiksa sebelum permintaan dikirim.
Konfigurasi lokal resep permintaan. URL Sheets dan otorisasi OAuth harus berasal dari koneksi Google Anda sendiri.
Periksa baris, lalu permintaan yang belum lengkap
Kirim pesan ini melalui tautan Telegram pribadi Agent:
I am Alex Morgan. I want a trial on Tuesday. I am a beginner.
Periksa ketiganya: jawaban menyebut permintaan, kartu Action di Inbox memperlihatkan nilai yang diberikan, dan tab Leads sebenarnya berisi baris yang cocok. Jawaban yang meyakinkan maupun skor Simulation tinggi tidak membuktikan penulisan ke Google Sheets.
Agent mencatat nama yang diberikan, preferensi hari Selasa, dan pengalaman pemula. Ketersediaan serta harga pasti masih memerlukan konfirmasi kantor.
Dua detail dari baris tersimpan yang sama menjaga kelima kolom tetap terbaca. Tautan percakapan khusus akun disembunyikan; empat nilai lainnya tidak diubah.
Mulai pengujian terpisah dengan I would like a trial lesson. Agent harus meminta kolom yang belum ada, satu pertanyaan setiap kali, sebelum Action berjalan. Coba juga How much is Start Sailing?; pertanyaan kursus biasa tidak boleh membuat baris. Prompt meminta satu penulisan per permintaan, tetapi resep penambahan ini bukan sistem pemesanan idempoten. Periksa duplikat sebelum memakainya dalam operasi.
Langkah 5: bagaimana mengalihkan percakapan Telegram ke seseorang?
Konfigurasikan Human Handoff, lalu periksa penugasan percakapan di Inbox. Prompt yang mengatakan kantor akan membalas tidak dengan sendirinya mengalihkan kepemilikan atau menghentikan AI.
Perubahan penugasan menjadi titik pemeriksaan. Selesaikan kasus dengan staf; periksa pengembalian ke AI secara terpisah.
- Pilih Saltmarsh Sailing School, buka Actions & MCPs > Human Handoff, lalu aktifkan. Biarkan Action ini nonaktif pada Saltmarsh Group.
- Pada Handoff Rules, pilih kontrol +. Masukkan
Private enquiriessebagai Rule Name, tempelhandoff-rule.txtke Description, dan aktifkan State. Baris baru awalnya nonaktif. Aturan mencakup pengembalian dana, keluhan, permintaan staf, dan penerimaan bantuan manusia pada Agent pribadi ini. - Kosongkan Keywords dan nonaktifkan aturan bawaan untuk contoh ini; sisakan satu aturan khusus aktif, lalu simpan. Pemisahan grup berasal dari Human Handoff yang nonaktif pada Agent grup terpisah; aturan khusus menjelaskan kapan Agent pribadi harus mengalihkan.
- Atur Confirmation ke
I have passed this private conversation to the Saltmarsh office. A member of staff can reply here.Sesuaikan Human Agents’ availability dengan jam layanan tim yang sebenarnya dan buat pesan di luar jam kerja yang jujur. - Dari chat Telegram pribadi, kirim
I want a refund for last week. Can I speak to a person?. - Di Inbox, temukan percakapan, periksa penugasan, pilih Assign to me, lalu kirim
Hi, I’m Alex from the office. I’ll review your request.Periksa bahwa pesan tiba di Telegram. - Kirim pesan pelanggan lagi saat staf memiliki percakapan. AI harus tetap diam. Biarkan operator menyelesaikan kasus dan menandainya selesai di Inbox. Perlakukan pengembalian ke AI sebagai pengujian terpisah.
State aturan khusus aktif. Pemicu bawaan nonaktif sehingga hanya satu aturan perlu ditinjau.
Permintaan Telegram langsung memicu Handoff. Penugasan di Inbox dan balasan keluar operator diverifikasi secara terpisah.
Dalam pemeriksaan langsung, percakapan berpindah ke Unassigned, siap diambil alih seseorang. Operator memilih Assign to me, mengirim balasan kantor, dan Telegram menerimanya. Tangkapan layar di atas menunjukkan balasan pengalihan; pesan operator sesudahnya tidak terlihat. Periksa penugasan dan pengiriman saat mengulangi pengujian.
Biarkan operator menangani kasus ini hingga selesai. Dalam pengujian pengembalian dana lokal, mengembalikannya ke AI Agent menghasilkan satu jawaban sebelum Handoff terpicu lagi. Pengembalian ke AI memerlukan pengujian lanjutan yang berhasil secara terpisah; ini bukan bagian dari kriteria penyelesaian alur kerja ini. Panduan pengalihan ke manusia membahas staf dan tanggung jawab secara lebih terperinci.
Langkah 6: bagaimana menguji chatbot Telegram secara lengkap?
Gunakan Testing untuk pemeriksaan jawaban yang dapat diulang, lalu verifikasi jalur Telegram langsung dan dampak eksternal secara terpisah. Model dapat menjawab benar sementara koneksi grup, penulisan spreadsheet, atau pengiriman setelah pengalihan masih bermasalah.
Periksa sistem pemilik hasil: pengetahuan untuk fakta, log Action untuk permintaan, Sheets untuk baris, dan Telegram untuk pengiriman.
Jalankan dataset jawaban yang dapat diulang
- Buka Testing, buat dataset bernama
Saltmarsh: knowledge checks, dan pilih Paste messages. - Tempel
simulation-messages.txt. Pertahankan pemisah---pada baris tersendiri di antara kasus. - Buka Evaluation criteria, tempel
evaluation-criteria.txtdari kit, lalu simpan. - Pilih Run > Start Run, lalu periksa masing-masing jawaban serta skornya.
Pertahankan pertanyaan yang sama saat mengubah satu instruksi agar perbandingan tetap berguna.
Baca jawabannya juga, bukan hanya skor. Ini pengujian pengetahuan lokal, bukan pengiriman Telegram.
Evaluator memerlukan fakta sekolah untuk menilai akurasi. Ia juga perlu mengetahui bahwa transkrip tidak membuktikan baris spreadsheet, pengiriman Telegram, atau perubahan penugasan. Simulation teks standar tidak menyediakan metadata chat Telegram, sehingga kondisi Action khusus pribadi tidak dianggap rusak ketika metadata itu tidak ada. Jalankan pemeriksaan yang bergantung pada kanal di chat pribadi sebenarnya.
Apa yang berubah karena pengujian lokal?
Desain awal menggunakan satu Agent untuk kedua jalur masuk. Pengujian lokal menunjukkan bahwa permintaan pengembalian dana di grup mengalihkan percakapan bersama ke Human Handoff. Kami memisahkan Agent dan menonaktifkan Handoff serta Actions pencatatan permintaan pada Agent grup. Pengujian ulang permintaan pengembalian dana dan kelas percobaan di grup kemudian mengarahkan pengguna ke tautan pribadi yang disematkan sambil mempertahankan penugasan kepada AI. Karena itulah Langkah 1 menggunakan konfigurasi sekaligus instruksi untuk memisahkan kedua percakapan.
Sepuluh pemeriksaan pengetahuan lokal terakhir masing-masing mendapat skor 5/5, dan kedua Agent yang dihosting lulus sepuluh kasus yang sama. Pengujian kecil ini bukan perkiraan akurasi produksi. Grup langsung juga menjawab pertanyaan harga kursus dan barang bawaan, lalu menolak memastikan penyewaan wetsuit. Pertahankan kasus dengan fakta yang tidak tersedia saat menyesuaikan kit; jawaban harga yang benar saja tidak menguji kemampuan Agent membatasi klaimnya.
Pengetahuan yang tidak tersedia menghasilkan jawaban “tidak dapat memastikan”. Pesan kode gerbang terpisah tidak ditujukan kepada bot, dan tidak ada balasan yang terlihat dalam tangkapan ini.
Permintaan kelas percobaan pribadi secara langsung menghasilkan satu panggilan Sheets Action yang berhasil dengan Alex Morgan, Tuesday, dan beginner. Google mengembalikan HTTP 200 dan satu baris yang diperbarui; baris tersimpan juga berisi tautan percakapan dan kanal telegram. Pengujian Action terpisah dengan metadata grup tidak mengirim permintaan HTTP. Periksa permintaan pribadi yang diterima dan konteks grup yang ditolak saat menyesuaikan pembatas ini.
Periksa kanal dan dampaknya
Gunakan test-matrix.csv kosong dalam kit untuk mencatat pengamatan Anda. Tangkapan layar di atas menunjukkan hasil yang didemonstrasikan; tabel juga memuat pemeriksaan untuk dijalankan dengan konfigurasi Anda sendiri. Catat waktu yang berlalu saat menguji tidak adanya respons, dan pisahkan pengambilalihan manusia dari pengembalian ke AI setelahnya.
| Uji | Kirim atau lakukan | Hasil yang diharapkan |
|---|---|---|
| Sebutan grup | @QuickchatAI_bot How much is Start Sailing? | Jawaban singkat dengan EUR 240; percakapan Inbox yang cocok. |
| Balasan ke bot | What should I bring? | Daftar perlengkapan tanpa sebutan tambahan. |
| Obrolan biasa | Does anyone know the gate code? tanpa sebutan | Tidak ada balasan bot bersama. |
| Kekurangan pengetahuan | Sebut bot dan tanyakan Do you rent wetsuits? | Tidak dapat memastikan; tidak mengarang ya atau tidak. |
| Permintaan pribadi di grup | Sebut bot dan minta pengembalian dana | Diarahkan ke chat pribadi; grup tetap ditugaskan ke AI. |
| Jawaban pribadi | Buka tautan DM lengkap dan tanyakan harga | Agent yang benar menjawab tanpa sebutan. |
| Permintaan percobaan lengkap | Kirim pesan Alex Morgan dari Langkah 4 | Parameter Action sesuai dengan baris Sheets nyata; tidak mengklaim pemesanan. |
| Handoff pribadi | Minta pengembalian dana, lalu balas setelah pengambilalihan | Penugasan manusia, pesan operator terkirim, tidak ada jawaban AI tambahan. |
| Kebijakan cuaca | What happens if the forecast says 30 knots? | Kebijakan jadwal ulang gratis dan keputusan instruktur; tidak mengklaim prakiraan langsung. |
Jika pemeriksaan gagal, ubah satu pengaturan relevan dan kirim ulang pesan yang sama. Perbaiki fakta sumber yang hilang di Knowledge Base; perbaiki Action yang terlalu dini melalui deskripsi atau parameter wajib; untuk grup diam, periksa konfirmasi dan penyebutan terlebih dahulu. Simpan hasil gagal agar perbaikannya terlihat.
Kapan perlu membuat bot sendiri dengan BotFather?
Buat bot Telegram sendiri jika membutuhkan nama dan foto sendiri, Action Telegram Bot API, atau grup yang menerima pesan biasa. Bot bersama cukup untuk alur grup dan jawaban pribadi di atas.
Pilih identitas dan perilaku pesan yang dibutuhkan sebelum menambahkan bot kedua.
| Kebutuhan | Bot bersama Quickchat AI | Bot Anda sendiri |
|---|---|---|
| Membuat token BotFather | Tidak diperlukan | Diperlukan |
| Nama dan foto Telegram khusus | Identitas bersama | Identitas bot Anda |
| Menjawab sebutan dan balasan grup | Ya | Ya, jika Telegram mengirimkannya |
| Menjawab pesan grup biasa | Bot bersama tetap diam | Atur privasi Telegram atau status admin |
| Percakapan pribadi | Tautan mulai khusus Agent di bot bersama | Utas pribadi bot Anda sendiri |
| Action Google Sheets | Didukung | Didukung |
| Action moderasi Telegram | Token bersama tidak ditampilkan | Token sendiri tersedia sebagai System Token |
- Buka akun BotFather terverifikasi di Telegram dan kirim
/newbot. - Pilih nama tampilan, lalu nama pengguna tersedia yang berakhir dengan
bot. BotFather mengembalikan token. Jaga kerahasiaannya. - Pilih Saltmarsh Group jika bot ini akan bergabung ke grup. Gunakan Saltmarsh Sailing School hanya untuk chat pribadi. Pada External Apps > Telegram, buka Your own bot dan pilih Connect to Telegram.
- Tempel token ke Bot Token dan selesaikan koneksi. Pastikan Enable your own bot aktif.
- Buka tautan Telegram bot, kirim
/start, lalu pertanyaan harga kursus yang sama. - Untuk menerima pesan grup biasa, gunakan
/setprivacydi BotFather, pilih bot Anda dan Disable, lalu keluarkan dan tambahkan kembali ke grup uji. Bot admin juga menerima pesan biasa. Dokumentasi mode privasi Telegram menjelaskan aturan pengiriman.
Tempel token hanya ke Bot Token. Kolom ditampilkan kosong agar tidak memublikasikan kredensial.
Tempatkan bot bersama dan bot sendiri di grup terpisah. Keduanya dalam satu grup dapat menghasilkan balasan ganda. Untuk menyematkan pengumuman atau memoderasi anggota, ikuti tutorial pengelolaan grup Telegram terpisah, termasuk kondisi Action khusus admin.
Dapatkah ChatGPT atau Claude membantu mengonfigurasi chatbot Telegram?
Aplikasi pengelolaan akun Quickchat AI yang terhubung dapat membantu membuat Agent, menambahkan pengetahuan, mengonfigurasi pengaturan yang didukung, dan menjalankan pengujian. Jika klien menyediakan penyiapan Telegram, aplikasi dapat mengaktifkan tautan pesan pribadi bot bersama. Pemilihan grup dan konfirmasi dasbor tetap menjadi langkah pemilik. Beberapa klien juga memerlukan dasbor untuk mengaktifkan tautan pribadi dan mengatur Human Handoff, jadi minta asisten memeriksa alat yang tersedia terlebih dahulu.
Hubungkan plugin Quickchat AI untuk ChatGPT atau konektor Claude, lalu berikan file kit dengan prompt ini:
Use my connected Quickchat AI account to create two Agents from the attached kit: Saltmarsh Group with group-main-prompt.txt and Saltmarsh Sailing School with main-prompt.txt. Add both knowledge files to each. Keep Actions and Human Handoff off on Saltmarsh Group. Prepare the supplied knowledge-test dataset. Check the tools available in this client before changing settings. Show me the configuration and ask before running credit-consuming tests or writing to Google Sheets. Where supported, enable only Saltmarsh Sailing School's shared-bot direct-message link and return the complete link. Leave group selection, dashboard confirmation, BotFather setup, Google OAuth and unsupported settings for me, with exact dashboard steps. Report what was configured, what was actually tested and what remains to verify in Telegram.
Ketersediaan alat bergantung pada klien dan izin akun. Ikuti referensi penyiapan pengelolaan akun untuk masuk. Ini menghubungkan asisten ke akun Quickchat AI; tidak menjadikan percakapan ChatGPT atau Claude pribadi sebagai backend bot Telegram yang dihosting.
Mengapa chatbot Telegram tidak membalas?
Periksa koneksi dan jalur pesan sebelum menulis ulang prompt. Gejala ini memiliki penyebab berbeda.
| Gejala | Pemeriksaan |
|---|---|
| Grup terdaftar tetapi diam | Konfirmasikan grup yang benar, aktifkan di Connected chats, lalu sebut nama pengguna bot sebenarnya atau balas pesannya. |
| Bot keluar sebelum jawaban pertamanya | Buat tautan Add to a Telegram group baru, tambahkan lagi, lalu segera pilih Confirm untuk grup yang tertunda di Quickchat AI. |
| Tautan bot dasar membuka Agent yang salah | Gunakan tautan pribadi lengkap termasuk start=. Periksa apakah tautan Agent lain mengganti chat pribadi bersama. |
| AI berhenti setelah permintaan pengembalian dana | Periksa penugasan Inbox. Percakapan yang dialihkan tetap dijeda sampai sengaja ditugaskan ulang. |
| Tidak ada baris di Sheets | Pastikan Action aktif, semua kolom wajib ada, chat bersifat pribadi, dan URL masih menuju Leads. Periksa panggilan Action dan koneksi Google. |
| Bot sendiri tidak menerima pesan biasa | Periksa mode privasi dan izin grup; keluarkan dan tambahkan kembali setelah mengubah privasi. |
| Jawaban menyebut tanggal atau layanan yang tidak pernah diberikan | Periksa pengetahuan tersimpan berstatus Ready dan instruksi ketidakpastian. Ulangi pertanyaan yang sama persis. |
| Pengujian tidak lagi menjawab | Periksa kredit AI tersedia dan permintaan yang gagal; jangan menganggap kehabisan kuota sebagai hasil kualitas prompt. |
Sebelum mengundang pelanggan, ganti fakta fiktif, tinjau pemisahan grup dan percakapan pribadi, serta siapkan staf untuk antrean pengalihan. Minta rekan memeriksa jalur masuk publik dari akun lain sebagai pemeriksaan terakhir sebelum peluncuran. Untuk kanal komunitas lain, tutorial chatbot Discord mengikuti alur pembuatan dan pengujian serupa. Untuk percakapan karakter, gunakan panduan roleplay Telegram.
Pemeriksaan penyiapan opsional: bandingkan metode penerapan berdasarkan kebutuhan yang Anda nyatakan, atau bandingkan balasan per anggaran kredit berdasarkan anggaran yang diberikan. Kalkulator ini tidak memeriksa akun, situs, atau saldo Anda.
Konfigurasi Saltmarsh yang dapat disalin
Berikut fakta sumber dan instruksi lengkap yang digunakan tutorial ini. Unduhan juga menyertakan resep Action, kriteria evaluasi, dan pengujian.
Agent grup: Main Prompt
Tempel ke Identity > Main Prompt pada Saltmarsh Group. Biarkan Human Handoff dan Action khusus nonaktif pada Agent ini.
You answer general questions in the Saltmarsh Sailing School members' group. Use only the Knowledge Base and keep each reply to two or three sentences. Do not add facts or requirements the sources do not contain. If a fact is missing, say that you cannot confirm it.
For trial requests, refunds, complaints, personal details or a request for a person, direct the member to the school's private link pinned in the group; do not invent a link. Do not collect personal details in this group. You cannot record requests, confirm bookings, approve refunds or transfer a conversation to staff. Do not claim you did any of these things. The private Agent records an enquiry; it cannot check live availability or confirm a trial. Only the office confirms availability and price.
Agent pribadi: Main Prompt
Tempel ke Identity > Main Prompt pada Saltmarsh Sailing School. Pastikan nama Action sesuai dengan resep.
You are the private-chat assistant of Saltmarsh Sailing School. Answer school questions from the Knowledge Base. Do not add plausible details that are not in the sources, including extra clothing or footwear requirements. Keep replies to two or three sentences and ask at most one question per message. If a fact is missing, say that you cannot confirm it; do not invent dates, availability, gate codes or wetsuit rental. Explain weather policy without claiming to know the current forecast.
When a person requests a trial lesson, collect their name, preferred weekday and sailing experience. Ask for only the next missing field. When all three are present, use Record trial-lesson request once. Say the request was recorded only after the Action succeeds. Explain that the office still needs to confirm availability and price; never say a lesson is booked. If the Action is unavailable or fails, say the request has not been recorded and offer a person.
Use Human Handoff for a current unresolved refund request, complaint or explicit request for a person. After a staff member has resolved the enquiry and returned the conversation to AI, answer new general questions normally; do not hand off again solely because an earlier message mentioned a refund or asked for a person. Do not approve refunds or promise a response time. For a missing fact, say what is unknown and offer a person; do not treat uncertainty as a negative answer about the service.
Pengetahuan: kursus dan permintaan percobaan
Tempel ke kolom Content artikel pengetahuan pertama.
Saltmarsh Sailing School demonstration information
This fictional school is used only for a tutorial. It contains no real customer data.
Start Sailing is a two-day course costing EUR 240. Day Skipper theory runs across five evenings and costs EUR 310. A private lesson lasts 90 minutes and costs EUR 95.
Courses run from April to October. Course dates are published on the school's website one month ahead. This source does not contain the next available date or live availability.
Bring a waterproof jacket, non-marking shoes and a change of clothes. The school provides buoyancy aids.
A trial-lesson request is an enquiry, not a confirmed booking. The office needs the person's name, preferred weekday and sailing experience, then confirms availability and price. Do not collect payment details. Do not infer a trial price from the private-lesson price.
Pengetahuan: kebijakan dan informasi anggota
Tempel ke kolom Content artikel kedua.
Saltmarsh Sailing School demonstration policies
If the forecast shows more than 25 knots of wind or thunderstorms, the session moves to the next available date at no extra cost. The instructor decides on the morning of the session. This source is a policy, not a live weather forecast or a cancellation decision.
Parking is free at the clubhouse. The gate code is sent to enrolled students the day before their course. The code itself is not in this Knowledge Base.
Refunds and complaints are handled by the office. An AI answer cannot approve a refund. A member of staff must decide each case.
The Telegram members' group is for general questions. Trial requests, refunds and other personal details belong in a private conversation with the school's Agent, opened from the school's direct-message link.
Aturan Human Handoff
Tempel di Human Handoff > Handoff Rules dan atur ketersediaan yang sebenarnya.
Transfer this private conversation to a person when the visitor has a current unresolved refund request, complaint, explicit request for a person, or accepts an offer of human help. After a staff member resolves the enquiry and returns it to AI, earlier refund or handoff messages must not trigger a new transfer for a general course question. Explain that a staff member can review the case here without approving a refund or promising a response time. This Agent is used only for private enquiries; the separate group Agent has Human Handoff disabled.
Pertanyaan umum
Bagaimana menambahkan chatbot AI ke grup Telegram?
Di Quickchat AI, buka External Apps, pilih Telegram, lalu Add to a Telegram group. Pilih grup di Telegram, kembali ke Quickchat AI, lalu Confirm. Anggota dapat bertanya dengan menyebut bot bersama atau membalas salah satu pesannya.
Apakah chatbot AI Telegram menjawab setiap pesan?
Bot bersama Quickchat AI menjawab pesan grup yang menyebut atau membalasnya. Obrolan grup biasa tidak memicu balasan. Bot Anda sendiri dapat menerima pesan biasa ketika mode privasi Telegram dinonaktifkan atau bot menjadi admin. Uji konfigurasi itu di grup terpisah.
Apakah saya memerlukan BotFather atau token bot Telegram?
Anda tidak memerlukan BotFather atau token untuk bot bersama dan tautan pesan pribadinya. Buat bot sendiri dengan BotFather jika membutuhkan nama dan foto Telegram khusus atau Action yang memanggil Telegram Bot API. Action Google Sheets biasa dapat bekerja dengan bot bersama.
Dapatkah pelanggan mengirim pesan pribadi ke chatbot Telegram?
Ya. Aktifkan Direct message link di Quickchat AI dan bagikan tautan lengkap yang dihasilkan. Pelanggan membukanya dan menekan Start jika diminta. Tautan memilih Agent Anda di dalam bot bersama. Menonaktifkannya mencegah koneksi baru; chat pribadi yang sudah ada memiliki kontrol aktif dan putus koneksi terpisah.
Apakah chatbot AI Telegram gratis?
Membuat bot dengan BotFather tidak otomatis menambahkan layanan AI. Quickchat AI menyediakan paket Free untuk belajar pribadi nonkomersial dengan jatah kredit AI terbatas. Penerapan komersial memerlukan paket berbayar. Balasan, Preview, dan Simulation memakai kredit AI; layanan eksternal dapat mengenakan biaya sendiri.
Apakah Telegram memiliki chatbot AI?
Telegram mendukung bot AI pihak ketiga dan integrasi AI. Tutorial ini menghubungkan Agent Quickchat AI yang menjawab dari pengetahuan bisnis Anda. BotFather membuat identitas bot; ia tidak menyediakan pengetahuan tersebut atau mengatur alur dukungan pelanggan.
Dapatkah chatbot memahami foto dan file?
Integrasi Telegram dapat menerima foto dan menganalisis konten visualnya. File lain dapat tiba sebagai lampiran percakapan, tetapi isinya tidak otomatis dibaca. Uji jenis file yang benar-benar digunakan pelanggan dan periksa Telegram serta Inbox.
Dapatkah saya membuat bot roleplay atau karakter Telegram?
Ya. Koneksi Telegram yang sama dapat melayani Agent dengan identitas karakter dan instruksi yang sesuai. Tutorial ini menggunakan contoh dukungan bisnis; Agent roleplay memerlukan prompt dan pengujiannya sendiri.