↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz

    Jak skonfigurować bota Telegram sklepu Elbuz CMS

    6 min czytaniaZaktualizowano

    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

    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.

    1. 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.
    2. Skopiuj token z odpowiedzi BotFather. Wygląda tak: 123456789:AAE….
    3. Otwórz ekran modułu: „Ustawienia sklepu” → sekcja „Integracje” → karta „Sklep w Telegramie”.
    4. W bloku „Bot” wklej „Token bota”, a w „Nazwa użytkownika bota” — adres bota bez @.
    5. Włącz przełącznik „Włączony” u góry ekranu i kliknij „Zapisz”.
    Sekcja „Integracje” ustawień sklepu z kartą „Sklep w Telegramie”
    1Karta „Sklep w Telegramie”
    2Ikona stanu karty
    1. „Sklep w Telegramie” — otwiera ustawienia bota sklepu.
    2. Ikona stanu pokazuje, czy bot jest skonfigurowany i czy ostatnie zmiany dotarły do sklepu.
    Blok „Bot” ekranu „Sklep w Telegramie” z polami tokenu, nazwy użytkownika i adresu Mini App
    1Token bota
    2Nazwa użytkownika bota
    3Adres Mini App
    4Karta stanu
    1. Token z @BotFather; po zapisaniu nie jest już pokazywany.
    2. Adres bota bez @.
    3. Adres sklepu, który wpisujesz w BotFather przy konfiguracji Mini App.
    4. 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”

    PoleCo robiDomyślnie
    Tekst przycisku menuNapis 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 AppKategoria bez podkategorii otwiera się jako podstrona sklepu ze zdjęciami. Wyłączone — produkty są pokazywane listą prosto w czaciewłączone
    Ukryj niedostępne produktyW katalogu bota są tylko produkty na stanie. Na stronę to nie wpływawłączone
    Adres Mini AppAdres 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

    1. W bloku „Powiadomienia” włącz „Włącz powiadomienia”.
    2. Pod przełącznikiem pojawią się „Szablony powiadomień”: otwórz właściwy status i wpisz tekst dla każdego języka sklepu.
    3. Kliknij „Zapisz”.
    Blok „Powiadomienia” z szablonami powiadomień według statusu zamówienia
    1Włącz powiadomienia
    2Nowe zamówienia dla menedżerów
    3Tekst wiadomości „Wysłane”
    4Status bez tekstu
    1. Klienci dostają wiadomość, gdy zmienia się status ich zamówienia.
    2. Nowe zamówienia z Telegrama trafiają do grupy menedżerów.
    3. Tekst wiadomości; zmienne są wypełniane danymi zamówienia.
    4. 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 /settings w 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.

    1. Utwórz w Telegramie grupę menedżerów i dodaj do niej bota.
    2. Sprawdź Chat ID grupy — liczbę ujemną zaczynającą się od -100, np. -1001234567890.
    3. 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.

    PoleCo robiDomyślnie
    Token dostawcy płatnościWydaje go @BotFather: /mybots → Twój bot → Payments. Dla płatności produkcyjnych i testowych tokeny są różne. Dla gwiazdek Telegram nie jest potrzebnypuste
    Waluta płatnościUAH, USD, EUR lub „Gwiazdki Telegram”. Kwota jest przeliczana z waluty głównej sklepu po kursieUAH
    Status zamówienia po płatnościStatus, który dostanie opłacone zamówienie„W realizacji”
    Wymagaj adresu dostawyKlient 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-mailTelegram poprosi o wypełnienie tych pól w oknie płatnościwyłą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.

    Blok „Użytkownicy bota” z osobami, które pisały do bota Telegram
    1Wyszukiwanie
    2Filtr powiadomień
    3Filtr konta
    4Powiązany klient sklepu
    5Powiadomienia wyłączone
    6Usuń
    1. Wyszukiwanie po imieniu, @username lub Telegram ID.
    2. Pokazuje, kto dostaje powiadomienia i wysyłki.
    3. Pokazuje, kto jest powiązany z kontem klienta w sklepie.
    4. Klient sklepu, z którym powiązany jest ten użytkownik Telegrama.
    5. Osoba wyłączyła powiadomienia lub zablokowała bota.
    6. Usuwa rekord osoby, historię czatu ze wsparciem i konto utworzone przez bota; zamówienia zostają.
    KolumnaCo pokazuje
    Imię / @usernameImię z Telegrama; pod nim @username lub Telegram ID
    KontoKlient 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 odData 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”.

    1. 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ą.
    2. Obrazek — adres https://… lub przycisk biblioteki obok pola. Opcjonalnie.
    3. Przycisk pod wiadomością — „Przycisk: tekst” i „Przycisk: adres”. Opcjonalnie, ale jeśli przycisk jest — potrzebne są oba pola.
    4. 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.
    5. Wyślij wszystkim (N) → potwierdź.
    Blok „Wysyłki” sklepu w Telegramie z tekstem wiadomości, polami przycisku, przyciskami testu i wysyłki oraz dziennikiem wysyłek
    1Licznik odbiorców
    2Pole tekstu
    3Wyślij test
    4Wyślij wszystkim
    1. Odbiorcy — ile osób dostanie wysyłkę: wszyscy z włączonymi powiadomieniami.
    2. Tekst — obsługuje pogrubienie, kursywę i linki, z obrazkiem do 1024 znaków.
    3. Wyślij test — najpierw wyślij wiadomość do siebie lub do grupy menedżerów.
    4. 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 widziszDlaczego tak jestCo 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

    Czy ten artykuł był pomocny?

    Brakuje funkcji? Napisz do nas.

    Dodamy ją za darmo, jeśli przyda się też innym.

    Jeśli potrzebujesz jej tylko ty — umówimy się osobno.

    Spis treści

    Zaproponuj usprawnienie

    Wypróbuj Elbuz za darmo