Baza wiedzy GetMyBot

Kanały: Telegram, WhatsApp, VK

Jak połączyć Telegram, WhatsApp i VK z jednym projektem. Różnice między kanałami i miejsce wysyłania odpowiedzi bota.

Na tej stronie

Jeden projekt GetMyBot może odpowiadać w Telegramie, WhatsAppie i VK. Na przykład tę samą regułę z planem zajęć można wykorzystać we wszystkich trzech komunikatorach. Odpowiedź trafi tam, skąd napisała dana osoba.

Po podłączeniu kolejnego komunikatora sprawdź przyciski i akcje: platformy mają różne możliwości. Poniżej opisano te różnice i sposób podłączenia kanału.

Czym jest kanał

Kanał to podłączone miejsce wymiany wiadomości: konkretny bot Telegram, numer WhatsApp Business lub społeczność VK. Jeden projekt GetMyBot może mieć kilka kanałów. Reakcje są wspólne: gdy użytkownik pisze przez WhatsApp, wiadomość trafia do tych samych reakcji co w Telegramie, a odpowiedź wraca przez WhatsApp.

Nie wszystkie komunikatory obsługują te same przyciski, formatowanie i akcje. Kreator może ukryć niedostępną opcję albo zamienić ją na obsługiwany odpowiednik. Przed uruchomieniem sprawdź wiadomości w każdym podłączonym kanale.

Kanał główny (primary_channel)

Każdy bot ma kanał główny (primary_channel), z którym jest kojarzony w pierwszej kolejności. Zwykle jest to Telegram, ale można od razu utworzyć bota dla WhatsAppa lub VK, bez Telegrama. Kanał główny jest określany przy tworzeniu bota i widoczny na liście; kolejne kanały można dodać później.

Możliwości poszczególnych kanałów

Poniżej opisano funkcje komunikatorów dostępne w każdym kanale. Aktualną tabelę w formacie do odczytu przez program zwraca API: GET /api/channels/capabilities.

Telegram: kanał wzorcowy z pełnym zestawem funkcji: przyciski inline i klawiatura odpowiedzi, callback (naciśnięcie przycisku uruchamiające reakcję), reakcje emoji, deep link /start, edycja, usuwanie i przekazywanie wiadomości, odpowiedź na wiadomość jako wyzwalacz, zdarzenia uczestników, uprawnienia i moderacja. Karty fotokaruzeli można przewijać przyciskami w jednej wiadomości. Formatowanie tekstu: Plain / HTML / Markdown. Nie ma szablonów wiadomości, list ani okna sesji, ponieważ nie są tam potrzebne.

WhatsApp (przez WhatsApp Cloud API): przyciski inline, callback, reakcje emoji, deep link /start, szablony wiadomości, listy (interactive list) i 24-godzinne okno sesji. Formatowanie: Plain / Markdown. Nie obsługuje klawiatury odpowiedzi, edycji, usuwania i przekazywania wiadomości, odpowiedzi jako wyzwalacza, zdarzeń uczestników, uprawnień, moderacji ani przewijania karuzeli w jednej wiadomości. Więcej informacji znajdziesz w WhatsAppie.

VK: wiadomości i załączniki, przyciski inline i klawiatura odpowiedzi, callback, reakcje emoji, deep link /start, edycja, usuwanie i przekazywanie wiadomości, zdarzenia uczestników, blokowanie i odblokowywanie, zatwierdzanie już złożonej prośby o dołączenie do zamkniętej społeczności oraz zdarzenia płatnych subskrypcji VK Donut. Formatowanie: tylko zwykły tekst, HTML i Markdown są usuwane przy wyświetlaniu. VK nie ma szablonów WhatsAppa, list, przewijania karuzeli w jednej wiadomości ani okna sesji.

We wszystkich kanałach są dostępne przyciski inline, callback, reakcje emoji i deep link /start. Blok fotokaruzeli działa w kanałach obsługujących zdjęcia. W Telegramie karty można przewijać w jednej wiadomości, jeśli wszystkie zdjęcia mają odpowiednie identyfikatory plików. W WhatsAppie i VK, a także w Telegramie bez takich identyfikatorów, karty są wysyłane jako oddzielne wiadomości ze zdjęciami. Zobacz Wiadomości i przyciski.

VK Donut

Jeśli społeczność korzysta z VK Donut, bot otrzymuje zdarzenia systemowe płatnej subskrypcji:

Zdarzenie w kreatorzeKluczDostępne zmienne
VK Donut: subscription created (nowa subskrypcja)donut_subscription_created{{event.donut_amount}}, {{event.donut_amount_without_fee}}
VK Donut: subscription prolonged (przedłużenie)donut_subscription_prolonged{{event.donut_amount}}, {{event.donut_amount_without_fee}}
VK Donut: subscription expired (koniec okresu)donut_subscription_expiredbrak
VK Donut: subscription cancelled (anulowanie)donut_subscription_cancelledbrak

{{event.donut_amount}} to kwota płatności, a {{event.donut_amount_without_fee}} to kwota bez prowizji VK. Zdarzenia końca okresu i anulowania nie zawierają kwoty: koniec opłaconego okresu nie jest nową płatnością, a pokazanie poprzedniej kwoty byłoby mylące.

To zdarzenie dotyczy subskrybenta, nie jest jego wiadomością. Nie udostępnia więc rozmowy do wysyłania prywatnych wiadomości, nie usuwa blokady, nie przesuwa czasu ostatniej aktywności i nie zwiększa liczby wiadomości. Obciążenie karty nie oznacza, że użytkownik napisał do bota. Jeśli platforma nie zna jeszcze subskrybenta, tworzy jego profil, aby można było zastosować etykiety i uprawnienia.

Przykład: klub dla subskrybentów.

  1. Utwórz reakcję na VK Donut: subscription created i taką samą na VK Donut: subscription prolonged. Dodaj akcję Zmień etykiety, która nadaje etykietę „Klub” na ttl_days = 31, oraz wiadomość z linkiem do zamkniętej społeczności i prośbą o zgłoszenie chęci dołączenia.
  2. Zatwierdź prośbę dopiero po jej złożeniu. Akcja Zmień uprawnienia → Zatwierdź prośbę o dołączenie przyjmuje już złożoną prośbę (groups.approveRequest). Bez prośby nie ma czego zatwierdzać. Umieść tę akcję w reakcji uruchamianej po kroku 1, na przykład po kliknięciu przycisku „Wysłałem prośbę” pod tą samą wiadomością albo przy kolejnym przedłużeniu.
  3. Na wyzwalacz Label expired (label_expired) dodaj akcję Zmień uprawnienia → Wyrzuć. Subskrybent opuszcza klub wraz z wygaśnięciem etykiety, niezależnie od tego, czy VK wyśle zdarzenie „subscription expired”. Zobacz Wyzwalacze → Wygaśnięcie etykiety.
  4. Przy VK Donut: subscription cancelled i VK Donut: subscription expired dodaj Zmień etykiety → usuń „Klub” oraz, jeśli trzeba, od razu Wyrzuć.

Pole Czat (chat_id) w akcjach dotyczących uprawnień VK musi zawierać ID podłączonej społeczności, ten sam numer, który widać przy kanale VK. VK może zarządzać uczestnikami tylko tej społeczności. Inny ID zostanie odrzucony przed wysłaniem żądania do VK. Jeśli chcesz zarządzać inną społecznością, podłącz ją jako osobny kanał.

Jak włączyć zdarzenia:

  • Long Poll: bot sam je subskrybuje przy podłączaniu kanału i każdym uruchomieniu platformy. Przy już podłączonych społecznościach nic nie trzeba zmieniać.
  • Callback API: w ustawieniach społeczności VK otwórz Работа с API → Callback API → Типы событий → VK Donut i włącz wszystkie cztery zdarzenia z tabeli.

Jak podłączyć kanał

Kanały dodaje się na stronie Projekty.

  1. Otwórz Projekty i znajdź właściwy projekt.
  2. Kliknij Dodaj kanał w karcie projektu.
  3. Wybierz Telegram, WhatsApp lub VK.
  4. Wpisz dane dostępu: token dla Telegrama, dane Meta dla WhatsAppa lub dane społeczności dla VK.
  5. Kliknij Sprawdź. Platforma sprawdzi dane w wybranym komunikatorze.
  6. Kliknij Podłącz.

Po podłączeniu WhatsAppa lub VK pojawia się adres webhooka (ikona 🔗). Trzeba go dodać na platformie zewnętrznej, w aplikacji Meta dla WhatsAppa lub w ustawieniach społeczności VK, aby zdarzenia przychodzące docierały do bota. Instrukcję dla WhatsAppa znajdziesz w Konfiguracji webhooka.

Co dalej

Dane dostępu do kanału

Telegram używa pełnego tokenu od BotFather. Dla VK potrzebne są token społeczności i jej numeryczny ID; dla Callback API także tajny ciąg i kod potwierdzający. Dla WhatsAppa podaj Phone Number ID, ID konta WhatsApp Business, token z dostępem do konta, Verify Token webhooka i App Secret aplikacji Meta.

Sprawdź dane przed podłączeniem. Po zmianie klucza zaktualizuj powiązane ustawienie u dostawcy: Verify Token potwierdza adres webhooka, a App Secret służy do weryfikacji podpisu zdarzeń przychodzących. Żaden z nich nie zastępuje tokenu dostępu do API.

Zdarzenia przychodzące i adresy webhooków

Dla VK Callback API dodaj adres pokazany przez MyBot w ustawieniach serwera społeczności i ustaw takie same wartości tajnego ciągu oraz kodu potwierdzającego. Long Poll nie wymaga adresu publicznego ani tych dwóch wartości. Dla WhatsAppa dodaj adres w aplikacji Meta, podaj taki sam Verify Token i zasubskrybuj potrzebne zdarzenia wiadomości. Same dane do wysyłania nie wystarczą do odbierania wiadomości.

Autoryzacja Instagramu i Messengera

Kreator podłączania otwiera autoryzację Meta. Zaloguj się na konto zarządzające właściwą stroną Facebooka lub profesjonalnym kontem na Instagramie, przyznaj wymagane uprawnienia i wybierz konta dla tego projektu. Kreator sprawdzi uprawnienia, subskrypcję webhooka i gotowość do wysyłania. Usuń wykryte problemy, zanim zaczniesz korzystać z kanału. W istniejącym połączeniu możesz ponownie przejrzeć wybrane konta.