Baza wiedzy GetMyBot

Wiadomości i przyciski

Jak złożyć odpowiedź bota z tekstu, zdjęć, przycisków i pytań z zapisem odpowiedzi.

Na tej stronie

Jeśli bot ma wysłać tekst, zdjęcie i przycisk „Wybierz”, dodaj akcję Wyślij wiadomość. Odpowiedź składa się z osobnych części, czyli bloków. Możesz najpierw pokazać zdjęcie produktu, a potem opis z przyciskami. Przyciski umieszczone pod wiadomością nazywają się też przyciskami inline.

W tej samej akcji możesz zadać pytanie i zaczekać na odpowiedź, na przykład poprosić o numer telefonu i zapisać go w karcie klienta. Poniżej opisano bloki, przyciski i pytania.

Bloki wiadomości

Kliknij Dodaj blok i wybierz, co wysłać. Bloki można łączyć: powitanie tekstowe, zdjęcie i plik z programem zajęć.

  • Tekst: sformatowana treść do 4096 znaków, z podstawieniami i przyciskami.
  • Zdjęcie: obraz z podpisem.
  • Plik: dokument z podpisem.
  • Wiadomość głosowa: dźwięk OGG/OPUS, MP3 lub M4A, do 50 MB, który Telegram pokazuje jako wiadomość głosową (sendVoice).
  • GIF: animacja lub MP4 bez dźwięku, do 50 MB (sendAnimation).
  • Okrągłe wideo: kwadratowy plik MP4 do 60 sekund (sendVideoNote), bez podpisu. Plik z biblioteki mediów jest przesyłany na nowo przy każdej wysyłce. Telegram nie przyjmuje w sendVoice, sendAnimation ani sendVideoNote identyfikatora file_id uzyskanego innym sposobem.
  • Karuzela: od 2 do 10 kart „zdjęcie + podpis + własne przyciski”. W Telegramie można przewijać karty przyciskami „‹ ›” w jednej wiadomości przez editMessageMedia, jeśli każde zdjęcie ma odpowiedni file_id: wpisany w karcie albo uzyskany dla pliku z biblioteki mediów. Gdy choć dla jednego zdjęcia nie uda się uzyskać takiego ID, wszystkie karty są wysyłane jako osobne wiadomości ze zdjęciami. Tak samo dzieje się w innych kanałach, na przykład VK. Podpis i przyciski każdej karty zostają zachowane.
  • Opóźnienie: przerwa w sekundach przed następnym blokiem.
  • AI: odpowiedź wygenerowana przez model na podstawie promptu.
  • Reakcja: wywołanie innej reakcji, opcjonalnie z oczekiwaniem na jej zakończenie.

Wiadomości głosowe, GIF-y, okrągłe wideo i karuzele działają w reakcjach tak samo jak pozostałe bloki i mogą być wysłane w szybkiej wysyłce reakcji. Zobacz Wysyłki.

Bloki można przeciągać. Sposób pokazywania wybierasz między Po kolei a Losowo dla zróżnicowanych odpowiedzi. Główne menu bota można pozostawić bez zmian, ustawić na nowo albo ukryć.

Opcje bloku

Bloki tekstowe i multimedialne mogą mieć ustawienia: przypnij, bez dźwięku, ochrona przed przekazaniem, spoiler, bez podglądu linków i automatyczne usunięcie po N sekundach.

Przyciski inline

W bloku ustawiasz przyciski przez pola Tekst przycisku i Typ:

  • Tekst: wysyła napis jako odpowiedź użytkownika. W Telegramie i VK to klawiatura odpowiedzi: kliknięcie może odpowiedzieć na pytanie lub uruchomić reakcję na tekst. W WhatsAppie, Instagramie, Messengerze i widżecie webowym jest to przycisk odpowiedzi bez stałej klawiatury.
  • Link: otwiera URL.
  • Aplikacja internetowa: otwiera Telegram Mini App. Zobacz Mini App.
  • Wywołanie reakcji: kliknięcie uruchamia inną reakcję.
  • Inline query (zapytanie inline): wstawia „@bot zapytanie” w pole tekstowe bieżącego czatu lub pozwala wybrać inny czat (switch_inline_query / switch_inline_query_current_chat). Dostępne tylko w Telegramie po włączeniu trybu inline u @BotFather przez /setinline. GetMyBot nie odpowiada na te zapytania (answerInlineQuery nie jest zaimplementowane), więc przycisk przygotowuje tekst zapytania, ale nie wykonuje wyszukiwania.
  • Prefilled text (przygotowany tekst): link do https://t.me/<bot>?text=… otwiera czat z botem i wstawia tekst do pola, niczego nie wysyłając (prefill).
  • Payment link (link do płatności): otwiera wymagany URL płatności. Samą płatność tworzy akcja „Utwórz płatność”. To przejście do zewnętrznej strony, nie natywna faktura Telegrama.
  • Powiadomienie: pokazuje tekst po kliknięciu, nie uruchamia reakcji i nie przekazuje danych Carry. W Telegramie jest to krótkie powiadomienie lub okno do 200 znaków; w VK krótki pasek do 90 znaków, bez okna.

Tekst lub przygotowana wiadomość

ZadanieTyp i ustawienieCo robi kliknięcie
Wybrać „Tak” w ankiecie„Tekst”, napis „Tak”; wiadomość musi czekać na odpowiedźOdpowiedź „Tak” trafia do kroku dialogu
Przygotować pytanie„Przygotowany tekst”, napis „Napisz”, tekst „Chcę złożyć zamówienie”W polu czatu z botem pojawia się szkic; użytkownik może go zmienić i sam wysłać

Napis na przycisku i przygotowany tekst to dwa różne pola. Przygotowany tekst sam nie wysyła wiadomości ani nie uruchamia reakcji.

Kliknięcie Wywołania reakcji trafia do bota jako osobne zdarzenie, zwane technicznie callback. Zapytanie inline i Przygotowany tekst nie tworzą takiego zdarzenia: wykonują działanie w aplikacji Telegram, więc nie obsługują answerCallbackQuery ani przekazywania danych Carry.

Ikona i kolor przycisku

Przed tekstem przycisku można pokazać emoji premium. W polu ikony wpisz ID (icon_custom_emoji_id), dodatnią 64-bitową liczbę całkowitą. Na przykład 007 zostanie odczytane jako 7. Litery, zero, liczba ujemna lub zbyt duża są odrzucane, a przycisk zostanie zapisany bez ikony.

Telegram pokaże ikonę tylko botom z odpowiednim uprawnieniem: dodatkową nazwą przez Fragment lub Telegram Premium u właściciela, przy bezpośredniej wysyłce w rozmowie prywatnej albo grupie. W innych przypadkach Telegram pomija ikonę i nie zastępuje jej zwykłym emoji.

Styl nadaje kolor: „Zwykły” bez koloru, „Główny” niebieski, „Sukces” zielony, „Niebezpieczny” czerwony. Techniczne pole to style.

Jednorazowy (single_use) pozwala użyć zapisanych danych przycisku tylko raz. Nadaje się na przykład do potwierdzenia wyboru. Zmianę napisu i usunięcie wiadomości ustawia się osobno w zachowaniu po kliknięciu.

Ustawienia przycisków

Ustawienie przycisku można włączyć lub wyłączyć zaznaczeniem. W edytorze są:

  • Od nowego wiersza: przenosi przycisk do kolejnego rzędu.
  • Rozciągnij na całą szerokość: umieszcza przycisk w osobnym rzędzie; następny też zaczyna nowy rząd.

Przykład układu (nawiasy kwadratowe oznaczają przyciski):

Jeden rząd:          [Katalog] [Pomoc]

W nowym wierszu:     [Katalog]
                    [Pomoc]

Na całą szerokość:   [         Pomoc         ]

Rzędy i kolory są dostępne w Telegramie i VK. Układ rzędów zachowuje się po ponownym otwarciu i edycji. Emoji premium Telegrama wymagają zgodnego połączenia. Nie ma przełącznika „Otwórz w Telegramie”: Bot API nie pozwala sterować tym przez taką opcję.

Ograniczenia kanałów

Wybierz kanał dla bloku lub przycisku. Dla Wszystkich kanałów edytor udostępnia tylko wspólne możliwości. Nie można zapisać typu, którego wybrane kanały nie obsługują.

  • Telegram: URL, Mini App, reakcja, powiadomienie lub alert, rzędy, kolory i custom emoji, jeśli bot ma uprawnienia.
  • VK: URL, reakcja, snackbar, rzędy i kolory. VK Mini App i VK Pay są dostępne tylko po wybraniu zgodnego połączenia VK.
  • WhatsApp: jeden przycisk URL CTA bez innych przycisków w tej samej wiadomości. Do 3 zwykłych przycisków odpowiedzi; od 4 do 10 są pokazywane jako lista. Napis do 20 znaków. Brak rzędów, kolorów, Mini App i powiadomień.
  • Instagram / Messenger: obecny adapter przesyła tylko przyciski odpowiedzi (quick replies) z napisem do 20 znaków. Nie obsługuje URL, Mini App, powiadomień, rzędów ani kolorów.
  • Widżet webowy: URL i przyciski odpowiedzi, bez rzędów, kolorów i powiadomień.
  • Email: linki, w tym link do płatności; bez przycisków odpowiedzi i powiadomień.

Przy przyciskach tworzonych z listy liczba kolumn jest dostępna tylko w kanałach obsługujących rzędy. W innych układ wybiera sam kanał. Limity liczby przycisków i długości napisów są sprawdzane przy wysyłaniu.

Zachowanie po kliknięciu

Dla przycisków, które przekazują kliknięcie do bota, możesz zastąpić wiadomość tekstem albo treścią innej reakcji, usunąć wiadomość, nadać etykietę lub zapisać parametr, jeśli kanał obsługuje taką czynność. Zmiana napisu samego przycisku po kliknięciu działa tylko w Telegramie, na przykład z „Zapisz się” na „Wybrano”. VK obsługuje edycję wiadomości, ale nie zmianę napisu przycisku.

Telegram oczekuje od bota potwierdzenia kliknięcia przez answerCallbackQuery. Zwykle GetMyBot wysyła je sam i usuwa wskaźnik ładowania z przycisku. Opcja Pomiń answerCallbackQuery wyłącza to potwierdzenie.

W polu Text on press (notification) przycisku „Reakcja” możesz wpisać krótkie potwierdzenie, na przykład „Wybrano zajęcia” (do 200 znaków w Telegramie, do 90 w VK; podstawienia działają). Zwykle Telegram pokaże je na chwilę nad czatem. Show as a popup (alert) działa tylko w Telegramie i wyświetla okno potwierdzenia (answerCallbackQuery z show_alert). Przy pustym tekście bot tylko usuwa wskaźnik ładowania. Jeśli włączono Pomiń answerCallbackQuery, nie zostanie wysłany ani tekst, ani okno.

Dane przycisku (Carry)

Carry pozwala przyciskowi zapamiętać, czego dotyczy. Jeśli płaszcz i sukienka mają ten sam przycisk „Kup”, przy pierwszym zapisz product_id=101, a przy drugim product_id=102. Po kliknięciu sukienki kolejna reakcja otrzyma {{ctx.product_id}} o wartości 102.

W edytorze ta opcja to Dane po kliknięciu. Klucz jest nazwą wartości; sama wartość może być liczbą, tekstem lub podstawieniem. Bot zapamiętuje ją przy wysłaniu wiadomości, a po kliknięciu umieszcza w tymczasowym kontekście reakcji (ctx). Każdy przycisk ma własne wartości.

Czas ważności (ttl_seconds, TTL) podaje się w sekundach: 3600 to godzina. 0 wybiera wartość domyślną, 30 dni. Po upływie czasu dane są niedostępne. Jednorazowy (single_use) usuwa je po pierwszym kliknięciu. Zapisana cena nie zmienia się sama po aktualizacji katalogu: przed płatnością sprawdź aktualną cenę po ID produktu.

Instrukcja i porównanie z parametrami trwałymi: Dynamiczne przyciski i parametry.

Przyciski dynamiczne

Jeśli produkty lub zajęcia są już na liście, nie twórz przycisków ręcznie. Blok Dynamiczne przyciski z listy tworzy po jednym dla każdego elementu. Wskaż listę w ctx, nazwę jednego elementu (alias), liczbę przycisków w rzędzie i szablon napisu. {{item.name}} wstawi nazwę kolejnego produktu. Więcej w Dynamicznych przyciskach i parametrach.

Emoji premium w tekście

W bloku tekstowym przycisk formatowania Emoji premium wstawia <tg-emoji emoji-id="…">🙂</tg-emoji>. Odbiorcy z Telegram Premium zobaczą niestandardowe emoji, pozostali emoji zastępcze zapisane w tagu. Działa w bloku HTML i Markdown. ID emoji ma najwyżej 32 cyfry; możesz je odczytać przez getCustomEmojiStickers albo przekazać odpowiednią wiadomość botowi, np. @idstickerbot.

Link t.me/<bot>?start=<parametr> uruchamia w Telegramie komendę /start <parametr>. Nie da się takim linkiem otworzyć czatu z parametrem bez komendy /start. Wybierz właściwy wariant:

  • Cichy /start: reakcja na Komenda /start z odpowiednią Etykietą w linku startowym może mieć akcję „Wyślij wiadomość” bez bloków. Samo /start nie da widocznej odpowiedzi, ale oznaczenie linku jest dostępne w kontekście zdarzenia i można go używać w warunkach oraz innych akcjach tej reakcji.
  • Prefilled text (przygotowany tekst): link https://t.me/<bot>?text=<tekst>, z przycisku „Przygotowany tekst” albo zwykłego linku, otwiera czat i wstawia tekst do pola. Niczego nie wysyła, nie uruchamia /start; wiadomość wysyła sam użytkownik.
  • Automatyczna wiadomość w imieniu użytkownika po otwarciu linku jest niemożliwa przez Bot API: bot nie może wysłać wiadomości jako użytkownik. Najbliższa alternatywa to deep link ?start= i reakcja, w której bot sam odpowie odpowiednim tekstem.

Oczekiwana odpowiedź (kroki dialogu)

Blok tekstowy może czekać na odpowiedź użytkownika. Wiadomość staje się wtedy krokiem dialogu i zatrzymuje scenariusz do czasu odpowiedzi. Kilka takich kroków tworzy ankietę lub kreator w samym czacie.

Typ oczekiwanej treści

Bot może oczekiwać określonego rodzaju odpowiedzi: tekstu, wyboru z opcji (przyciski), zdjęcia, wideo, okrągłego wideo, audio, dokumentu, wiadomości głosowej, lokalizacji, kontaktu, kalendarza albo kostki. Odpowiedź innego typu zostanie uznana za nieodpowiednią.

Sprawdzanie tekstu

Odpowiedź tekstową można sprawdzić jako telefon, email, link, datę, godzinę lub przez dopasowanie do formuły. Jeśli bot oczekuje telefonu, zwykły tekst nie przejdzie i bot pokaże błąd. Sprawdzenie formułą używa formuły rozszerzonej, która zwraca pusty tekst przy sukcesie, a przy odmowie opis błędu.

Zapisywanie odpowiedzi

Odpowiedź można zapisać w parametrze. Potem jest dostępna w podstawieniach jako {{param.klucz}} i w warunkach. W ten sposób dialog stopniowo zbiera profil klienta.

Błędy, przypomnienia i limit czasu

  • Komunikat błędu sprawdzania: co pokazać, jeśli odpowiedź nie przejdzie walidacji.
  • Przypomnienie: co wysłać, gdy użytkownik nie odpowiada.
  • Koniec oczekiwania po czasie: jak długo bot ma czekać. Po upływie czasu może uruchomić reakcję, na przykład delikatnie zakończyć ankietę. Ta reakcja pojawia się w powiązaniach jako „Limit czasu oczekiwania”, a reakcja na samą odpowiedź jako „Oczekiwana odpowiedź”.

Wyjście z kroku komendą

/cancel lub rosyjskie słowo „отмена” kończą oczekiwanie i odpowiadają „Отменено.” albo uruchamiają reakcję anulowania, jeśli ją ustawiono. Pozostałe komendy są domyślnie traktowane jak odpowiedź i przechodzą tę samą kontrolę co inny tekst. Dzięki temu krok może zatrzymać użytkownika do odpowiedzi. Jeśli włączysz Bot commands (e.g. /start) end the wait (escape_on_command), każda komenda, na przykład /start w środku ankiety, zakończy oczekiwanie bez komunikatu i wykona się normalnie.

Podstawienia

Przycisk Podstawienia wstawia zmienne: dane nadawcy ({{first_name}}, {{username}}, {{user_id}}), zdarzenia ({{text}}, {{chat_id}}, {{datetime}}) i parametry ({{param.klucz}}). Pełna lista i formuły są w Podstawieniach i formułach.

Przycisk menu bota

Akcja Menu button (przycisk menu) wybiera zwykłe menu bota, listę komend albo przycisk Mini App z tekstem i URL. Może działać w bieżącym czacie albo jako ogólne ustawienie bota. Możesz na przykład ustawić osobną Mini App tylko dla obecnego klienta. Dostępność zależy od kanału.

Co dalej