Bot Telegram do obsługi klienta: jak działa i jak go skonfigurować

Bota tworzysz, pisząc w Telegramie do @BotFather, który go rejestruje i wydaje Ci token uwierzytelniający. Twój kod używa tego tokenu do wywoływania Bot API przez HTTPS. Token jedynie uwierzytelnia Twój kod; nie daje botowi uprawnień do pisania do kogokolwiek.

Boty nie mogą rozpoczynać rozmów. Użytkownik musi najpierw napisać do bota lub dodać go do grupy. Każdy bot ma link w formacie t.me/ z nazwą użytkownika bota, który otwiera z nim czat, a gdy ktoś otworzy ten czat po raz pierwszy, widzi przycisk Start, który wysyła polecenie /start. Zapisz wtedy chat ID użytkownika: potrzebujesz go do wysłania każdej późniejszej wiadomości, np. aktualizacji zgłoszenia.

1. Klient klika Twój link t.me na stronie internetowej lub w e-mailu i naciska Start.
2. Bot wita go i pokazuje krótkie menu typowych tematów.
3. Proste pytania dostają odpowiedź od razu; w pozostałych sprawach bot zbiera informacje (numer zamówienia, opis, zrzuty ekranu).
4. Bot tworzy zgłoszenie w Twoim helpdesku i mówi klientowi, co będzie dalej.
5. Gdy konsultant odpowie w helpdesku, odpowiedź trafia z powrotem do tego samego czatu w Telegramie.

Bot API oferuje dwa wzajemnie wykluczające się sposoby odbierania aktualizacji: metodę getUpdates (long polling) i webhooki. Gdy webhook jest ustawiony, getUpdates nie zadziała. W obu przypadkach Telegram przechowuje nieodebrane aktualizacje nie dłużej niż 24 godziny, więc bot, który przez dobę jest offline, traci wiadomości.

Aby przełączyć się z webhooka z powrotem na polling, usuń webhook metodą deleteWebhook lub wywołując setWebhook z pustym URL. Obie metody przyjmują parametr drop_pending_updates, jeśli przy zmianie konfiguracji chcesz odrzucić zaległe aktualizacje z kolejki.

Boty obsługi klienta działają lepiej z przyciskami niż z dowolnym tekstem. Niestandardowe klawiatury odpowiedzi (custom reply keyboards) zastępują klawiaturę użytkownika gotowymi odpowiedziami, a naciśnięcie jednej z nich wysyła ten tekst na czat. Klawiatury inline dołączają przyciski do konkretnej wiadomości i po naciśnięciu niczego nie publikują na czacie. Przycisk inline może otworzyć URL lub wysłać do bota dane callback o rozmiarze 1–64 bajtów.

Dwa szczegóły często zaskakują twórców nowych botów. Po naciśnięciu przycisku callback aplikacje Telegrama pokazują wskaźnik postępu, dopóki Twój bot nie wywoła answerCallbackQuery, więc odpowiadaj na każdy callback, nawet bez tekstu. A w menu wieloetapowych edytuj istniejącą wiadomość, podmieniając przyciski, zamiast za każdym razem wysyłać nową; edycja działa dla wiadomości z klawiaturami inline.

Boty dodane do grup domyślnie działają w trybie prywatności. W tym trybie bot otrzymuje skierowane do niego polecenia, odpowiedzi na swoje wiadomości, wiadomości wysłane za jego pośrednictwem i wiadomości serwisowe, ale nie zwykłe rozmowy w grupie. Boty będące administratorami grupy otrzymują wszystkie wiadomości, a tryb prywatności możesz wyłączyć poleceniem /setprivacy w @BotFather, choć Telegram zaleca to tylko wtedy, gdy jest to absolutnie konieczne. Wiadomości w prywatnych czatach z botem zawsze do niego docierają.

FAQ Telegrama podaje te wartości jako przybliżone, więc zaimplementuj ponawianie prób przy błędach 429, zamiast polegać na dokładnych liczbach. W przypadku bota obsługi klienta mają one znaczenie głównie wtedy, gdy powiadamiasz wielu klientów naraz, np. o awarii. Przy long pollingu przekazuj też do getUpdates parametr offset: aktualizacje do tego ID są oznaczane jako potwierdzone i nie zostaną zwrócone ponownie.

Przy przekazaniu rozmowy od bota do człowieka typowy wzorzec polega na tym, że bot otwiera zgłoszenie i przesyła odpowiedzi konsultanta z powrotem na czat. Zendesk obsługuje Telegram jako kanał Sunshine Conversations w Agent Workspace, co wymaga planu Suite Professional lub wyższego. Wiadomości stają się zgłoszeniami, a odpowiedź konsultanta w Zendesku pojawia się w komunikatorze klienta.

Telegram Business to osobna opcja dla małych zespołów, które odpowiadają klientom z własnego konta w Telegramie. Właściciel konta może podłączyć naraz jednego bota biznesowego, wybrać, do których czatów ma on dostęp, i pozwolić mu przetwarzać wiadomości przychodzące oraz — jeśli ma na to uprawnienia — odpowiadać w imieniu właściciela.

TascaLab buduje boty obsługi klienta na Telegramie, które łączą się z narzędziami, których już używasz, takimi jak Zendesk, Freshdesk, Jira, Slack czy systemy wewnętrzne, przez API, webhooki oraz Make lub n8n. Starter Chat Bot (1550 zł) obejmuje jeden lub dwa kanały z FAQ i podstawowym zbieraniem informacji, co pasuje do połączenia Telegrama z widżetem na stronie internetowej. Każdy projekt obejmuje 30 dni wsparcia po uruchomieniu i podstawową dokumentację, a większość wdrożeń trwa 1–3 tygodnie. Możesz zacząć od bezpłatnej 30-minutowej rozmowy Health Check.