Telegram Integration | Botpress Hub

Pinapahintulutan ng Telegram integration ang mga chatbot at AI agent ng Botpress na makipag-usap sa mga user sa Telegram gamit ang opisyal na Telegram Bot API. Nagbibigay ito ng dalawang-daanang real-time na pagmemensahe, sumusuporta sa text, media, mga button, at interactive na utos sa loob ng mga pribadong chat o grupo.

Sa likod ng proseso, ginagamit ng integration ang Telegraf—isang matatag na Node.js framework—para pamahalaan ang pagruruta ng mga mensahe, utos, at kaganapan mula sa Telegram. Ang mga mensaheng ipinapadala ng iyong AI agent ay awtomatikong kino-convert mula Markdown papuntang HTML syntax na suportado ng Telegram, para siguradong tama ang pagkakaayos ng text, link, at format.

Dahil may kasamang mga gamit para sa paglilinis ng mensahe at typing indicator, tinitiyak ng integration na ito ang malinis, ligtas, at tumutugong karanasan sa komunikasyon para sa mga end user. Maaaring gamitin ito ng mga developer para mag-automate ng mga update, mag-asikaso ng mga ticket, o palawakin ang kanilang chatbot sa mga komunidad sa Telegram nang minimal ang setup.

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.

Mga Madalas Itanong

Ano ang Botpress Telegram integration at paano ito gumagana?

Ikinokonekta ng Botpress Telegram integration ang isang Botpress chatbot o AI agent sa opisyal na Telegram Bot API para ang mga usapan ay maganap mismo sa loob ng Telegram chat. Sa likod, ginagamit ng integration ang Botpress SDK kasama ang Telegraf framework para tumanggap ng mga update mula sa Telegram at magpadala ng tugon pabalik nang real time. Ang mga papasok na mensahe mula Telegram ay ginagawang Botpress events para magamit ng agent ang mga polisiya, pagkuha ng kaalaman, at mga workflow gaya ng sa ibang channel. Ang mga palabas na mensahe ay kino-convert mula sa internal na format ng Botpress papuntang Telegram-compatible na payload, kasama ang suporta para sa text, inline na button, at media kung kinakailangan. Kapag na-setup na gamit ang Bot Token at Webhook URL, ang integration na ang bahala sa mga mababang antas ng API call at retries, kaya makakapokus ang mga team sa pagdisenyo ng usapan, hindi sa pag-set up ng HTTP request.

Paano isinasagawa mula simula hanggang dulo ang setup ng Telegram integration sa Botpress?

Nagsisimula ang setup ng integration mismo sa Telegram sa pamamagitan ng paggawa ng bot gamit ang BotFather, na magbibigay ng Bot Token para sa pag-access sa Telegram Bot API. Sa Botpress Studio, ini-install ang Telegram integration mula sa Hub, at pagkatapos ay iko-configure gamit ang Bot Token na ito sa mga setting ng integration. Sa configuration screen, makikita ang mga simpleng opsyon gaya ng Enabled (para i-on o i-off ang komunikasyon), Webhook URL (kung saan ipinapadala ng Telegram ang mga update), at ang token field na nagbibigay ng awtorisasyon sa integration. Kapag na-save na, ire-rehistro ng Botpress ang webhook at magsisimula nang makinig sa mga bagong update kaya anumang mensaheng ipadala sa Telegram bot ay lalabas bilang conversation event sa Botpress project. Mula roon, ang mga flow, polisiya, at AI agent ay gagana sa Telegram chat gaya ng sa webchat o iba pang channel, kaya pare-pareho ang arkitektura sa buong sistema.

Anong mga tampok at uri ng mensahe ang sinusuportahan ng Telegram integration para sa mga chatbot at AI agent?

Sinusuportahan ng Telegram integration ang karaniwang text message pati na ang maraming tampok na kilala sa Telegram, gaya ng inline na button at media attachment. Ang mga mensaheng nililikha ng Botpress AI agent ay isinasalin sa mga uri ng mensahe ng Telegram kaya puwedeng maglaman ng interactive na button, quick reply–style na flow, at mga link na sumusunod sa format ng Telegram. May typing indicator din sa pamamagitan ng integration-specific na Card, kaya puwedeng ipakita ng bot na gumagawa ito ng sagot at mas natural ang chat para sa user. May mga tag din para sa usapan at user, gaya ng Telegram conversation ID o user ID, kaya puwedeng iugnay ng mga advanced na builder ang Telegram identity sa CRM record o internal na sistema. Dahil dito, ang Telegram integration ay bagay para sa customer support, abiso na proactive (ayon sa limitasyon ng Telegram), pamamahala ng komunidad, at automated na pagkuha ng impormasyon.

Paano pinapamahalaan ng Botpress Telegram integration ang Markdown, HTML, at pag-format ng mensahe nang ligtas?

May partikular na format na sinusuportahan ang Telegram gaya ng HTML at Markdown, ngunit mahigpit ito sa mga tag at karakter na pinapayagan. Para makapagpadala ng maayos na naka-format na nilalaman, gumagamit ang integration ng Markdown processing pipeline na nakabase sa markdown-it para gawing Telegram-compatible na HTML ang Botpress content, at umaasa sa sanitize-html para alisin o i-escape ang hindi ligtas na tag at attribute bago magpadala. Dahil dito, siguradong tama ang pagkaka-render ng heading, bold na text, link, at listahan nang hindi nasisira ang mensahe o nalalantad ang user sa hindi mapagkakatiwalaang HTML. Bukod pa rito, sinusunod ng integration ang mga limitasyon ng Telegram sa mixed content at haba ng mensahe, hinahati ang text at larawan sa magkakahiwalay na mensahe kung kinakailangan upang manatiling maayos ang pagpapakita ng masalimuot na nilalaman mula sa AI agent sa Telegram client. Sa ganitong paraan, puwedeng magdisenyo ng rich, Markdown-based na content sa Botpress habang ang integration na ang bahala sa mga Telegram-specific na formatting issue sa likod.

Ano ang mga karaniwang gamit ng pagpapatakbo ng Botpress chatbot o AI agent sa Telegram?

Karaniwang ginagamit ang AI agent na konektado sa Telegram para sa customer support, pakikipag-ugnayan sa komunidad, o transactional na mensahe sa mga channel na marami nang user sa Telegram. Maraming team ang gumagamit ng integration para magbigay ng instant na self-service support, automated na FAQ, at ticket triage direkta sa Telegram chat, kaya hindi na kailangan ng hiwalay na web portal o mobile app. Ginagamit din ito ng iba para magpadala ng update sa order, abiso sa account, o anunsyo ng produkto sa mga subscriber na mas gusto ang Telegram bilang pangunahing paraan ng komunikasyon. Dahil sinusuportahan ng Telegram ang mga grupo at supergroup, epektibo rin ang integration para sa pamamahala ng komunidad, pag-route ng komplikadong tanong sa human agent gamit ang Botpress policies, at pagkuha ng feedback mula sa mga power user nang real time. Kapag pinagsama sa mga tampok ng Botpress gaya ng knowledge retrieval, policies, at human-in-the-loop, nagiging flexible na entry point ang Telegram integration para sa anumang organisasyon na gustong dalhin ang chatbot o AI agent nito sa kasalukuyang audience ng Telegram.

Pinangangalagaan ng

Botpress Team

mga tag

AI Agent

Chatbot

Live chat

Panlipunan

SMS

Abiso

Pagmemensahe

Telegram

Mga Madalas Itanong

Tuklasin ang mga kilalang integrasyon