Integrasi Telegram | Botpress Hub

Integrasi Telegram memungkinkan chatbot dan agen AI Botpress berkomunikasi dengan pengguna di Telegram melalui API Bot Telegram resmi. Integrasi ini memungkinkan pesan dua arah secara real-time, mendukung teks, media, tombol, dan perintah interaktif dalam obrolan pribadi maupun grup.

Di balik layar, integrasi ini menggunakan Telegraf—sebuah framework Node.js yang andal—untuk mengelola pengiriman pesan, perintah, dan event dari Telegram. Pesan yang dikirim oleh agen AI Anda secara otomatis diformat dari Markdown ke sintaks HTML yang didukung Telegram, sehingga tampilan teks, tautan, dan format tetap sempurna.

Dengan utilitas bawaan untuk sanitasi pesan dan indikator sedang mengetik, integrasi ini memastikan komunikasi yang bersih, aman, dan responsif bagi pengguna akhir. Pengembang dapat menggunakannya untuk mengotomatisasi pembaruan, menangani tiket, atau memperluas chatbot mereka ke komunitas Telegram dengan pengaturan yang minimal.

The Telegram integration allows your AI-powered chatbot to seamlessly interact with Telegram, a popular messaging platform with a large user base. Connect your chatbot to Telegram and engage with your audience in real-time conversations. With this integration, you can automate customer support, provide personalized recommendations, send notifications, and handle inquiries directly within Telegram. Leverage Telegram's rich features, including text messages, inline buttons, media files, and more, to create dynamic and interactive chatbot experiences. Empower your chatbot to deliver exceptional user experiences on Telegram with the Telegram Integration for Botpress.

## Migrating from version `0.x.x` to `1.x.x`

### Removal of proactive conversations (and proactive users)

- Telegram does not currently support proactive conversations, so any bots using this feature will need to be updated to use the normal conversation flow.

### Removal of dedicated Markdown messages type

- The `markdown` channel message type is being deprecated in favor of integrating this behavior into the base `text` message type.
- This new Markdown behavior (commonmark spec) will allow image Markdown. However, since Telegram does not support mixed message types, it will split the message into multiple messages with images sent in between text messages.

### Addition of message limits

- Telegram has a message length limit of 4096 characters, so that limit has been added to the text parameter in the `text` message payload. Going over this limit will result in the message being rejected.

FAQ

Apa itu integrasi Telegram Botpress dan bagaimana cara kerjanya?

Integrasi Telegram Botpress menghubungkan chatbot atau agen AI Botpress ke API Bot Telegram resmi sehingga percakapan dapat berjalan langsung di dalam obrolan Telegram. Di balik layar, integrasi ini menggunakan Botpress SDK bersama framework Telegraf untuk menerima pembaruan dari Telegram dan mengirim respons secara real-time. Pesan masuk dari Telegram dinormalisasi menjadi event Botpress sehingga agen dapat menerapkan kebijakan, pengambilan pengetahuan, dan alur kerja seperti pada kanal lainnya. Pesan keluar diubah dari format pesan internal Botpress menjadi payload yang kompatibel dengan Telegram, termasuk dukungan untuk teks, tombol inline, dan media jika diperlukan. Setelah dikonfigurasi dengan Bot Token dan Webhook URL, integrasi ini menangani panggilan API tingkat rendah dan percobaan ulang, sehingga tim dapat fokus pada desain percakapan, bukan mengatur permintaan HTTP.

Bagaimana cara mengatur integrasi Telegram di Botpress dari awal hingga akhir?

Pengaturan integrasi dimulai di Telegram dengan membuat bot melalui BotFather, yang akan menghasilkan Bot Token untuk mengakses API Bot Telegram. Di Botpress Studio, integrasi Telegram diinstal dari Hub, lalu dikonfigurasi dengan Bot Token tersebut di pengaturan integrasi. Layar konfigurasi menyediakan opsi sederhana seperti Enabled (untuk mengaktifkan komunikasi), Webhook URL (tempat Telegram mengirim pembaruan), dan kolom token untuk otorisasi integrasi. Setelah disimpan, Botpress mendaftarkan webhook dan mulai mendengarkan pembaruan baru sehingga setiap pesan yang dikirim ke bot Telegram muncul sebagai event percakapan di proyek Botpress. Mulai saat itu, flow, kebijakan, dan agen AI berjalan di percakapan Telegram persis seperti di webchat atau kanal lain, memberikan arsitektur yang konsisten di seluruh sistem.

Fitur dan jenis pesan apa saja yang didukung integrasi Telegram untuk chatbot dan agen AI?

Integrasi Telegram mendukung pesan teks standar beserta banyak fitur kaya yang dikenal di Telegram, seperti tombol inline dan lampiran media. Pesan yang dihasilkan oleh agen AI Botpress dipetakan ke tipe pesan Telegram sehingga dapat mencakup tombol interaktif, flow gaya quick reply, dan tautan yang mengikuti aturan format Telegram. Indikator sedang mengetik tersedia melalui Card khusus integrasi, memungkinkan bot memberi sinyal bahwa ia sedang menulis respons dan menciptakan pengalaman chat yang lebih alami bagi pengguna. Integrasi ini juga menyediakan tag pada percakapan dan pengguna, seperti ID percakapan Telegram atau ID pengguna, sehingga pembuat tingkat lanjut dapat menghubungkan identitas Telegram dengan data CRM atau sistem internal. Dengan kemampuan ini, integrasi Telegram cocok untuk dukungan pelanggan, notifikasi proaktif (sesuai batasan Telegram), manajemen komunitas, dan skenario pengambilan informasi otomatis.

Bagaimana integrasi Telegram Botpress menangani Markdown, HTML, dan format pesan dengan aman?

Telegram mendukung mode format tertentu seperti HTML dan Markdown, namun sangat ketat terhadap tag dan karakter yang diizinkan. Untuk memastikan konten terformat dengan baik, integrasi ini menggunakan pipeline pemrosesan Markdown berbasis markdown-it untuk mengubah konten Botpress menjadi HTML yang kompatibel dengan Telegram, serta mengandalkan sanitize-html untuk menghapus atau mengamankan tag dan atribut yang tidak aman sebelum dikirim. Pendekatan ini memastikan heading, teks tebal, tautan, dan daftar tampil dengan benar tanpa merusak pesan atau mengekspos pengguna pada HTML yang tidak tepercaya. Selain itu, integrasi mengikuti batasan Telegram terkait konten campuran dan panjang pesan, membagi teks dan gambar menjadi beberapa pesan jika diperlukan sehingga konten kompleks dari agen AI tetap tampil rapi di klien Telegram. Dengan demikian, tim dapat merancang konten kaya berbasis Markdown di Botpress sementara integrasi menangani semua kasus format khusus Telegram di latar belakang.

Apa saja kasus penggunaan umum untuk menjalankan chatbot atau agen AI Botpress di Telegram?

Agen AI yang terhubung ke Telegram biasanya digunakan untuk dukungan pelanggan, keterlibatan komunitas, atau pesan transaksional di kanal dengan basis pengguna Telegram yang kuat. Banyak tim menggunakan integrasi ini untuk menyediakan dukungan mandiri instan, otomatisasi FAQ, dan triase tiket langsung di obrolan Telegram, sehingga mengurangi kebutuhan portal web atau aplikasi seluler terpisah. Ada juga yang mengandalkannya untuk mengirim pembaruan pesanan, notifikasi akun, atau pengumuman produk kepada pelanggan yang lebih memilih Telegram sebagai kanal komunikasi utama. Karena Telegram mendukung grup dan supergrup, integrasi ini juga efektif untuk moderasi komunitas, mengarahkan pertanyaan kompleks ke agen manusia melalui kebijakan Botpress, dan menangkap umpan balik dari pengguna aktif secara real-time. Dikombinasikan dengan fitur Botpress seperti pengambilan pengetahuan, kebijakan, dan human-in-the-loop, integrasi Telegram menjadi titik masuk fleksibel bagi organisasi yang ingin menghadirkan chatbot atau agen AI ke audiens Telegram yang sudah ada.

Dikelola oleh

Tim Botpress

tag

Agen AI

Chatbot

Obrolan langsung

Sosial

SMS

Notifikasi

Pesan

Telegram

FAQ

Jelajahi integrasi populer