Przewodnik po Mokapen

WhatsApp Business

Integracja WhatsApp Business łączy numer WhatsApp Business Twojej organizacji z Mokapen: możesz wysyłać, a — w przeciwieństwie do SMS — także odbierać wiadomości od swoich kontaktów, zarządzając rozmowami bezpośrednio z karty kontaktu lub ze zunifikowanej skrzynki Wiadomości wraz z SMS-ami i czatem.

Ważne: kanał wykorzystuje oficjalną platformę WhatsApp Business firmy Meta. Aby go połączyć, potrzebne są konto Meta Business i aplikacja Meta Developer ze skonfigurowanym produktem WhatsApp (zobacz sekcję Wymagania): nie jest to bezpośrednie połączenie z aplikacją WhatsApp używaną na Twoim prywatnym telefonie.

Ogólny przegląd integracji: Integracje.

Wymagania

• Plan Mokapen zawierający integrację WhatsApp Business (Premium — ikona medalu na stronie, jeśli funkcja nie jest dostępna w Twoim planie).
• Zweryfikowany portfel Meta Business.
• Aplikacja Meta Developer połączona z tym portfelem, ze skonfigurowanym produktem WhatsApp.
• Numer telefonu jeszcze niepodłączony do osobistego WhatsAppa, aplikacji WhatsApp Business ani innego dostawcy/usługi API WhatsApp Business. Jeśli numer jest już zarejestrowany gdzie indziej, należy go najpierw przenieść do konfiguracji Mokapen zgodnie z procesem migracji Meta: skontaktuj się z pomocą techniczną Mokapen, jeśli potrzebujesz pomocy w migracji.
• Kredyt dostępny w portfelu organizacji: każda wysłana wiadomość odlicza kredyt w zależności od kraju docelowego i kategorii wiadomości (zobacz sekcję Kredyt i cennik).

Łączenie konta WhatsApp Business

Połączenie odbywa się poprzez Embedded Signup Meta, czyli okno logowania Meta/Facebook, które prowadzi Cię przez wybór portfela Business, konta WhatsApp Business (WABA) i numeru do połączenia — to nie jest zwykły kod QR do zeskanowania.

1. Menu użytkownika → Integracje → WhatsApp Business.
2. Kliknij Połącz WhatsApp Business (wymagany odpowiedni plan Premium).
3. Zaloguj się swoim kontem Meta w otwierającym się oknie i wykonaj kroki przewodnika: wybierz portfel Business, konto WhatsApp Business i numer telefonu do połączenia.
4. Potwierdź: Mokapen otrzymuje niezbędne uprawnienia i automatycznie zapisuje się na powiadomienia (webhook) dla tego konta.

Jeśli podczas łączenia Meta zgłosi, że numer jest już u innego dostawcy API WhatsApp Business, wybierz proponowaną opcję migracji i potwierdź, że numer jest już w WhatsApp Business API; jeśli natomiast numer wciąż znajduje się w osobistej aplikacji WhatsApp, należy najpierw usunąć konto na tym telefonie i poczekać około 15 minut przed ponowną próbą. Jeśli weryfikacja dwuetapowa jest aktywna na tym numerze, należy ją wyłączyć przed połączeniem (w WhatsApp Manager lub u aktualnego dostawcy).

Aktywacja numeru

Po Embedded Signup numer musi zostać aktywowany, zanim będzie można wysyłać wiadomości:

1. Na stronie Integracje → WhatsApp Business kliknij Aktywuj numer.
2. Jeśli zostaniesz o to poproszony, poproś o kod weryfikacyjny przez SMS lub połączenie głosowe na podłączony numer i wprowadź go po otrzymaniu.
3. Wprowadź 6-cyfrowy PIN: jeśli weryfikacja dwuetapowa już istnieje na tym numerze, użyj istniejącego PIN-u; w przeciwnym razie staje się on nowym PIN-em, który Meta będzie wymagać w przyszłości do operacji na numerze.
4. Opcjonalnie: wybierz region lokalizacji danych. Po włączeniu można go zmienić tylko przez wyrejestrowanie i ponowną rejestrację numeru.
5. Potwierdź: jeśli wszystko jest w porządku, numer przechodzi w status aktywny i możesz zacząć korzystać z integracji.

Meta pozwala na maksymalnie 10 żądań rejestracji dla tego samego numeru telefonu w okresie 72 godzin: jeśli przekroczysz limit, poczekaj przed ponowną próbą. Jeśli PIN jest nieprawidłowy, sprawdź go w WhatsApp Manager lub zresetuj u poprzedniego dostawcy, jeśli właśnie przeniosłeś numer.

Kredyt i cennik

Wysyłanie wiadomości WhatsApp jest rozliczane na bieżąco: wykorzystuje ten sam portfel (przedpłacony kredyt) organizacji, który jest używany przez inne płatne za użycie funkcje Mokapen, takie jak SMS — nie jest to odrębny kredyt.

• Koszt za wiadomość zależy od kraju docelowego numeru i kategorii wiadomości (marketing, utility, authentication lub swobodna wiadomość konwersacyjna w oknie 24-godzinnym — zobacz kolejne sekcje).
• Strona Integracje → WhatsApp Business zawsze pokazuje dostępny kredyt organizacji, z bezpośrednim linkiem do doładowania portfela.
• Kredyt jest odliczany w momencie wysyłki, nie wcześniej.
• Jeśli kredytu nie wystarczy, wysyłka jest blokowana i Mokapen wyświetla ostrzeżenie — „Niewystarczające środki WhatsApp Business. Doładuj konto, aby wysyłać wiadomości." — z bezpośrednim linkiem do strony doładowania.

Doładowanie portfela jest widoczne dla Właściciela i członków z uprawnieniem do organizacji; sprawdź saldo przed kampaniami lub masowymi wysyłkami szablonów marketingowych.

Wysyłanie wiadomości ręcznie

Przycisk wysyłania WhatsApp jest dostępny na karcie kontaktu. Po kliknięciu ikony WhatsApp:

1. Wybierz numer telefonu kontaktu, do którego chcesz napisać (spośród tych na karcie).
2. Jeśli masz więcej niż jedno połączone konto WhatsApp Business, wybierz, które użyć.
3. Jeśli jesteś w oknie 24-godzinnym (kontakt napisał do Ciebie niedawno, zobacz kolejną sekcję), możesz napisać swobodną wiadomość jak w normalnym WhatsApp. Jeśli jesteś poza oknem lub to pierwszy kontakt, musisz wybrać zatwierdzony szablon Meta: tylko szablony ze statusem Zatwierdzony można wybrać z menu.
4. Jeśli szablon ma symbole zastępcze ({{1}}, {{2}}…), wypełnij wymagane wartości przed kontynuowaniem: bez wartości szablon pozostaje wyłączony.
5. Sprawdź podgląd wiadomości (wyświetlany jako bąbelek WhatsApp) i kliknij Wyślij. W przypadku sukcesu pojawia się potwierdzenie „Wiadomość WhatsApp Business została wysłana pomyślnie.", a wiadomość trafia do historii kontaktu.

Jeśli nie masz jeszcze aktywnej integracji WhatsApp Business, przycisk przekieruje Cię na stronę Integracje → WhatsApp Business, aby najpierw dokończyć połączenie.

Okno 24-godzinne

WhatsApp Business wymusza zasadę obowiązującą dla wszystkich firm na platformie, nie tylko dla Mokapen: możesz pisać dowolny tekst (bez szablonu) do kontaktu tylko w ciągu 24 godzin od ostatniej wiadomości, którą ten kontakt Ci wysłał — tzw. okno obsługi klienta.

• Jeśli kontakt do Ciebie napisze, okno się otwiera (lub odnawia) i przez 24 godziny możesz odpowiadać swobodnie tekstem lub załącznikami.
• Po upływie 24 godzin bez nowej przychodzącej wiadomości, lub jeśli nigdy nie otrzymałeś wiadomości z tego numeru, aby napisać do niego musisz użyć zatwierdzonego szablonu Meta (zobacz kolejną sekcję): tak zaczyna się lub kontynuuje rozmowę biznesową poza oknem.
• Jeśli próbujesz wysłać dowolny tekst poza oknem, wysyłka jest blokowana: wybierz odpowiedni szablon (zazwyczaj kategorii Utility) zamiast swobodnej wiadomości.

Szablony WhatsApp Business

Szablony wiadomości to formaty wcześniej zatwierdzone przez Metę, wymagane do rozpoczęcia rozmowy lub pisania poza oknem 24-godzinnym. Można je zarządzać w dwa sposoby:

• Synchronizacja szablonów już istniejących w Meta — ze strony Integracje → WhatsApp Business, użyj Synchronizuj szablony: Mokapen importuje szablony ze statusem Zatwierdzony, które nie są jeszcze połączone, dzięki czemu możesz od razu z nich korzystać w wysyłce ręcznej.
• Tworzenie lub edytowanie szablonów w Mokapen — w Ustawienia → Szablony, typ WhatsApp Business: tworzenie, edycja lub usunięcie odbywa się bezpośrednio w Meta poprzez połączoną aplikację, a status zatwierdzenia aktualizuje się automatycznie, gdy Meta go zgłosi.

Kilka ważnych zasad przy tworzeniu szablonu:

• Kategoria — Utility (transakcyjne aktualizacje oczekiwane przez użytkownika: status zamówienia, przypomnienia o wizytach, alerty konta), Marketing (promocje, oferty, newslettery: wymaga wyraźnej zgody odbiorcy na otrzymywanie wiadomości WhatsApp od Twojej firmy) lub Authentication (kody OTP lub weryfikacyjne, z dedykowanymi przyciskami). Kategoria musi odpowiadać rzeczywistej treści: błędna kategoryzacja może prowadzić do odrzucenia lub niższej oceny jakości.
• Struktura — opcjonalny nagłówek (tekst, obraz, wideo, dokument lub lokalizacja), wymagana treść, opcjonalny stopka, do 3 przycisków (szybka odpowiedź, link URL lub numer telefonu).
• Nazwa — tylko małe litery, cyfry i podkreślenia (np. potwierdzenie_zamowienia), unikalna dla konta i języka.
• Symbole zastępcze — użyj {{1}}, {{2}}, {{3}} po kolei i bez przerw; podaj przykładowe wartości podczas tworzenia.
• Limity znaków — treść maksymalnie 1024 znaki, tekstowy nagłówek i stopka maksymalnie 60 znaków każdy, etykieta przycisku maksymalnie 20 znaków, maksymalnie 3 przyciski na szablon.

Każdy szablon jest sprawdzany przez Metę przed użyciem: zatwierdzenie zajmuje zwykle kilka minut, czasem do 24 godzin. Odrzucony szablon pokazuje powód odrzucenia; niska ocena jakości lub zbyt wiele blokad/zgłoszeń od odbiorców mogą ograniczyć konto WhatsApp Business.

Historia, rozmowy i odbieranie

W przeciwieństwie do SMS, WhatsApp Business jest dwustronny: kontakt może napisać do Ciebie swobodnie i wiadomość naprawdę pojawia się jako nowa rozmowa w Mokapen.

• Karta kontaktu — w historii/linii czasu pojawiają się zarówno wysłane, jak i odebrane wiadomości, z podglądem tekstu.
• Skrzynka Wiadomości — wątki WhatsApp pojawiają się razem z SMS i czatem w tej samej zunifikowanej skrzynce, z wyszukiwaniem w tekście. W przeciwieństwie do SMS, dla WhatsApp Mokapen automatycznie aktualizuje status dostarczenia i odczytu (wysłano, dostarczono, odczytano), gdy Meta zgłasza zdarzenia.
• Kontakt może wysłać Ci tekst, zdjęcia, dokumenty, audio, wideo i naklejki, także w odpowiedzi na konkretną wiadomość: wszystko trafia do tego samego wątku w skrzynce Wiadomości.

Ograniczenia, o których warto wiedzieć

• Niedostępne w automatyzacjach — obecnie moduł Automatyzacje oferuje akcje Wyślij Email i Wyślij SMS, ale nie akcję WhatsApp Business: wysyłka jest możliwa tylko ręcznie z karty kontaktu.
• Dowolny tekst tylko w ciągu 24 godzin — poza oknem obsługi klienta zawsze wymagany jest szablon zatwierdzony przez Metę.
• Obecnie tylko jeden kanał na kontakcie — przycisk wysyłania jest dostępny w Kontaktach; w przypadku Firm lub innych kart wysyłka WhatsApp nie jest jeszcze udostępniona w interfejsie.
• Numer nie można udostępnić do innych zastosowań — numer połączony z Mokapen przez WhatsApp Business API nie może jednocześnie być aktywny w osobistej aplikacji WhatsApp lub u innego dostawcy API.
• Limit rejestracji — maksymalnie 10 prób aktywacji na numer co 72 godziny, wymuszony przez Metę, nie przez Mokapen.

Najczęstsze problemy

• Nie można zakończyć połączenia — sprawdź, czy masz zweryfikowany portfel Meta Business, połączoną aplikację Developer ze skonfigurowanym produktem WhatsApp, i spróbuj ponownie Embedded Signup.
• Numer wciąż w osobistej aplikacji WhatsApp — usuń konto WhatsApp dla tego numeru na telefonie, poczekaj około 15 minut i spróbuj ponownie połączenia.
• Numer już u innego dostawcy API — podczas łączenia wybierz opcję migracji i potwierdź ją; jeśli weryfikacja dwuetapowa jest aktywna na tym numerze, wyłącz ją najpierw w WhatsApp Manager lub u aktualnego dostawcy.
• Nieprawidłowy PIN weryfikacyjny — sprawdź 6-cyfrowy PIN weryfikacji dwuetapowej w WhatsApp Manager lub zresetuj go u poprzedniego dostawcy, jeśli właśnie przeniosłeś numer.
• WhatsApp jest połączony, ale zapis na webhook nie powiódł się — przychodzące wiadomości mogą się nie pojawiać: skontaktuj się z pomocą techniczną Mokapen, jeśli problem będzie się powtarzał po ponownej próbie połączenia.
• Dowolna wiadomość nie wysyła się — najprawdopodobniej jesteś poza oknem 24-godzinnym: wybierz zatwierdzony szablon zamiast dowolnego tekstu.
• Szablon odrzucony przez Metę — sprawdź wskazany powód odrzucenia: kategoria niezgodna z treścią, nieprawidłowo numerowane lub z przerwami symbole zastępcze, niedozwolona treść (spam, fałszywa pilność, dane wrażliwe) lub niezgodny format.
• Niewystarczające środki — doładuj portfel organizacji z linku na stronie Integracje → WhatsApp Business lub w sekcji Rozliczenia.

Odłączanie

Na stronie Integracje → WhatsApp Business kliknij Odłącz: otworzy się okno z sekcją Zachowaj.

• Pole wyboru Wiadomości i szablony jest domyślnie zaznaczone: pozostawiając je zaznaczonym, historia wiadomości i zsynchronizowane szablony pozostają widoczne w Mokapen nawet po odłączeniu.
• Jeśli odznaczysz je, Mokapen usuwa zsynchronizowane szablony, wątki i wiadomości WhatsApp powiązane z tą integracją, a także powiązane pliki multimedialne.

W każdym przypadku zawsze usuwane są połączenie z kontem Meta i zapis na webhook. Jeśli jesteś użytkownikiem, z którym integracja została udostępniona (nie właścicielem), odłączenie usuwa tylko Twój dostęp: integracja pozostaje aktywna dla organizacji. Aby potwierdzić, wpisz ODŁĄCZ w wymaganym polu.

Przypadki użycia

• Potwierdzenie zamówienia lub wizyty — używasz zatwierdzonego szablonu Utility, aby potwierdzić właśnie zamknięte zamówienie lub ustaloną wizytę: klient otrzymuje powiadomienie, nawet jeśli jeszcze do Ciebie nie napisał, bez czekania, aż otworzy e-mail.
• Obsługa klienta w czasie rzeczywistym — klient pisze do Ciebie na WhatsApp z pytaniem: wiadomość trafia na kartę kontaktu i do skrzynki Wiadomości, a w kolejnych 24 godzinach możesz odpowiadać dowolnym tekstem, zdjęciami lub dokumentami bez potrzeby szablonu.
• Aktualizacja statusu wysyłki — szablon Utility z symbolami zastępczymi dla numeru zamówienia i przewidywanej daty, wysyłany ręcznie z karty kontaktu, gdy zmienia się status wysyłki.
• Kod weryfikacyjny — szablon kategorii Authentication z dedykowanym przyciskiem OTP, przydatny, gdy trzeba wysłać kontaktowi kod bezpieczeństwa w sposób wiarygodny i zapisany w historii.
• Kampania z wyraźną zgodą — szablon Marketing wysyłany tylko do kontaktów, które wyraziły wyraźną zgodę na otrzymywanie wiadomości WhatsApp od firmy, np. na ogłoszenie sezonowej promocji.

Najczęściej zadawane pytania

P: Czy mogę odbierać wiadomości od moich klientów w Mokapen, w przeciwieństwie do SMS?

O: Tak. WhatsApp Business jest dwustronny: jeśli kontakt napisze do Ciebie, wiadomość pojawia się jako nowa rozmowa na karcie kontaktu i w skrzynce Wiadomości, a w ciągu 24 godzin możesz odpowiedzieć dowolnym tekstem.

P: Czy naprawdę potrzebuję konta Meta Business, aby połączyć WhatsApp?

O: Tak. Potrzebne są zweryfikowany portfel Meta Business i aplikacja Meta Developer ze skonfigurowanym produktem WhatsApp: połączenie odbywa się przez Embedded Signup Meta, a nie przez bezpośrednie logowanie w aplikacji WhatsApp na telefonie.

P: Mój numer jest już w normalnym WhatsApp lub u innego dostawcy: czy mogę go mimo to połączyć?

O: Tak, ale najpierw musi zostać zwolniony lub przeniesiony: jeśli jest w osobistej aplikacji WhatsApp, usuń konto na tym telefonie i poczekaj około 15 minut; jeśli jest już u innego dostawcy API WhatsApp Business, wybierz opcję migracji podczas łączenia i potwierdź.

P: Czy mogę pisać do klienta swobodnie w każdej chwili?

O: Nie. Możesz pisać dowolny tekst tylko w ciągu 24 godzin od ostatniej wiadomości, którą klient Ci wysłał. Poza tym oknem, lub dla pierwszego kontaktu, musisz użyć szablonu zatwierdzonego przez Metę.

P: Jak tworzę lub aktualizuję szablon wiadomości?

O: W Ustawienia → Szablony, typ WhatsApp Business: tworzysz lub edytujesz szablon, który jest zapisywany i przesyłany do zatwierdzenia bezpośrednio w Meta. Alternatywnie, jeśli masz już zatwierdzone szablony w Meta, użyj Synchronizuj szablony na stronie Integracje → WhatsApp Business, aby je zaimportować.

P: Ile kosztuje wysłanie wiadomości WhatsApp?

O: Koszt zależy od kraju docelowego i kategorii wiadomości (marketing, utility, authentication lub swobodna rozmowa w oknie 24-godzinnym). Kredyt jest odliczany z portfela organizacji w momencie wysyłki: sprawdź dostępne saldo na stronie Integracje → WhatsApp Business.

P: Czy WhatsApp Business jest dostępny jako akcja w automatyzacjach, tak jak Email lub SMS?

O: Jeszcze nie: obecnie moduł Automatyzacje oferuje tylko Wyślij Email i Wyślij SMS. Wysyłanie wiadomości WhatsApp jest możliwe tylko ręcznie z karty kontaktu.

P: Czemu jeden z moich szablonów został odrzucony przez Metę?

O: Najczęstsze powody to: kategoria niezgodna z rzeczywistą treścią wiadomości, nieprawidłowo numerowane lub z przerwami symbole zastępcze, niedozwolona treść (spam, fałszywa pilność, prośby o dane wrażliwe) lub format niezgodny z zasadami struktury. Dokładny powód odrzucenia jest wskazany przez Metę na szablonie.

P: Co się dzieje z danymi, jeśli odłączę integrację?

O: Z zaznaczonym polem „Wiadomości i szablony" (ustawienie domyślne), historia wiadomości i zsynchronizowane szablony pozostają widoczne w Mokapen. Po odznaczeniu, Mokapen usuwa szablony, wątki, wiadomości i pliki multimedialne powiązane z tą integracją. Połączenie z kontem Meta jest zawsze usuwane niezależnie.

P: Czy mogę używać wielu numerów WhatsApp Business w tej samej organizacji?

O: Tak, jeśli Twoje konto WhatsApp Business (WABA) ma podłączonych wiele numerów, lub jeśli połączysz wiele kont: w edytorze, jeśli dostępna jest więcej niż jedna opcja, wybierz, którą użyć jako nadawcę przed wysłaniem.