Integrasi Telegram | Botpress Hub

Integrasi Telegram membolehkan chatbot dan ejen AI Botpress berkomunikasi dengan pengguna di Telegram melalui API Bot Telegram rasmi. Ia membolehkan pemesejan dua hala secara masa nyata, menyokong teks, media, butang, dan arahan interaktif dalam perbualan peribadi atau kumpulan.

Di belakang tabir, integrasi ini menggunakan Telegraf—sebuah rangka kerja Node.js yang kukuh—untuk mengurus penyaluran mesej, arahan, dan acara dari Telegram. Mesej yang dihantar oleh ejen AI anda akan diformat secara automatik daripada Markdown ke sintaks HTML yang disokong Telegram, memastikan paparan teks, pautan, dan pemformatan yang sempurna.

Dengan utiliti terbina untuk pembersihan mesej dan penunjuk menaip, integrasi ini memastikan pengalaman komunikasi yang bersih, selamat, dan responsif untuk pengguna akhir. Pembangun boleh menggunakannya untuk mengautomasikan kemas kini, mengurus tiket, atau memperluaskan chatbot mereka ke komuniti Telegram dengan tetapan yang minimum.

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.

Soalan Lazim

Apakah itu integrasi Telegram Botpress dan bagaimana ia berfungsi?

Integrasi Telegram Botpress menghubungkan chatbot atau ejen AI Botpress ke API Bot Telegram rasmi supaya perbualan boleh dijalankan secara asli dalam chat Telegram. Di belakang tabir, integrasi ini menggunakan SDK Botpress bersama rangka kerja Telegraf untuk menerima kemas kini dari Telegram dan menghantar respons secara masa nyata. Mesej masuk dari Telegram dinormalisasi menjadi acara Botpress supaya ejen boleh menggunakan polisi, pengambilan pengetahuan, dan aliran kerja seperti di saluran lain. Mesej keluar ditukar daripada format mesej dalaman Botpress ke muatan yang serasi dengan Telegram, termasuk sokongan untuk teks, butang sebaris, dan media jika sesuai. Setelah dikonfigurasi dengan Bot Token dan URL Webhook, integrasi ini mengurus panggilan API peringkat rendah dan percubaan semula, jadi pasukan boleh fokus pada mereka bentuk perbualan, bukan menyambungkan permintaan HTTP.

Bagaimana cara menyediakan integrasi Telegram dalam Botpress dari awal hingga akhir?

Penyediaan integrasi bermula di Telegram sendiri dengan mencipta bot melalui BotFather, yang akan menjana Bot Token untuk mengakses API Bot Telegram. Dalam Botpress Studio, integrasi Telegram dipasang dari Hub, kemudian dikonfigurasi dengan Bot Token ini dalam tetapan integrasi. Skrin konfigurasi memaparkan pilihan mudah seperti Enabled (untuk menghidupkan komunikasi), Webhook URL (tempat Telegram menghantar kemas kini), dan medan token yang membenarkan integrasi. Setelah disimpan, Botpress mendaftar webhook dan mula mendengar kemas kini baru supaya sebarang mesej yang dihantar ke bot Telegram akan muncul sebagai acara perbualan dalam projek Botpress. Mulai saat itu, aliran, polisi, dan ejen AI akan beroperasi pada perbualan Telegram sama seperti di webchat atau saluran lain, memberikan seni bina yang konsisten di seluruh sistem.

Ciri dan jenis mesej apa yang disokong oleh integrasi Telegram untuk chatbot dan ejen AI?

Integrasi Telegram menyokong mesej teks standard bersama banyak ciri kaya yang terkenal di Telegram, seperti butang sebaris dan lampiran media. Mesej yang dihasilkan oleh ejen AI Botpress dipetakan ke jenis mesej Telegram supaya ia boleh merangkumi butang interaktif, aliran gaya balasan pantas, dan pautan yang mengikut peraturan pemformatan Telegram. Penunjuk menaip tersedia melalui Kad khusus integrasi, membolehkan bot memberi isyarat bahawa ia sedang menaip respons dan mewujudkan pengalaman chat yang lebih semula jadi untuk pengguna akhir. Integrasi ini juga memaparkan tag pada perbualan dan pengguna, seperti ID perbualan Telegram atau ID pengguna, supaya pembangun lanjutan boleh memadankan identiti Telegram dengan rekod CRM atau sistem dalaman. Gabungan ciri-ciri ini menjadikan integrasi Telegram sesuai untuk sokongan pelanggan, pemberitahuan proaktif (mengikut had Telegram), pengurusan komuniti, dan senario pengambilan maklumat automatik.

Bagaimana integrasi Telegram Botpress mengendalikan Markdown, HTML, dan pemformatan mesej dengan selamat?

Telegram menyokong mod pemformatan tertentu seperti HTML dan Markdown, tetapi ia ketat mengenai tag dan aksara yang dibenarkan. Untuk memastikan kandungan diformat dengan betul, integrasi ini menggunakan saluran pemprosesan Markdown berasaskan markdown-it untuk menukar kandungan Botpress ke HTML yang serasi dengan Telegram, dan bergantung pada sanitize-html untuk membuang atau melarikan tag dan atribut yang tidak selamat sebelum dihantar. Pendekatan ini memastikan tajuk, teks tebal, pautan, dan senarai dipaparkan dengan betul tanpa merosakkan mesej atau mendedahkan pengguna kepada HTML yang tidak dipercayai. Selain itu, integrasi ini mematuhi had Telegram berkaitan kandungan bercampur dan panjang mesej, membahagikan teks dan imej kepada beberapa mesej jika perlu supaya kandungan kompleks dari ejen AI tetap kelihatan kemas dalam klien Telegram. Hasilnya, pasukan boleh mereka bentuk kandungan kaya berasaskan Markdown dalam Botpress sementara integrasi mengurus semua kes khas pemformatan khusus Telegram di belakang tabir.

Apakah kegunaan biasa untuk menjalankan chatbot atau ejen AI Botpress di Telegram?

Ejen AI yang disambungkan ke Telegram biasanya digunakan untuk sokongan pelanggan, penglibatan komuniti, atau pemesejan transaksi dalam saluran di mana Telegram sudah mempunyai pangkalan pengguna yang kukuh. Banyak pasukan menggunakan integrasi ini untuk menyediakan sokongan layan diri segera, automasi FAQ, dan pengurusan tiket terus dalam chat Telegram, mengurangkan keperluan untuk portal web atau aplikasi mudah alih yang berasingan. Ada juga yang menggunakannya untuk menghantar kemas kini pesanan, pemberitahuan akaun, atau pengumuman produk kepada pelanggan yang memilih Telegram sebagai saluran komunikasi utama. Oleh kerana Telegram menyokong kumpulan dan supergroup, integrasi ini juga berkesan untuk memoderasi komuniti, mengarahkan soalan kompleks kepada ejen manusia melalui polisi Botpress, dan mengumpul maklum balas daripada pengguna aktif secara masa nyata. Digabungkan dengan ciri Botpress seperti pengambilan pengetahuan, polisi, dan manusia dalam kitaran, integrasi Telegram menjadi pintu masuk yang fleksibel untuk mana-mana organisasi yang ingin membawa chatbot atau ejen AI mereka ke dalam audiens Telegram sedia ada.

Diselenggara oleh

Pasukan Botpress

tag

Agen AI

Chatbot

Sembang langsung

Sosial

SMS

Pemberitahuan

Pemesejan

Telegram

Soalan Lazim

Terokai integrasi popular