Integracja z Telegramem

Integracja z Telegramem umożliwia chatbotom i agentom AI Botpress komunikację z użytkownikami na Telegramie za pośrednictwem oficjalnego Telegram Bot API. Zapewnia dwukierunkową komunikację w czasie rzeczywistym, obsługując wiadomości tekstowe, multimedia, przyciski oraz interaktywne komendy w czatach prywatnych i grupach.

W tle integracja korzysta z Telegraf—solidnego frameworka Node.js—do zarządzania przekazywaniem wiadomości, komendami i zdarzeniami z Telegrama. Wiadomości wysyłane przez Twojego agenta AI są automatycznie konwertowane z Markdown na obsługiwany przez Telegrama HTML, co gwarantuje prawidłowe wyświetlanie tekstu, linków i formatowania.

Dzięki wbudowanym narzędziom do oczyszczania wiadomości i wskaźnikom pisania, ta integracja zapewnia czystą, bezpieczną i responsywną komunikację dla użytkowników końcowych. Programiści mogą jej używać do automatyzacji powiadomień, obsługi zgłoszeń lub rozszerzania chatbotów na społeczności Telegrama przy minimalnej konfiguracji.

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.

FAQs

Czym jest integracja Botpress z Telegramem i jak działa?

Integracja Botpress z Telegramem łączy chatbota lub agenta AI Botpress z oficjalnym Telegram Bot API, dzięki czemu rozmowy mogą odbywać się bezpośrednio w czatach Telegrama. W tle integracja wykorzystuje SDK Botpress oraz framework Telegraf do odbierania aktualizacji z Telegrama i wysyłania odpowiedzi w czasie rzeczywistym. Otrzymywane wiadomości z Telegrama są przekształcane w zdarzenia Botpress, dzięki czemu agent może stosować polityki, pobierać wiedzę i realizować przepływy pracy tak samo jak na innych kanałach. Wychodzące wiadomości są konwertowane z wewnętrznego formatu Botpress na format zgodny z Telegramem, z obsługą tekstu, przycisków i multimediów tam, gdzie to możliwe. Po skonfigurowaniu tokena bota i adresu webhooka integracja obsługuje niskopoziomowe wywołania API i ponowienia, dzięki czemu zespoły mogą skupić się na projektowaniu rozmów, a nie na obsłudze żądań HTTP.

Jak wygląda pełna konfiguracja integracji z Telegramem w Botpress?

Konfiguracja integracji zaczyna się w samym Telegramie od utworzenia bota przez BotFather, co generuje token bota do dostępu do Telegram Bot API. W Botpress Studio instalujesz integrację Telegram z Hubu, a następnie konfigurujesz ją, podając ten token w ustawieniach integracji. Ekran konfiguracji udostępnia proste opcje, takie jak Włączone (przełącznik komunikacji), adres webhooka (gdzie Telegram wysyła aktualizacje) oraz pole na token autoryzujący integrację. Po zapisaniu Botpress rejestruje webhook i zaczyna nasłuchiwać nowych aktualizacji, dzięki czemu każda wiadomość wysłana do bota Telegram pojawia się jako zdarzenie rozmowy w projekcie Botpress. Od tego momentu przepływy, polityki i agenci AI działają na rozmowach Telegram dokładnie tak samo jak na webchacie czy innych kanałach, zapewniając spójną architekturę w całym środowisku.

Jakie funkcje i typy wiadomości obsługuje integracja Botpress z Telegramem dla chatbotów i agentów AI?

Integracja z Telegramem obsługuje standardowe wiadomości tekstowe oraz wiele zaawansowanych funkcji, z których znany jest Telegram, takich jak przyciski inline i załączniki multimedialne. Wiadomości generowane przez agenta AI Botpress są mapowane na typy wiadomości Telegrama, dzięki czemu mogą zawierać interaktywne przyciski, szybkie odpowiedzi i linki zgodne z zasadami formatowania Telegrama. Wskaźniki pisania są dostępne poprzez dedykowane karty integracji, pozwalając botowi sygnalizować, że przygotowuje odpowiedź i tworzyć bardziej naturalne doświadczenie rozmowy dla użytkowników. Integracja udostępnia także tagi na rozmowach i użytkownikach, takie jak identyfikator rozmowy czy użytkownika Telegram, co pozwala zaawansowanym twórcom powiązać tożsamości Telegrama z rekordami CRM lub systemami wewnętrznymi. Te możliwości sprawiają, że integracja Telegrama nadaje się do obsługi klienta, powiadomień proaktywnych (w ramach ograniczeń Telegrama), zarządzania społecznościami i automatycznego pozyskiwania informacji.

Jak integracja Botpress z Telegramem bezpiecznie obsługuje Markdown, HTML i formatowanie wiadomości?

Telegram obsługuje określone tryby formatowania, takie jak HTML i Markdown, ale rygorystycznie ogranicza dozwolone tagi i znaki. Aby zapewnić poprawne formatowanie treści, integracja wykorzystuje pipeline Markdown oparty na markdown-it do przekształcania treści Botpress w HTML zgodny z Telegramem oraz korzysta z sanitize-html do usuwania lub uciekania niebezpiecznych tagów i atrybutów przed wysłaniem. Dzięki temu nagłówki, pogrubienia, linki i listy wyświetlają się poprawnie, nie powodując błędów ani nie narażając użytkowników na niebezpieczny HTML. Dodatkowo integracja przestrzega ograniczeń Telegrama dotyczących mieszanej treści i długości wiadomości, dzieląc tekst i obrazy na kilka wiadomości, jeśli to konieczne, aby złożone treści od agenta AI były czytelne w kliencie Telegram. Dzięki temu zespoły mogą projektować bogate treści w Markdown w Botpress, a integracja automatycznie dba o wszystkie szczegóły formatowania specyficzne dla Telegrama.

Jakie są typowe zastosowania chatbota lub agenta AI Botpress na Telegramie?

Agent AI połączony z Telegramem jest zwykle wykorzystywany do obsługi klienta, angażowania społeczności lub komunikacji transakcyjnej w kanałach, gdzie Telegram ma już silną bazę użytkowników. Wiele zespołów używa tej integracji do zapewnienia natychmiastowego wsparcia samoobsługowego, automatyzacji FAQ i wstępnej selekcji zgłoszeń bezpośrednio w czatach Telegrama, ograniczając potrzebę korzystania z osobnych portali czy aplikacji mobilnych. Inni wykorzystują ją do wysyłania powiadomień o zamówieniach, informacji o koncie czy ogłoszeń produktowych do subskrybentów preferujących Telegram jako główny kanał komunikacji. Ponieważ Telegram obsługuje grupy i supergrupy, integracja sprawdza się także w moderowaniu społeczności, przekierowywaniu złożonych pytań do ludzi przez polityki Botpress oraz zbieraniu opinii od zaawansowanych użytkowników w czasie rzeczywistym. W połączeniu z funkcjami Botpress, takimi jak pobieranie wiedzy, polityki i obsługa przez człowieka, integracja z Telegramem staje się elastycznym punktem wejścia dla każdej organizacji, która chce wprowadzić swojego chatbota lub agenta AI do istniejącej społeczności Telegrama.

Utrzymywane przez

Zespół Botpress

tagi

Agent AI

Chatbot

Czat na żywo

Społecznościowe

SMS

Powiadomienia

Wiadomości

Telegram

FAQs

Odkryj popularne integracje