Bot sklepu Elbuz CMS w Telegramie sam informuje klientów o statusie zamówienia, przekazuje ich pytania menedżerom i wysyła wiadomości do subskrybentów. Podłącza się go jednym tokenem z @BotFather. Odpowiedzi AI daje osobny chatbot w Telegramie, sprzedaż w komunikatorze — sklep w Telegramie.
Kiedy to się przyda:
- Klienci dzwonią, żeby zapytać, gdzie jest zamówienie — bot pisze do nich, gdy tylko zmienia się status.
- Nowe zamówienie z Telegrama trzeba zobaczyć od razu — bot wysyła je do grupy menedżerów.
- Chcesz ogłosić promocję — wysyłka z obrazkiem i przyciskiem trafia do wszystkich subskrybentów bota.
- Klient prosi o usunięcie swoich danych — jeden przycisk usuwa jego rekord i korespondencję.
Od czego zacząć: „Ustawienia sklepu” → „Integracje” → karta „Sklep w Telegramie” i token bota.
Co potrafi bot Telegram sklepu
- Powiadamiać klienta — wiadomość o każdym statusie zamówienia, z własnym tekstem dla każdego języka.
- Wysyłać nowe zamówienia menedżerom — do Twojej grupy w Telegramie, razem z produktami i kontaktem.
- Przekazywać pytania klientów — menedżer odpowiada z grupy, klient dostaje odpowiedź od bota.
- Przyjmować płatności w czacie — kartą przez dostawcę płatności lub gwiazdkami Telegram.
- Pokazywać, kto korzysta z bota — wyszukiwanie, filtrowanie i usuwanie danych na prośbę osoby.
- Robić wysyłki — tekst, obrazek i przycisk do wszystkich subskrybentów, z testem i dziennikiem.
Co klient widzi w samym bocie — katalog, koszyk, polecenia, sklep jako Mini App — w artykule „Sklep w Telegramie”.
Jak podłączyć bota
Potrzebne są bot w Telegramie i strona pod bezpiecznym adresem https://: na inne adresy Telegram nie wysyła wiadomości do bota.
- Utwórz bota. W Telegramie otwórz @BotFather, wyślij
/newbot, ustaw nazwę i adres bota alfabetem łacińskim z końcówkąbot, np.technodom_shop_bot. - Skopiuj token z odpowiedzi BotFather. Wygląda tak:
123456789:AAE…. - Otwórz ekran modułu: „Ustawienia sklepu” → sekcja „Integracje” → karta „Sklep w Telegramie”.
- W bloku „Bot” wklej „Token bota”, a w „Nazwa użytkownika bota” — adres bota bez
@. - Włącz przełącznik „Włączony” u góry ekranu i kliknij „Zapisz”.
1
Karta „Sklep w Telegramie”2
Ikona stanu karty- „Sklep w Telegramie” — otwiera ustawienia bota sklepu.
- Ikona stanu pokazuje, czy bot jest skonfigurowany i czy ostatnie zmiany dotarły do sklepu.
1
Token bota2
Nazwa użytkownika bota3
Adres Mini App4
Karta stanu- Token z @BotFather; po zapisaniu nie jest już pokazywany.
- Adres bota bez @.
- Adres sklepu, który wpisujesz w BotFather przy konfiguracji Mini App.
- Pokazuje, czy zmiany dotarły do sklepu, oraz stan bota i płatności.
W ciągu 5 minut po zapisaniu sklep sam podłączy bota w Telegramie: adres wiadomości, przycisk menu i menu poleceń. Nie trzeba nic klikać. Sprawdzenie — wyślij do bota /start.
Token to klucz do Twojego bota: kto go zna, pisze w imieniu sklepu. Po zapisaniu token nie jest pokazywany na ekranie, widać tylko, że jest ustawiony. Nowy token z BotFather po prostu wklej w miejsce starego i zapisz.
Bez tokenu włączony moduł się nie zapisze. Jak działają „Zapisz”, stany i pola tajne — w artykule „Ustawienia sklepu”.
Inne pola bloku „Bot”
| Pole | Co robi | Domyślnie |
|---|---|---|
| Tekst przycisku menu | Napis na przycisku po lewej od pola wpisywania w czacie, osobno dla każdego języka. Przycisk otwiera sklep wewnątrz Telegrama | „🛍 Sklep” |
| Otwieraj kategorie w Mini App | Kategoria bez podkategorii otwiera się jako podstrona sklepu ze zdjęciami. Wyłączone — produkty są pokazywane listą prosto w czacie | włączone |
| Ukryj niedostępne produkty | W katalogu bota są tylko produkty na stanie. Na stronę to nie wpływa | włączone |
| Adres Mini App | Adres Twojej strony dla BotFather, z przyciskiem „Kopiuj”. Nie trzeba go zmieniać | adres sklepu |
Link do produktu w Telegramie
Aby linki otwierały produkt, kategorię lub koszyk od razu w Telegramie, raz włącz Mini App w BotFather: /mybots → Twój bot → Bot Settings → Configure Mini App. Adres weź z pola „Adres Mini App”.
Linki wyglądają wtedy tak: https://t.me/technodom_shop_bot?startapp=product_42 — produkt 42. Dla kategorii — category_7, dla koszyka — cart.
Jak powiadamiać klienta o statusie zamówienia
- W bloku „Powiadomienia” włącz „Włącz powiadomienia”.
- Pod przełącznikiem pojawią się „Szablony powiadomień”: otwórz właściwy status i wpisz tekst dla każdego języka sklepu.
- Kliknij „Zapisz”.
1
Włącz powiadomienia2
Nowe zamówienia dla menedżerów3
Tekst wiadomości „Wysłane”4
Status bez tekstu- Klienci dostają wiadomość, gdy zmienia się status ich zamówienia.
- Nowe zamówienia z Telegrama trafiają do grupy menedżerów.
- Tekst wiadomości; zmienne są wypełniane danymi zamówienia.
- Pusty wiersz: dla tego statusu wiadomość nie jest wysyłana.
W „Szablonach powiadomień” jest wiersz na każdy status zamówienia sklepu. Dla statusów „Oczekujące”, „W realizacji”, „Wysłane”, „Zrealizowane” i „Anulowane” teksty są już wpisane. O statusie bez tekstu bot nie pisze.
Do tekstu wstawiane są dane zamówienia: {order_id} — numer, {customer_name} — imię klienta, {order_total} — kwota, {order_status} — nazwa statusu, {store_name} — nazwa sklepu. Przykład: Zamówienie #{order_id} wysłane! Kwota: {order_total}.
Kto dostanie wiadomość
- Klient, którego konto w sklepie jest powiązane z Telegramem: zamawiał przez bota lub sklep w Telegramie albo powiązał bota ze swoim kontem.
- Tylko jeśli nie wyłączył powiadomień poleceniem
/settingsw bocie. - W języku wybranym w bocie, a jeśli go nie ma — w języku jego Telegrama, o ile sklep go ma; jeśli nie — w języku sklepu. Dla języka bez tekstu bot bierze tekst angielski, potem tekst języka sklepu.
Wiadomość jest wysyłana, gdy zmienia się status zamówienia w sklepie. Do klientów, którzy kupowali tylko na stronie bez Telegrama, bot napisać nie może.
Jak dostawać zamówienia i pytania w grupie menedżerów
Bot pisze do jednej grupy w Telegramie: nowe zamówienia i pytania klientów.
- Utwórz w Telegramie grupę menedżerów i dodaj do niej bota.
- Sprawdź Chat ID grupy — liczbę ujemną zaczynającą się od
-100, np.-1001234567890. - W bloku „Wsparcie” wpisz go w „Identyfikator grupy menedżerów (Chat ID)” razem z minusem i zapisz.
Nowe zamówienia
Przełącznik „Nowe zamówienia dla menedżerów” w bloku „Powiadomienia” jest włączony od razu. Bot raz pisze do grupy numer zamówienia, produkty z ilością, kwotę, dostawę, płatność, imię, telefon, e-mail i Telegram klienta.
Tak przychodzą tylko zamówienia z bota i sklepu w Telegramie. Tekst jest w języku sklepu, niezależnie od języka klienta. Przełącznik włączony, a Chat ID nie ustawiono — po prawej na ekranie pojawi się „Powiadomienia menedżerów są włączone, ale nie podano Chat ID grupy”.
Pytania klientów
Klient klika w bocie „💬 Pomoc” lub /support i pisze pytanie — bot przekazuje je do grupy. Każdy tekst do bota, który nie jest poleceniem ani przyciskiem, też trafia do grupy.
Aby odpowiedzieć, menedżer klika „Odpowiedz” na przekazanej wiadomości. Bot wyśle odpowiedź klientowi. Zwykłej wiadomości w grupie klient nie dostanie.
„Tekst automatycznej odpowiedzi (dla każdego języka)” — co bot pisze na /support, np. „Napisz model telefonu — podpowiemy, co pasuje”. Puste pole — tekst standardowy.
Jak przyjmować płatności w czacie
Blok „Płatność w Telegramie” dodaje do koszyka bota przycisk „💳 Zapłać w Telegramie”: klient płaci w oknie Telegrama, nie wychodząc z czatu. Bez tokenu dostawcy w koszyku jest tylko „🌐 Zapłać na stronie”; wyjątek — płatność gwiazdkami.
| Pole | Co robi | Domyślnie |
|---|---|---|
| Token dostawcy płatności | Wydaje go @BotFather: /mybots → Twój bot → Payments. Dla płatności produkcyjnych i testowych tokeny są różne. Dla gwiazdek Telegram nie jest potrzebny | puste |
| Waluta płatności | UAH, USD, EUR lub „Gwiazdki Telegram”. Kwota jest przeliczana z waluty głównej sklepu po kursie | UAH |
| Status zamówienia po płatności | Status, który dostanie opłacone zamówienie | „W realizacji” |
| Wymagaj adresu dostawy | Klient wpisuje adres i wybiera dostawę w oknie płatności; cena dostawy jest doliczana do rachunku. Tylko gdy w koszyku jest produkt z dostawą | wyłączone |
| Wymagaj numeru telefonu, Wymagaj adresu e-mail | Telegram poprosi o wypełnienie tych pól w oknie płatności | wyłączone |
Jeśli wybranej waluty nie ma wśród walut sklepu, bot nie wysyła rachunku i proponuje zapłacić na stronie. Waluty i kursy ustawia się w oknie „Waluty i kursy”. Dla gwiazdek potrzebna jest tam waluta XTR; kwota rachunku w gwiazdkach to liczba całkowita, a o adres, telefon i e-mail Telegram nie pyta.
W oknie płatności Telegrama jest tylko adres, bez oddziałów i paczkomatów. Dostawę do oddziału klient wybiera przez „Zapłać na stronie”.
Jak zmienić teksty bota
Blok „Teksty bota” jest zwinięty: rozwiń go. Jest tam 58 wierszy — powitanie, przyciski menu, katalog, koszyk, zamówienia. Na szaro w polu widać tekst standardowy.
- Wpisz własny tekst dla właściwego języka. Puste pole — bot pisze tekst standardowy.
- Nie usuwaj oznaczeń technicznych ze znakiem %: w ich miejsce bot wstawia nazwę produktu, cenę, numer zamówienia.
- W przyciskach „Koszyk”, „Zamówienia”, „Pomoc” zostaw ikonę na początku — 🛒, 📦, 💬. Bot rozpoznaje te przyciski po ikonie.
Kto korzysta z bota
Blok „Użytkownicy bota” — wszyscy, którzy pisali do bota lub otwierali sklep w Telegramie, nowi na górze. Lista jest odczytywana ze sklepu za każdym razem, gdy otwierasz ekran; przycisk „Odśwież” — odczytać ponownie.
1
Wyszukiwanie2
Filtr powiadomień3
Filtr konta4
Powiązany klient sklepu5
Powiadomienia wyłączone6
Usuń- Wyszukiwanie po imieniu, @username lub Telegram ID.
- Pokazuje, kto dostaje powiadomienia i wysyłki.
- Pokazuje, kto jest powiązany z kontem klienta w sklepie.
- Klient sklepu, z którym powiązany jest ten użytkownik Telegrama.
- Osoba wyłączyła powiadomienia lub zablokowała bota.
- Usuwa rekord osoby, historię czatu ze wsparciem i konto utworzone przez bota; zamówienia zostają.
| Kolumna | Co pokazuje |
|---|---|
| Imię / @username | Imię z Telegrama; pod nim @username lub Telegram ID |
| Konto | Klient sklepu, z którym powiązany jest Telegram. Jeśli klient jest w Elbuz, imię jest linkiem do jego karty. „niepowiązany” — konta nie ma |
| Powiadomienia | „włączone” — osoba dostaje powiadomienia i wysyłki; „wyłączone” — wyłączyła je w /settings lub zablokowała bota |
| Z nami od | Data pierwszego kontaktu z botem |
Wyszukiwanie — po imieniu, @username lub początku Telegram ID. Filtry: „Powiadomienia włączone” lub „Wyłączone”, „Z kontem” lub „Bez konta”, okres pierwszego kontaktu. Na ekranie — po 100 osób, dalej „Pokaż więcej”.
Nie można wyłączyć powiadomień za kogoś: to wybór tej osoby w bocie.
Usunąć dane osoby
Ikona kosza w wierszu → „Usuń”.
Usuwane są rekord osoby w bocie, korespondencja ze wsparciem i konto utworzone przez bota. Zamówienia zostają, ale bez imienia i danych kontaktowych. Jeśli osoba znów napisze do bota, dostanie nowe puste konto.
Jeśli osoba sama powiązała bota ze swoim kontem na stronie, to konto nie jest usuwane. Jego dane usuwa się w karcie klienta przyciskiem „Usuń dane na stronie”.
Usunięcia nie da się cofnąć: korespondencja ze wsparciem zniknie na zawsze.
Jak zrobić wysyłkę w Telegramie
Wysyłka trafia do wszystkich, którzy mają włączone powiadomienia. Ile osób ją dostanie, widać u góry bloku „Wysyłki”: „Otrzyma: N”.
- Tekst. Można
<b>pogrubienie</b>,<i>kursywę</i>i<a href="https://…">link</a>. Do 4096 znaków, z obrazkiem — do 1024, tagi się nie liczą. - Obrazek — adres
https://…lub przycisk biblioteki obok pola. Opcjonalnie. - Przycisk pod wiadomością — „Przycisk: tekst” i „Przycisk: adres”. Opcjonalnie, ale jeśli przycisk jest — potrzebne są oba pola.
- Test. W „Test: Telegram ID lub ID grupy” — Twój Telegram ID lub Chat ID grupy menedżerów. Kliknij „Wyślij test” i sprawdź wiadomość w Telegramie.
- Wyślij wszystkim (N) → potwierdź.
1
Licznik odbiorców2
Pole tekstu3
Wyślij test4
Wyślij wszystkim- Odbiorcy — ile osób dostanie wysyłkę: wszyscy z włączonymi powiadomieniami.
- Tekst — obsługuje pogrubienie, kursywę i linki, z obrazkiem do 1024 znaków.
- Wyślij test — najpierw wyślij wiadomość do siebie lub do grupy menedżerów.
- Wyślij wszystkim — rozpoczętej wysyłki nie da się zatrzymać.
Test nie trafia do dziennika. Aby dotarł, najpierw sam napisz do bota /start, a w przypadku grupy — dodaj do niej bota. Jeśli w profilu Elbuz podano Twój Telegram ID do powiadomień, pole testu wypełni się nim samo.
Rozpoczętej wysyłki nie da się zatrzymać. Zawsze najpierw wysyłaj test.
Tej samej wysyłki — tego samego tekstu, obrazka i przycisku — sklep nie przyjmie drugi raz w ciągu 10 minut. Przypadkowe ponowne kliknięcie nie wyśle wiadomości do wszystkich dwa razy.
Jak przebiega wysyłka
Sklep wysyła wiadomości sam, porcjami co minutę: 1000 osób dostanie je w kilka minut. Elbuz można zamknąć, ale bot musi pozostać włączony: wyłączony bot nie wysyła wiadomości.
Postęp widać w „Dzienniku wysyłek”: ile przetworzono ze wszystkich, dostarczono, błędów i ile osób zablokowało bota. Dopóki stan to „W trakcie”, dziennik odświeża się sam.
Kto zablokował bota, dostaje oznaczenie „wyłączone” i nie dostaje kolejnych wysyłek. „Błędy” to wiadomości, których Telegram nie przyjął z innych powodów.
Scenariusze
AGD: status dostawy bez telefonów
Włącz „Włącz powiadomienia”. Dla statusu „Wysłane” wpisz: Zamówienie #{order_id} przekazano do dostawy. Kurier zadzwoni godzinę przed przyjazdem.
Klient, który zamawiał przez bota, dostaje wiadomość, gdy tylko menedżer zmieni status.
Odzież: menedżer widzi zamówienia i pytania o rozmiar
Utwórz grupę „Menedżerowie”, dodaj bota, wpisz Chat ID w blok „Wsparcie”. W automatycznej odpowiedzi: „Napisz swój wzrost i zwykły rozmiar — podpowiemy”.
Nowe zamówienia z Telegrama i pytania klientów trafiają do jednej grupy. Menedżer odpowiada przez „Odpowiedz”.
Wyprzedaż: wysyłka z przyciskiem
Tekst <b>Minus 25% na pralki z 2025 roku</b>, zdjęcie modelu z biblioteki, przycisk „Zobacz modele” z adresem kategorii. Test do siebie, potem „Wyślij wszystkim”.
Subskrybenci widzą zdjęcie i przycisk w czacie z botem. Podsumowanie — w dzienniku wysyłek.
Klient prosi o usunięcie swoich danych
W „Użytkownicy bota” znajdź osobę po @username i usuń. Zamówienia zostaną do celów ewidencji.
Co zrobić, gdy bot nie działa
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
Bot nie odpowiada na /start |
Moduł jest wyłączony, nie ma tokenu, nie minęło jeszcze 5 minut od zapisu albo strona nie działa na https:// |
Sprawdź „Włączony” i token, zapisz, poczekaj kilka minut. Nie pomogło — wsparcie Elbuz sprawdzi połączenie bota ze stroną |
| „Telegram nie przyjął wiadomości: …” | Nie wysłano do bota /start, bota nie ma w grupie albo ID jest błędny |
Napisz do bota /start lub dodaj go do grupy, sprawdź ID i wyślij test jeszcze raz |
| „W bocie nie ustawiono tokenu — ustaw go w bloku «Bot» i zapisz.” | Token nie został zapisany | Wklej token z @BotFather w blok „Bot” i kliknij „Zapisz” |
| Przycisku „Wyślij wszystkim (0)” nie da się kliknąć | Nikt jeszcze nie pisał do bota albo wszyscy wyłączyli powiadomienia | Daj klientom link do bota: wysyłka zadziała, gdy tylko ktoś napisze /start |
| „Taka sama wysyłka została właśnie utworzona…” | Tę samą wysyłkę uruchomiono mniej niż 10 minut temu | Sprawdź dziennik wysyłek — już trwa |
| Klient nie dostał powiadomienia o statusie | Bot lub powiadomienia są wyłączone, dla statusu nie ma tekstu albo klient nie kupował przez Telegram | Sprawdź „Włączony”, „Włącz powiadomienia”, tekst statusu i kolumnę „Powiadomienia” w „Użytkownicy bota” |
| „Moduł Telegram nie jest zainstalowany w sklepie lub jest nieaktualny.” | Sklep ma starą wersję modułu | Napisz do wsparcia Elbuz — moduł zostanie zaktualizowany |
Najczęstsze pytania
Czy można wysłać wiadomość tylko części subskrybentów?
Nie, wysyłka trafia do wszystkich, którzy mają włączone powiadomienia. Filtr w „Użytkownicy bota” tylko pokazuje osoby, na wysyłkę nie wpływa.
Czy można podłączyć dwa boty do jednego sklepu?
Nie, token jest jeden. Nowy token zastąpi stary, a sklep w ciągu kilku minut przełączy się na nowego bota.
Czy to ten sam bot, który wysyła mi powiadomienia Elbuz?
Nie. Bot sklepu pisze do klientów. Powiadomienia dla pracowników o zdarzeniach w Elbuz wysyła inny bot — zob. „Powiadomienia o zdarzeniach”.
Czy klient widzi, który menedżer mu odpowiedział?
Nie. Odpowiedź przychodzi w imieniu bota sklepu, prywatnych kont menedżerów klient nie widzi.
Skąd wziąć swój Telegram ID do testu?
Pokazują go boty takie jak @userinfobot. Napisz do takiego bota — odpowie Twoim ID.
Gdzie to jest i kto ma dostęp
- Menu
- „Słowniki” → „Operacje” → „Ustawienia sklepu” → „Integracje” → „Sklep w Telegramie”
- Uprawnienia
- okno „Ustawienia sklepu” w „Uprawnieniach grup”
- Przygotuj
- bot i token z @BotFather, strona na
https://, grupa menedżerów w Telegramie
Powiązane tematy
- Jeśli chcesz wiedzieć, co klient widzi w bocie — Sklep w Telegramie.
- Jeśli chcesz zrozumieć, jak działa okno ustawień — Ustawienia sklepu.
- Jeśli zamówienie z Telegrama już przyszło — Obsługa zamówień klienta.
- Jeśli korespondencję z klientami w Telegramie trzeba prowadzić w zgłoszeniach Elbuz — Boty wsparcia.
