Chatbot AI na Telegramie: grupy i prywatne rozmowy bez kodu

Chatbot AI na Telegramie może odpowiadać na pytania na podstawie wiedzy Twojej firmy w grupie lub prywatnej rozmowie. Quickchat AI łączy AI Agenta z Telegramem przez wspólnego bota: dodajesz go do grupy, potwierdzasz połączenie w panelu, a członkowie mogą zadawać pytania, oznaczając bota. Ta ścieżka nie wymaga kodu ani tokenu z BotFather.

W tym poradniku tworzymy Saltmarsh Sailing School, fikcyjną szkołę żeglarską z grupą członków i prywatnymi zapytaniami. Dwa Agenty korzystają z tych samych informacji o szkole: Saltmarsh Group odpowiada na pytania publiczne, a Saltmarsh Sailing School obsługuje prywatne zgłoszenia na lekcje próbne i włącza człowieka w sprawach zwrotów. Zgłoszenie jest zapytaniem do biura, a nie potwierdzoną rezerwacją.

Dwa Agenty rozdzielają odpowiedzialność. Agent grupowy nie ma Action do przekazania rozmowy ani przyjmowania zgłoszeń; Agent prywatny obsługuje zapytania i odpowiedzi pracowników.

Przejdź poniższą ścieżkę. Rozszerzenie o Google Sheets jest opcjonalne; najpierw możesz ukończyć odpowiadanie i przekazywanie rozmów.

Pobierz pakiet Saltmarsh Telegram z dokładną wiedzą, Main Prompt, konfiguracją Action, kryteriami oceny i wiadomościami testowymi. To edytowalne pliki do poniższych kroków, a nie import Agenta jednym kliknięciem.

Pliki do uruchomienia, dokładne wiadomości testowe i zrzuty ekranu pozostają po angielsku, aby można było odtworzyć kroki i wyniki.

Czego potrzebujesz, aby utworzyć chatbota na Telegramie?

Potrzebujesz konta Quickchat AI, dwóch Agentów i konta Telegram z uprawnieniem do dodania bota do grupy testowej. Opcjonalny zapis zgłoszeń wymaga też konta Google, które może autoryzować Google Sheets.

1. Utwórz konto Quickchat AI i zweryfikuj e-mail, jeśli pojawi się taka prośba. Free służy do nauki osobistej i niekomercyjnej. Plany obowiązują osobno dla każdego Agenta, więc firma korzystająca z obu potrzebuje odpowiedniej oferty komercyjnej dla każdego. Preview i Simulation zużywają kredyty AI. Zobacz aktualne plany.
2. Utwórz grupę Telegram o nazwie Saltmarsh Members. Użyj grupy testowej, aby przed zaproszeniem klientów sprawdzić oznaczenia, brak odpowiedzi na zwykłe wiadomości i dalszą rozmowę.
3. Korzystaj z własnego konta Telegram podczas całego poradnika, również do wysyłania wiadomości odwiedzającego. Możesz jednocześnie obsługiwać Inbox w Quickchat AI. Przed zaproszeniem klientów poproś współpracownika o sprawdzenie działania z innego konta.
4. Rozpakuj pakiet. Zachowaj razem przykładowe fakty o szkole; przed wdrożeniem zastąp je własnymi zweryfikowanymi zasadami.

Zrzuty Quickchat App pokazują aplikację działającą lokalnie z fikcyjną konfiguracją Saltmarsh; przykładowe dane połączeń są oznaczone w podpisach. Zrzuty Telegrama i Google Sheets pokazują rzeczywiste odpowiedzi oraz zapisane zgłoszenie z połączonego środowiska demonstracyjnego. Osobiste dane kont zostały wycięte z kadru lub wyraźnie ukryte. Użyj końcowej listy, aby powtórzyć sprawdzenia z własną wiedzą i połączonymi kontami.

Krok 1: Jak nauczyć chatbota na Telegramie wiedzy o firmie?

Umieść fakty o firmie w Knowledge Base, a instrukcje działania w Main Prompt. Rozdzielenie tych ról ułatwia poprawienie odpowiedzi bez zmieniania zachowania Agenta.

Ceny i zasady to fakty źródłowe. Zwięzłość, niepewność i kierowanie rozmów to instrukcje.

Utwórz Agenta i dodaj wiedzę

1. Na nowym koncie wybierz Set up manually. Na istniejącym koncie najpierw wybierz Add new AI Agent, a następnie konfigurację ręczną.
2. Na stronie Identity wpisz Saltmarsh Group w Name your AI Agent. Wklej group-main-prompt.txt z pakietu do Describe what you want your agent to do.
3. Kontynuuj konfigurację bez podłączania aplikacji zewnętrznych. Ukończ etap wyboru planu; jeśli zaczynasz od konta do nauki, użyj Skip for now.
4. Otwórz Knowledge Base > Add Article. Wpisz Courses and trial enquiries w Create custom article, wybierz Create article, wklej saltmarsh-courses.txt do Content, a następnie kliknij Save.
5. Powtórz dla Weather, parking and personal enquiries, używając saltmarsh-policies.txt. Poczekaj, aż oba artykuły pokażą Ready.
6. Otwórz Actions & MCPs w Saltmarsh Group. Pozostaw Human Handoff wyłączone i nie dodawaj Action do zgłoszeń na lekcje próbne.
7. Wybierz Add new AI Agent i powtórz ręczną konfigurację dla Saltmarsh Sailing School, używając main-prompt.txt i tych samych dwóch plików wiedzy. Ten drugi Agent obsłuży prywatne rozmowy. Przed zmianą ustawień wybierz właściwego Agenta w przełączniku konta.

Dwa krótkie źródła jasno pokazują, jakie fakty zna Agent. Status Ready to punkt kontrolny przed testem wiedzy.

Celowo brakuje informacji o wypożyczaniu pianek. Poprawna odpowiedź mówi, że Agent nie może tego potwierdzić, zamiast wymyślać „tak” lub „nie”. Podobnie zasady pogodowe nie podają prognozy na dziś, a cena lekcji prywatnej nie określa ceny lekcji próbnej.

Ustaw Main Prompt i sprawdź odpowiedź

1. Otwórz Identity > Main Prompt w każdym Agencie i sprawdź odpowiedni prompt Saltmarsh. Prompt grupowy odpowiada na pytania ogólne i wskazuje przypięty w grupie link do prywatnej rozmowy; prompt prywatny zbiera zgłoszenia i używa Human Handoff.
2. Otwórz AI Preview i zapytaj How much is Start Sailing?. Sprawdź, czy odpowiedź podaje dwa dni i EUR 240.
3. Zapytaj Do you rent wetsuits?. Sprawdź, czy odpowiedź przyznaje, że brakuje tej informacji.

Prompt prywatnego Agenta określa przyjmowanie zgłoszeń i przekazywanie rozmów. Agent grupowy używa osobnego promptu i ma obie Actions wyłączone.

Dwa kadry z rzeczywistych ustawień Agenta grupowego. Może odpowiadać na pytania z wiedzy, ale nie ma Action do przyjmowania zgłoszeń ani przekazywania rozmów.

Dwa Agenty jasno wyznaczają kierowanie rozmów. Agent grupowy nie może przypadkiem uruchomić przekazania; Agent prywatny może przekazać prośbę o zwrot bez zatrzymywania grupy. Preview sprawdza fakty o szkole, a kolejne kroki weryfikują każde połączenie z Telegramem.

Krok 2: Jak dodać chatbota AI do grupy na Telegramie?

Otwórz External Apps > Telegram, dodaj wspólnego bota do grupy, a potem wróć do Quickchat AI i wybierz Confirm dla grupy. Agent pozostaje w niej cichy do momentu potwierdzenia.

Dołączenie do grupy Telegram i potwierdzenie w Quickchat AI to osobne kroki.

1. Wybierz Saltmarsh Group w przełączniku Agentów. Otwórz External Apps, wybierz Telegram i znajdź Quickchat AI bot.
2. Wybierz Add to a Telegram group. W Telegramie wybierz Saltmarsh Members i zatwierdź dodanie bota.
3. Wróć do Quickchat AI. W Waiting for your confirmation sprawdź nazwę grupy i informacje Added by.
4. Wybierz Confirm dla oczekiwanej grupy. Powinna trafić do Connected chats z włączonym przełącznikiem.
5. W Telegramie wpisz @ i wybierz bota z listy oznaczeń. Zapytaj How much is Start Sailing?. Nazwa użytkownika wspólnego bota to zwykle @QuickchatAI_bot; użyj rzeczywistej nazwy widocznej w Twojej grupie.
6. Odpowiedz bezpośrednio na tę odpowiedź: What should I bring?. Potem wyślij osobną wiadomość bez oznaczenia: Does anyone know the gate code?. Wspólny bot powinien odpowiedzieć na odpowiedź i przemilczeć zwykłą wiadomość.

Wybierz Saltmarsh Members w Telegramie, a potem wróć do Quickchat AI, aby potwierdzić połączenie.

Rzeczywisty lokalny interfejs z przygotowanymi danymi grupy testowej pokazuje położenie Confirm. Ilustruje kontrolkę, ale nie dowodzi dołączenia Telegrama do prawdziwej grupy.

Potwierdzona grupa otrzymała oczekiwaną odpowiedź o kursie. Oznacz bota jego rzeczywistą nazwą użytkownika.

Odpowiedź na wiadomość bota działa bez ponownego oznaczania. Bot wymienia dostarczone informacje o wyposażeniu.

Potwierdzenie ma znaczenie, ponieważ dane zaproszenia pojawiają się w grupie. Quickchat AI wymaga decyzji po stronie konta, zanim uzna grupę za miejsce docelowe Agenta. Nie potwierdzaj grupy, której nie rozpoznajesz. Dokumentacja połączenia z Telegramem opisuje tę samą granicę.

Dokończ potwierdzenie przed opuszczeniem konfiguracji. Jeśli bot opuści niepotwierdzoną grupę, wygeneruj nowy link przez Add to a Telegram group, dodaj go ponownie i od razu potwierdź oczekującą grupę w Quickchat AI. Dodanie bota przez wyszukiwarkę członków Telegrama nie zastępuje tej ścieżki połączenia.

Etykieta Admin pokazuje status bota w Telegramie. Nie jest wymagana do zwykłych odpowiedzi wspólnego bota. Nadanie mu roli administratora również nie zmienia zasady odpowiadania tylko na oznaczenia lub odpowiedzi.

Krok 3: Jak włączyć prywatne rozmowy w Telegramie?

Włącz Direct message link i udostępnij cały wygenerowany URL. Link wybiera Twojego Agenta we wspólnym bocie Telegrama, więc klienci mogą pytać prywatnie bez dodawania go do grupy.

Grupa to wspólna rozmowa. Dane osobiste i przekazanie do pracowników przenieś do prywatnych wiadomości.

1. Wybierz Saltmarsh Sailing School, prywatnego Agenta. Otwórz External Apps > Telegram i włącz Direct message link. Pozostaw jego połączenia grupowe puste.
2. Skopiuj wygenerowany link. Zachowaj parametr start=; sam link do wspólnego bota nie identyfikuje Twojego Agenta.
3. Otwórz go w Telegramie i naciśnij Start, jeśli pojawi się taka prośba.
4. Zapytaj How much is Start Sailing? bez oznaczania bota. Zweryfikuj odpowiedź szkoły i znajdź rozmowę w Inbox.
5. Przypnij link w wiadomości powitalnej grupy, aby użytkownicy znaleźli go przed udostępnieniem danych osobistych.

Użyj linku wygenerowanego dla własnego Agenta. Pokazana lokalna konfiguracja nie jest potwierdzeniem dostarczenia wiadomości w Telegramie.

Telegram dostarczył powitanie Saltmarsh po Start. Następnie sprawdź odpowiedź opartą na wiedzy; samo powitanie nie testuje wyszukiwania informacji.

Dwa kadry z tego samego ekranu Telegrama pokazują przypięte zaproszenie. Wartość start linku demonstracyjnego została pominięta; przypnij własny pełny wygenerowany link.

Prywatny czat ze wspólnym botem jest powiązany z jednym Agentem naraz. Otwarcie linku do prywatnej rozmowy innego Agenta może zmienić to powiązanie. Aby mieć własną tożsamość w Telegramie i osobny wątek bota, wybierz ścieżkę z własnym botem.

Wyłączenie Direct message link blokuje nowe połączenia przez ten link. Aby zatrzymać istniejący połączony czat, użyj jego przełącznika lub Disconnect. Traktuj link jako publiczny punkt wejścia, a nie ograniczenie dostępu do poufnej wiedzy.

Krok 4: Jak zapisać zgłoszenie na lekcję próbną w Google Sheets?

Integracja Google Sheets tworzy arkusz i Action dodającą wiersze. Dostosuj tę Action, aby zapisywała trzy wymagane pola zgłoszenia, a potem sprawdź rzeczywisty wiersz. Ten krok jest opcjonalny i działa ze wspólnym botem Telegrama.

Wynikiem jest zgłoszenie do obsługi przez człowieka. Nie rezerwuje miejsca ani nie ustala ceny lekcji próbnej.

Połącz Sheets i skonfiguruj jedną Action

1. W Saltmarsh Sailing School otwórz Actions & MCPs > Add Action > Google Sheets i wybierz Connect Google Sheets. Zaloguj się na właściwe konto Google i zatwierdź żądany dostęp.
2. Otwórz wygenerowany arkusz Quickchat Leads. Zachowaj nazwę karty Leads, ponieważ wskazuje ją wygenerowany URL Action.
3. Zastąp wiersz nagłówków kolejno: Name, Preferred weekday, Sailing experience, Conversation link, Channel.
4. Otwórz Actions & MCPs i edytuj wygenerowaną Action log_lead_to_google_sheet. Użyj konfiguracji poniżej. Zmieniaj parametry, treść żądania i nagłówki arkusza razem, aby ich pozycje się zgadzały.

API Action Name

Record trial-lesson request

What to ask the user first

Dla wszystkich trzech parametrów ustaw No default i usuń domyślne parametry e-maila i zapytania. Te trzy pola są jedynymi pytaniami w tej konfiguracji. Nazwa użytkownika Telegrama jest opcjonalna i nie nadaje się na niezawodne wymagane pole kontaktowe; zapisany link do rozmowy umożliwia pracownikom powrót do zgłoszenia.

Metoda i URL: zachowaj wygenerowany URL POST. Zawiera już identyfikator Twojego arkusza, kartę Leads i valueInputOption=RAW. Nie ma zastępczego identyfikatora arkusza do uzupełnienia.

Nagłówki: zachowaj konfigurację integracji.

W karcie Body sekcji API Endpoint użyj:

{"values":[["{{name}}","{{preferred_weekday}}","{{sailing_experience}}","{{conversation_url}}","{{conversation_channel}}"]]}

Użyj Add AI Data, aby wstawić elementy parametrów i zmiennych rozmowy w odpowiednich miejscach. Pierwsze trzy wartości pochodzą z rozmowy; ostatnie dwie dostarcza 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.

Otwórz Advanced settings > Run only when i dodaj telegram_chat_type equals private. Użyj samego klucza metadanych, bez metadata_ i nawiasów klamrowych. To zapobiega wykonaniu żądania HTTP dla wiadomości grupowej, nawet jeśli model podejmie taką próbę. Dokumentacja warunku uruchomienia wyjaśnia tę kontrolę.

Ustaw Response filter na $.updates.updatedRows, aby Action zwracała liczbę wierszy zamiast niepotrzebnej odpowiedzi dostawcy. Pozostaw Action włączoną.

Sam klucz to telegram_chat_type. Warunek jest sprawdzany przed wysłaniem żądania.

Lokalna konfiguracja zgłoszenia. Wygenerowany URL Sheets i autoryzacja OAuth muszą pochodzić z Twojego połączenia z Google.

Sprawdź wiersz, a potem niepełne zgłoszenie

Wyślij tę wiadomość przez prywatny link Agenta w Telegramie:

I am Alex Morgan. I want a trial on Tuesday. I am a beginner.

Sprawdź wszystkie trzy miejsca: odpowiedź opisuje zgłoszenie, karta Action w Inbox pokazuje podane wartości, a rzeczywista karta Leads zawiera pasujący wiersz. Ani uspokajająca odpowiedź, ani wysoki wynik Simulation nie dowodzą zapisu w Google Sheets.

Agent zapisał podane imię i nazwisko, preferowany wtorek oraz doświadczenie początkującego. Biuro nadal musi potwierdzić dostępność i dokładną cenę.

Dwa fragmenty tego samego zapisanego wiersza zapewniają czytelność wszystkich pięciu kolumn. Link do rozmowy związany z kontem jest ukryty; pozostałe cztery wartości nie zostały zmienione.

Rozpocznij osobny test od I would like a trial lesson. Agent powinien pytać o brakujące pola pojedynczo, zanim uruchomi Action. Spróbuj też How much is Start Sailing?; zwykłe pytanie o kurs nie może utworzyć wiersza. Prompt wymaga jednego zapisu na zgłoszenie, ale ta konfiguracja dopisywania nie jest idempotentnym systemem rezerwacji. Przed użyciem do bieżącej obsługi sprawdź duplikaty.

Krok 5: Jak przekazać rozmowę z Telegrama człowiekowi?

Skonfiguruj Human Handoff, a potem sprawdź przypisanie rozmowy w Inbox. Prompt mówiący, że biuro odpowie, sam nie przekazuje odpowiedzialności i nie wstrzymuje AI.

Punktem kontrolnym jest zmiana przypisania. Niech człowiek zakończy sprawę; ewentualny powrót do AI sprawdź osobno.

1. Wybierz Saltmarsh Sailing School, otwórz Actions & MCPs > Human Handoff i włącz tę funkcję. W Saltmarsh Group pozostaw ją wyłączoną.
2. W Handoff Rules wybierz +. Wpisz Private enquiries jako Rule Name, wklej handoff-rule.txt do Description i włącz State. Nowe wiersze zaczynają jako nieaktywne. Reguła obejmuje zwroty, skargi, prośby o człowieka i zaakceptowanie ludzkiej pomocy u tego prywatnego Agenta.
3. Wyczyść Keywords i wyłącz predefiniowane reguły dla tego przykładu, pozostawiając aktywną tylko własną regułę, a następnie zapisz. Izolację grupy zapewnia wyłączone Human Handoff w osobnym Agencie grupowym; własna reguła opisuje, kiedy Agent prywatny powinien przekazać rozmowę.
4. Ustaw Confirmation na I have passed this private conversation to the Saltmarsh office. A member of staff can reply here. Skonfiguruj Human Agents’ availability zgodnie z rzeczywistymi godzinami pracy zespołu i ustaw uczciwą wiadomość poza tymi godzinami.
5. Z prywatnego czatu Telegram wyślij I want a refund for last week. Can I speak to a person?.
6. Znajdź rozmowę w Inbox, sprawdź przypisanie, wybierz Assign to me i wyślij Hi, I’m Alex from the office. I’ll review your request. Sprawdź, czy wiadomość dotarła do Telegrama.
7. Wyślij kolejną wiadomość klienta, gdy rozmowa jest przypisana do człowieka. AI powinno milczeć. Pozwól operatorowi zakończyć sprawę i oznaczyć ją jako rozwiązaną w Inbox. Powrót do AI potraktuj jako osobny test.

State własnej reguły jest włączone. Predefiniowane wyzwalacze są wyłączone, więc pozostaje jedna reguła do sprawdzenia.

Rzeczywista prośba w Telegramie uruchomiła Handoff. Przypisanie w Inbox i wychodzącą odpowiedź operatora sprawdzono osobno.

W rzeczywistym teście rozmowa przeszła do Unassigned, gotowa do przejęcia przez człowieka. Operator wybrał Assign to me, wysłał odpowiedź biura, a Telegram ją przyjął. Powyższy zrzut pokazuje odpowiedź o przekazaniu, a nie późniejszą wiadomość operatora. Powtarzając test, sprawdź zarówno przypisanie, jak i dostarczenie.

Pozostaw sprawę u operatora do czasu jej rozwiązania. W naszym lokalnym teście zwrotu powrót do AI Agent umożliwił jedną odpowiedź, po której Handoff uruchomił się ponownie. Powrót do AI wymaga osobnego udanego testu dalszej rozmowy; nie należy do kryteriów ukończenia tego procesu. Poradnik przekazywania rozmowy człowiekowi szerzej opisuje obsadę i odpowiedzialność.

Krok 6: Jak przetestować całego chatbota na Telegramie?

Użyj Testing do powtarzalnych kontroli odpowiedzi, a potem osobno sprawdź rzeczywiste ścieżki Telegrama i skutki zewnętrzne. Model może odpowiadać poprawnie, choć połączenie grupy, zapis w arkuszu lub dostarczenie po przekazaniu nadal działa błędnie.

Sprawdź system odpowiedzialny za wynik: wiedzę dla faktów, logi Action dla żądań, Sheets dla wierszy i Telegram dla dostarczenia.

Uruchom powtarzalny zestaw testów odpowiedzi

1. Otwórz Testing, utwórz zestaw o nazwie Saltmarsh: knowledge checks i wybierz Paste messages.
2. Wklej simulation-messages.txt. Zachowaj osobne separatory --- między przypadkami.
3. Otwórz Evaluation criteria, wklej evaluation-criteria.txt z pakietu i zapisz.
4. Wybierz Run > Start Run, a następnie przejrzyj poszczególne odpowiedzi oraz oceny.

Zachowaj te same pytania, gdy zmieniasz jedną instrukcję, aby porównanie nadal miało sens.

Czytaj odpowiedzi, nie tylko ocenę. To lokalne testy wiedzy, a nie testy dostarczania w Telegramie.

Oceniający potrzebuje faktów o szkole, aby osądzić poprawność. Musi też wiedzieć, że transkrypt nie dowodzi istnienia wiersza w arkuszu, dostarczenia do Telegrama ani zmiany przypisania. Standardowa tekstowa Simulation nie dostarcza metadanych czatu Telegram, więc brak tych danych nie oznacza błędu warunku Action ograniczającego ją do prywatnych rozmów. Kontrole zależne od kanału przeprowadź w rzeczywistym prywatnym czacie.

Co zmieniły testy lokalne?

Pierwotny projekt używał jednego Agenta dla obu wejść. Lokalny test pokazał, że prośba o zwrot w grupie przekazywała wspólną rozmowę do Human Handoff. Rozdzieliliśmy Agentów i wyłączyliśmy zarówno Handoff, jak i Actions zbierające zgłoszenia u Agenta grupowego. Po powtórzeniu grupowych testów zwrotu i lekcji próbnej odpowiedzi kierowały do przypiętego prywatnego linku, a rozmowa pozostawała przypisana do AI. Dlatego krok 1 rozdziela te dwie rozmowy za pomocą konfiguracji oraz instrukcji.

Dziesięć końcowych lokalnych testów wiedzy otrzymało po 5/5 punktów, a obaj hostowani Agenci przeszli te same dziesięć przypadków. Te małe serie testów nie są oszacowaniem trafności w produkcji. Rzeczywista grupa odpowiedziała też na pytania o cenę kursu i wyposażenie, a następnie odmówiła potwierdzenia wypożyczania pianek. Zachowaj te przypadki brakujących faktów przy dostosowywaniu zestawu; same poprawne ceny nie sprawdzają powściągliwości Agenta.

Brak wiedzy prowadzi do odpowiedzi „nie mogę potwierdzić”. Osobna wiadomość o kodzie bramy nie jest skierowana do bota i na tym zrzucie nie widać odpowiedzi na nią.

Rzeczywiste prywatne zgłoszenie na lekcję próbną zakończyło się jednym udanym wywołaniem Action Google Sheets z wartościami Alex Morgan, Tuesday i beginner. Google zwróciło HTTP 200 i jeden zaktualizowany wiersz; zapisany wiersz zawierał też link do rozmowy oraz kanał telegram. Osobny test Action z metadanymi czatu grupowego nie wysłał żadnego żądania HTTP. Dostosowując warunek, sprawdź zarówno zaakceptowane prywatne zgłoszenie, jak i odrzucony kontekst grupowy.

Sprawdź kanał i jego skutki uboczne

Użyj pustego pliku test-matrix.csv z zestawu, aby zapisać własne obserwacje. Powyższe zrzuty pokazują zademonstrowane wyniki; tabela zawiera też sprawdzenia do wykonania z własną konfiguracją. Przy testowaniu ciszy zapisz czas oczekiwania i oddziel przejęcie przez człowieka od ewentualnego późniejszego powrotu do AI.

Gdy kontrola zawiedzie, zmień jedno właściwe ustawienie i powtórz tę samą wiadomość. Brakujący fakt popraw w Knowledge Base; przedwczesne wywołanie Action w jej opisie lub wymaganych parametrach; przy milczącej grupie najpierw sprawdź potwierdzenie i sposób adresowania. Zachowaj błędny wynik, aby poprawa była widoczna.

Kiedy utworzyć własnego bota przez BotFather?

Utwórz własnego bota Telegram, gdy potrzebujesz własnej nazwy i zdjęcia, Actions korzystających z Telegram Bot API lub grupy odbierającej zwykłe wiadomości. Wspólny bot wystarcza do opisanych wcześniej odpowiedzi grupowych i prywatnych.

Wybierz potrzebną tożsamość i zachowanie wobec wiadomości przed dodaniem drugiego bota.

1. Otwórz zweryfikowane konto BotFather w Telegramie i wyślij /newbot.
2. Wybierz nazwę wyświetlaną, a następnie dostępną nazwę użytkownika kończącą się na bot. BotFather zwróci token. Zachowaj go w tajemnicy.
3. Wybierz Saltmarsh Group, jeśli ten bot ma dołączyć do grupy. Używaj Saltmarsh Sailing School wyłącznie do rozmów prywatnych. W External Apps > Telegram otwórz Your own bot i wybierz Connect to Telegram.
4. Wklej token do Bot Token i ukończ połączenie. Sprawdź, czy Enable your own bot jest włączone.
5. Otwórz link bota w Telegramie i wyślij /start, a potem to samo pytanie o cenę kursu.
6. Jeśli chcesz otrzymywać zwykłe wiadomości grupowe, użyj /setprivacy w BotFather, wybierz bota i Disable, a potem usuń go z grupy testowej i dodaj ponownie. Bot z rolą administratora też odbiera zwykłe wiadomości. Dokumentacja trybu prywatności Telegrama wyjaśnia zasady dostarczania.

Token wklejaj tylko do Bot Token. Pole jest puste, aby nie publikować danych dostępowych.

Trzymaj wspólnego i własnego bota w osobnych grupach. Dwa boty w jednej grupie mogą generować podwójne odpowiedzi. Jeśli kolejnym zadaniem jest przypinanie ogłoszeń lub moderowanie członków, skorzystaj z osobnego poradnika zarządzania grupą Telegram, w tym z warunków Action ograniczających wykonanie do administratorów.

Czy ChatGPT lub Claude mogą pomóc skonfigurować chatbota na Telegramie?

Połączona aplikacja zarządzania kontem Quickchat AI może pomóc utworzyć Agenta, dodać wiedzę, skonfigurować obsługiwane ustawienia i uruchomić testy. Jeśli klient udostępnia konfigurację Telegrama, może włączyć Direct message link wspólnego bota. Wybór grupy i potwierdzenie w panelu nadal należą do właściciela. Niektórzy klienci wymagają panelu także do aktywacji prywatnego linku i ustawień Human Handoff, więc najpierw poproś asystenta o sprawdzenie dostępnych narzędzi.

Połącz wtyczkę Quickchat AI do ChatGPT lub konektor Claude, a następnie przekaż pliki pakietu z tym promptem:

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.

Dostępność narzędzi zależy od klienta i uprawnień konta. Zaloguj się zgodnie z dokumentacją konfiguracji zarządzania kontem. To łączy asystenta z Twoim kontem Quickchat AI; nie zamienia osobistej rozmowy ChatGPT lub Claude w hostowany backend bota Telegram.

Dlaczego chatbot na Telegramie nie odpowiada?

Zanim przepiszesz prompt, sprawdź połączenie i drogę wiadomości. Te objawy mają różne przyczyny.

Przed zaproszeniem klientów zastąp fikcyjne fakty, przejrzyj podział grupy i rozmów prywatnych oraz zapewnij obsługę kolejki przekazań. W ramach końcowego sprawdzenia przed uruchomieniem poproś współpracownika o przetestowanie publicznych wejść z innego konta. Dla innego kanału społecznościowego poradnik chatbota Discord opisuje podobną ścieżkę tworzenia i testowania. Dla rozmów z postaciami wybierz poradnik odgrywania ról na Telegramie.

Opcjonalne kontrole konfiguracji: Porównaj metody wdrożenia według zadeklarowanych wymagań lub porównaj liczbę odpowiedzi dla budżetu kredytów na podstawie podanego budżetu. Te kalkulatory nie sprawdzają Twojego konta, strony ani salda.

Konfiguracja Saltmarsh do skopiowania

To kompletne fakty źródłowe i instrukcje użyte w poradniku. Pakiet do pobrania zawiera też konfigurację Action, kryteria oceny i testy.

Agent grupowy: Main Prompt

Wklej to do Identity > Main Prompt w Saltmarsh Group. Pozostaw Human Handoff i własne Actions wyłączone w tym Agencie.

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 prywatny: Main Prompt

Wklej to do Identity > Main Prompt w Saltmarsh Sailing School. Nazwa Action musi zgadzać się z konfiguracją.

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.

Wiedza: kursy i zgłoszenia na lekcje próbne

Wklej to w pole Content pierwszego artykułu wiedzy.

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.

Wiedza: zasady i informacje dla członków

Wklej to w pole Content drugiego artykułu.

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.

Reguła Human Handoff

Wklej to w Human Handoff > Handoff Rules i skonfiguruj rzeczywistą dostępność.

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.

Najczęściej zadawane pytania

Jak dodać chatbota AI do grupy na Telegramie?

W Quickchat AI otwórz External Apps, wybierz Telegram i Add to a Telegram group. Wybierz grupę w Telegramie, wróć do Quickchat AI i użyj Confirm. Członkowie mogą zadawać pytania, oznaczając wspólnego bota lub odpowiadając na jedną z jego wiadomości.

Czy chatbot AI na Telegramie odpowiada na każdą wiadomość?

Wspólny bot Quickchat AI odpowiada na wiadomości grupowe, które go oznaczają lub są odpowiedzią na jego wiadomość. Zwykła rozmowa w grupie nie wywołuje odpowiedzi. Własny bot może odbierać zwykłe wiadomości grupowe po wyłączeniu trybu prywatności Telegrama lub nadaniu mu roli administratora. Sprawdź taką konfigurację w osobnej grupie.

Czy potrzebuję BotFather lub tokenu bota Telegram?

Wspólny bot i jego link do prywatnych rozmów nie wymagają BotFather ani tokenu. Utwórz własnego bota przez BotFather, jeśli potrzebujesz własnej nazwy i zdjęcia Telegram albo Actions wywołujących Telegram Bot API. Zwykłe Actions Google Sheets mogą działać ze wspólnym botem.

Czy klienci mogą pisać do chatbota na Telegramie prywatnie?

Tak. Włącz Direct message link w Quickchat AI i udostępnij cały wygenerowany link. Klient otwiera go i w razie potrzeby naciska Start. Link wybiera Twojego Agenta we wspólnym bocie. Wyłączenie linku blokuje nowe połączenia; istniejące prywatne czaty mają osobne kontrolki włączania i rozłączania.

Czy chatbot AI na Telegramie jest darmowy?

Samo utworzenie bota przez BotFather nie dodaje usługi AI. Quickchat AI oferuje plan Free do osobistej, niekomercyjnej nauki z ograniczoną pulą kredytów AI. Wdrożenie komercyjne wymaga płatnego planu. Odpowiedzi, Preview i Simulation zużywają kredyty AI, a usługi zewnętrzne mogą mieć własne koszty.

Czy Telegram ma chatboty AI?

Telegram obsługuje boty AI i integracje AI firm trzecich. Ten poradnik łączy AI Agenta Quickchat AI, który odpowiada na podstawie wiedzy Twojej firmy. BotFather tworzy tożsamość bota; nie dostarcza tej wiedzy ani nie konfiguruje procesu obsługi klienta.

Czy chatbot rozumie zdjęcia i pliki?

Integracja Telegram może odbierać zdjęcia i analizować ich zawartość wizualną. Inne pliki mogą trafić do rozmowy jako załączniki, ale ich treść nie jest automatycznie odczytywana. Przetestuj rzeczywiste typy plików używane przez klientów i sprawdź zarówno Telegram, jak i Inbox.

Czy mogę utworzyć bota Telegram do odgrywania ról lub rozmów z postacią?

Tak. To samo połączenie z Telegramem może obsłużyć Agenta z tożsamością postaci i odpowiednimi instrukcjami. Ten poradnik używa przykładu obsługi biznesowej; Agent do odgrywania ról potrzebuje własnego promptu i testów.