WhatsApp

GetMyBot podłącza WhatsAppa przez WhatsApp Cloud API (Meta Graph API). Po podłączeniu bot przyjmuje wiadomości przychodzące z WhatsAppa i stosuje do nich Twoje reakcje, a operatorzy mogą prowadzić korespondencję w dialogach. Ogólny przegląd wielokanałowości — na stronie Kanały.

Podłączenie kanału WhatsApp

Do podłączenia potrzebnych jest pięć poświadczeń z Twojej aplikacji Meta (WhatsApp Cloud API). Wszystkie są wymagane:

  • Phone number ID — identyfikator numeru WhatsApp Business.
  • WABA ID — identyfikator WhatsApp Business Account.
  • Access token — token dostępu aplikacji Meta.
  • Verify token — dowolny ciąg znaków, który wymyślasz samodzielnie. Jest używany przy weryfikacji webhooka w Meta (patrz niżej).
  • App secret — sekret aplikacji Meta. Potrzebny do weryfikacji podpisu HMAC przychodzących webhooków (nagłówek X-Hub-Signature-256).

Kroki w interfejsie:

  1. Otwórz Boty → «Dodaj kanał» → WhatsApp.
  2. Wypełnij pięć pól powyżej oraz opcjonalnie nazwę kanału (nieobowiązkowo).
  3. Naciśnij «Sprawdź» — GetMyBot waliduje poświadczenia przez Meta.
  4. Naciśnij «Podłącz».

Konfiguracja webhooka w Meta

Po podłączeniu kanał otrzymuje Callback URL w postaci {adres}/ch/{channelID} (w interfejsie — ikona webhooka 🔗). Trzeba go wraz z Twoim Verify token wpisać w aplikacji Meta: WhatsApp → Configuration → Webhook.

Jak to działa:

  1. Meta wysyła na Callback URL żądanie weryfikacji i porównuje przekazany verify_token z Twoim Verify token. Przy zgodności webhook zostaje potwierdzony.
  2. Następnie Meta wysyła na ten adres zdarzenia (wiadomości przychodzące, statusy dostarczenia, werdykty moderacji szablonów).
  3. Każde żądanie przychodzące jest podpisane nagłówkiem X-Hub-Signature-256; GetMyBot weryfikuje podpis za pomocą App secret — dlatego to poświadczenie jest wymagane przy podłączeniu.

24-godzinne okno sesji

WhatsApp ogranicza korespondencję z inicjatywy bota: wiadomości swobodne można wysyłać użytkownikowi tylko w ciągu 24 godzin od jego ostatniej wiadomości przychodzącej. Każda nowa wiadomość przychodząca od użytkownika odnawia okno.

Poza 24-godzinnym oknem nie można wysłać wiadomości swobodnej — jedynym sposobem ponownego napisania do użytkownika (re-engage) jest zatwierdzony szablon wiadomości. Dlatego szablony to kluczowe narzędzie do wysyłek i przypomnień na WhatsAppie.

Szablony wiadomości

Szablon (message template) to wcześniej uzgodniona z Meta wiadomość, którą można wysłać poza oknem sesji. Zarządzanie szablonami — w interfejsie GetMyBot.

Gdzie zarządzać szablonami

Boty → przy kanale WhatsApp ikona «Szablony wiadomości» (📄) → dialog «Szablony kanału WhatsApp». W dialogu są przyciski:

  • «Utwórz szablon» — zbudować nowy szablon.
  • «Synchronizuj» — pobrać katalog szablonów z Meta (zaktualizować statusy i listę).

Kategorie szablonów

  • MARKETING (Marketing) — promocje, ogłoszenia, wysyłki.
  • UTILITY (Serwisowy) — powiadomienia o działaniach użytkownika (statusy zamówień, przypomnienia).
  • AUTHENTICATION (Uwierzytelnianie) — kody potwierdzające.

Pola szablonu

  • Nazwa — małe litery łacińskie, cyfry i _, do 512 znaków.
  • Język — locale Meta.
  • Kategoria — jedna z trzech powyżej.

Dla kategorii Marketing i Serwisowy dodatkowo:

  • Nagłówek — brak / tekst / obraz / wideo / dokument. Dla nagłówka multimedialnego ładuje się przykładowy plik.
  • Treść — obowiązkowa, do 1024 znaków. Zmienne oznacza się {{1}}, {{2}}, … ściśle po kolei od 1 do N, bez przeskoków.
  • Stopka — do 60 znaków.
  • Przyciski — do 10: szybka odpowiedź, link (do 2), telefon (1), kopiowanie kodu (1).
  • Dla każdej zmiennej {{n}} trzeba podać przykładową wartość — to wymóg Meta do moderacji.

Dla kategorii Uwierzytelnianie treść jest ustalona przez samą Meta; konfiguruje się: czas ważności kodu (1–90 minut), zalecenie bezpieczeństwa i tekst przycisku kopiowania kodu.

Moderacja

Przycisk «Utwórz» od razu wysyła szablon do moderacji Meta — nie ma osobnego kroku «wyślij do sprawdzenia». Werdykt przychodzi asynchronicznie (przez webhook), lista szablonów odświeża się automatycznie. Statusy:

  • PENDING (W trakcie sprawdzania)
  • APPROVED (Zatwierdzony)
  • REJECTED (Odrzucony) — z podaniem przyczyny
  • a także PAUSED, DISABLED, IN_APPEAL, PENDING_DELETION.

Edytować można szablony w statusach APPROVED, REJECTED, PAUSED. Nazwy i języka zmienić nie można; dla zatwierdzonych szablonów kategoria również jest zablokowana.

Użycie szablonu w reakcji

Wysłanie szablonu to akcja reakcji:

  1. W konstruktorze reakcji otwórz «Akcje» → «Dodaj akcję» → «Wyślij szablon WhatsApp».
  2. Akcja jest dostępna tylko wtedy, gdy bot ma podłączony kanał WhatsApp z obsługą szablonów.
  3. Wybiera się tylko zatwierdzony (APPROVED) szablon.
  4. Wypełnia się parametry: wartości zmiennych {{n}} w treści, nagłówek tekstowy, nagłówek multimedialny przez link, parametry przycisków URL. W parametrach można używać podstawień-zmiennych.

Rzeczywisty kanał wysyłki jest określany przez kanał zdarzenia: jeśli zdarzenie przyszło z WhatsAppa, szablon zostanie wysłany na WhatsAppa.

Dialogi i załączniki

Operator może odpowiadać w dialogu WhatsApp i wysyłać załączniki — obraz, wideo lub dokument — z uwzględnieniem 24-godzinnego okna (poza oknem swobodna korespondencja jest niedostępna). Przychodzące media od subskrybentów są pobierane przez proxy i wyświetlane w dialogu.

Taryfikacja

GetMyBot prowadzi ewidencję rozmów WhatsApp (conversations) według kategorii — marketing / utility / authentication / service. W obecnej wersji jest to tylko zapis na potrzeby obserwowalności (record-only): saldo za rozmowy nie jest pobierane.

Co dalej