Szablony WhatsApp (WABA)
Twórz szablony wiadomości WhatsApp Business API w WASync, śledź ich zatwierdzanie przez Meta i wysyłaj je z czatu CRM, z reguł automatyzacji Bitrix24 oraz z Chat Flows.
Szablon to wiadomość zatwierdzona wcześniej przez Meta. Tylko takiego rodzaju wiadomość numer WhatsApp Business API (WABA) może wysłać do klienta, który nie napisał do Państwa w ciągu ostatnich 24 godzin. Ta strona opisuje, jak napisać szablon w WASync, co dzieje się po stronie Meta i skąd można go wysłać.
Czym jest szablon i kiedy jest potrzebny
WhatsApp daje firmie 24-godzinną ramę obsługi klienta. Otwiera się, gdy klient do Państwa napisze, i trwa 24 godziny od jego ostatniej wiadomości.
- W trakcie okna można wysłać dowolny tekst, plik lub wiadomość głosową.
- Poza oknem (klient nigdy nie pisał albo pisał ponad 24 godziny temu) wysłać można wyłącznie zatwierdzony szablon. Gdy klient odpowie, okno otwiera się ponownie na 24 godziny.
W WASync Chat zamknięte okno oznacza baner Conversation paused — send a template to re-engage z przyciskiem Pick a template, a znacznik w nagłówku czatu pokazuje, ile czasu zostało do końca okna.
Każdy szablon należy do jednej z trzech kategorii, które Meta wykorzystuje do weryfikacji i rozliczeń:
| Kategoria | Do czego służy |
|---|---|
| Utility | Informacja o sprawie, którą klient już rozpoczął: potwierdzenie wizyty, status zamówienia, faktura, dostawa, przypomnienie o płatności. |
| Marketing | Oferty, promocje, nowości, ponowny kontakt z dawnym klientem. |
| Authentication | Jednorazowe kody, z treścią narzuconą przez Meta. WASync nie potrafi jeszcze ich tworzyć. |
Wiadomości szablonowe są rozliczane przez Meta za każdą wiadomość, według kategorii (marketing, utility, authentication). Szablony Utility wysłane w otwartym 24-godzinnym oknie obsługi klienta są bezpłatne. Opłata trafia na metodę płatności przypisaną do konta Meta, nie przez WASync. Tworzenie i zgłaszanie szablonu nic nie kosztuje.
Wymagania
- Numer WABA połączony z WASync, w planie WABA. Różnice względem numeru sparowanego przez QR opisuje strona Connection types.
- Do zarządzania szablonami: administrator lub pracownik z uprawnieniem zapisu do WhatsApp numbers & templates (macierz dostępu Staff). Do przeglądania listy wystarcza uprawnienie odczytu.
- Do wysyłania: dostęp do numeru w Connections → Staff, tak jak przy każdej wiadomości.
Numery sparowane przez QR nie mogą wysyłać szablonów
Szablony istnieją tylko w oficjalnym WhatsApp Business API. Przy numerze sparowanym przez QR przycisk szablonu nie jest dostępny, a robot lub automatyzacja, która spróbuje go wysłać, zakończy się błędem: This WhatsApp connection cannot send templates. Templates need a WhatsApp Business (Cloud API) number.
Tworzenie szablonu
Otwórz aplikację WASync w Bitrix24, przejdź do Connections, otwórz menu … numeru WABA i wybierz Message templates. Lista pokazuje każdy szablon wraz z językiem, kategorią, statusem oraz, w przypadku odrzuconych, powodem podanym przez Meta. Kliknij + New template.
Do czego służy ta wiadomość?
Wybierz Inform a customer (Utility), Promote an offer (Marketing) albo Send a code (oznaczone Coming soon). Wybór ustawia kategorię za Państwa. Proszę wybrać zgodnie z prawdą: tekst promocyjny zgłoszony jako Utility zostanie przez Meta odrzucony lub przeniesiony do Marketing.
Można też zacząć od przykładu (Appointment reminder, Order is ready, Offer with an image, Let's pick up the conversation) i zmienić wszystko w następnym kroku. Wybierz Message language. Szablon ma jeden język; dla innego języka tworzy się osobny szablon.
Napisz wiadomość
Napisz tekst tak, jak otrzyma go klient; podgląd po prawej pokazuje to, co klient zobaczy (do 1024 znaków).
- Personalizacja. Kliknij + Personalize, aby dodać zmienną: typową (Customer name, Date, Time, Order number, Expiry date, Product or service, Amount), pole Bitrix24 albo własną etykietę. W tle każda z nich staje się
{{1}},{{2}}itd. Nie należy wpisywać nawiasów ręcznie. - Przykłady do zatwierdzenia. Meta wymaga realistycznej przykładowej wartości dla każdej zmiennej (na przykład „Anna”, „31 października”). Proszę używać wiarygodnych wartości, nigdy danych prawdziwych klientów. Nie są one nikomu wysyłane.
- Nagłówek (opcjonalnie). Tytuł (do 60 znaków, bez zmiennych) albo Image (JPEG lub PNG, do 5 MB), Video (MP4, do 16 MB) lub PDF (do 16 MB). Przesłany plik jest próbką, którą ocenia Meta. WASync zachowuje go jako domyślny plik szablonu, dzięki czemu operatorzy nie muszą go podawać ponownie.
- More options. Stopka (do 60 znaków), do 3 przycisków szybkiej odpowiedzi, jeden przycisk z linkiem (stały adres URL, bez zmiennych), jeden przycisk połączenia oraz Include a WhatsApp call-permission request. Etykiety przycisków mogą mieć do 25 znaków. Prośba o zgodę na połączenie jest dostępna tylko wtedy, gdy połączenia WhatsApp są włączone dla numeru (Turning calls on for a number): WhatsApp i tak zatwierdzi taki szablon, a potem odrzuci każdą wysyłkę z numeru bez połączeń.
WhatsApp odrzuca wiadomość, która zaczyna się lub kończy zmienną, dlatego proszę dodać słowo przed pierwszą i po ostatniej zmiennej. WASync sprawdza tę i pozostałe reguły, zanim będzie można przejść dalej.
Wyślij do zatwierdzenia
Nadaj szablonowi Template name, który Państwa zespół rozpozna (widzi go tylko Państwa zespół). WASync generuje nazwę techniczną wymaganą przez Meta: małe litery, cyfry i _, unikalną dla danego numeru i języka. Lista kontrolna pokazuje, co zostało sprawdzone. Kliknij Send to WhatsApp for approval. Nic nie jest wysyłane do klientów.
Nie ma wersji roboczej: lista odzwierciedla stan po stronie Meta, więc szablon istnieje w WASync dopiero po zgłoszeniu.
Po zgłoszeniu
Szablon pojawia się na liście ze statusem Pending. Meta go weryfikuje: zwykle trwa to kilka minut, czasem kilka godzin, a okazjonalnie do doby. WASync automatycznie odbiera decyzję Meta i aktualizuje status. Resync from Meta pobiera aktualny stan, jeśli chcą Państwo sprawdzić go od razu.
| Status | Znaczenie |
|---|---|
| Pending | Meta go weryfikuje. Nie można jeszcze wysłać. |
| Approved | Gotowy. To jedyny status, w którym można wysyłać. |
| Rejected | Meta odmówiła. Powód widać na karcie. Popraw tekst i utwórz nowy szablon. |
| Paused | Meta wstrzymała szablon. Wysyłki kończą się błędem, dopóki nie zostanie ponownie aktywny. |
| Disabled, In appeal, Pending deletion, Deleted, Limit exceeded | Własne stany Meta, pokazywane tak, jak zostały odebrane. |
✕ na karcie usuwa szablon, także po stronie Meta.
Domyślny plik szablonu z multimediami
Szablon z nagłówkiem w postaci obrazu, wideo lub PDF wymaga tego pliku przy każdej wysyłce. Meta zachowuje swoją kopię tylko na potrzeby weryfikacji, dlatego WASync zachowuje przesłaną próbkę jako domyślny plik szablonu. W przypadku szablonu zatwierdzonego wcześniej lub utworzonego w Meta należy użyć Set default image (albo video, document) na jego karcie; dostępne są też Change i Remove. Bez pliku domyślnego osoba wysyłająca wybiera plik za każdym razem.
Szablony utworzone w Meta
Szablonów utworzonych w WhatsApp Manager nie ma w WASync, dopóki nie klikną Państwo Resync from Meta na liście szablonów. Resync importuje je wraz z przyciskami i nagłówkiem, odświeża każdy status i oznacza szablon jako Deleted, gdy nie istnieje już w Meta. Można go bezpiecznie uruchamiać w dowolnej chwili.
Wysyłanie szablonu
Wszystkie trzy poniższe sposoby wysyłają wyłącznie szablony Approved, wyłącznie z numeru WABA, i odmawiają wysyłki do kontaktu, który poprosił o zaprzestanie wiadomości. Jeśli klient odpowie prośbą o przerwanie, WASync oznacza go jako wypisanego; administrator może zdjąć to oznaczenie, gdy osoba poprosi o ponowny kontakt.
Z czatu
W zakładce WASync leada, deala lub elementu Smart Process oraz w WASync Chat kliknij ikonę szablonu obok pola wiadomości (Send a Meta-approved template). Gdy 24-godzinne okno jest zamknięte, przycisk Pick a template w banerze otwiera tę samą listę.
- Wyszukaj po nazwie, języku lub treści i wybierz szablon.
- Uzupełnij każdą zmienną. Pierwsza jest wstępnie wypełniona imieniem kontaktu, jeśli jest znane; można je edytować. Podgląd pokazuje gotową wiadomość.
- Jeśli szablon ma nagłówek multimedialny, wybierz plik: domyślny plik szablonu (wstępnie wybrany, jeśli istnieje) albo prześlij inny. Send pozostaje nieaktywny, dopóki plik nie zostanie wybrany.
- Opcjonalnie zaznacz Also ask permission for a WhatsApp call after sending (ukryte, gdy szablon już prosi o zgodę na połączenie).
- Kliknij Send. Wiadomość pojawia się w rozmowie i na osi czasu rekordu, z gotowym tekstem.
Z reguł automatyzacji Bitrix24
Otwórz etap leada, deala lub Smart Process → Automation rules → Add automation i wybierz Send WhatsApp Template (WABA) w grupie WASync. Reguła działa dla każdego rekordu, który trafi na ten etap, po jednym rekordzie naraz.
- WABA Connection: numer, z którego następuje wysyłka.
- Template: wyświetlane są tylko zatwierdzone szablony tego numeru.
- Variables: jeden wiersz na każde
{{n}}. Kliknij ⋯, aby otworzyć Insert Field i wybrać pola CRM, albo wpisz tekst. Wiersz może łączyć kilka pól i stały tekst. Pola są odczytywane z rekordu, na którym działa reguła. - Header image / video / document: dla szablonu multimedialnego wybierz File or link (prześlij plik albo wklej link lub pole, które go zawiera) albo Template's example (domyślny plik przechowywany przez WASync).
Odbiorcą jest telefon klienta z rekordu. Deal bez kontaktu jest w tle sprawdzany ponownie, zanim WASync zrezygnuje.
Gdy coś zatrzyma wysyłkę, powód jest zapisywany na osi czasu rekordu, zamiast kończyć się po cichu: zmienna, która wyszła pusta, szablon, który nie jest już zatwierdzony, brakujący plik nagłówka, kontakt, który się wypisał, lub problem z licencją. Puste zmienne zatrzymują wysyłkę, ponieważ Meta odrzuca puste parametry.
Po instalacji lub aktualizacji WASync proszę raz odświeżyć stronę automatyzacji: Bitrix24 buforuje definicje robotów do czasu ponownego załadowania strony.
Z Chat Flows
W edytorze flow krok Message ma sekcję WhatsApp Business template (window closed). Wybierz numer, zatwierdzony szablon, uzupełnij każdą zmienną (pole CRM, np. {{NAME}}, lub stały tekst) oraz, dla szablonu multimedialnego, plik nagłówka.
Szablon jest używany tylko wtedy, gdy numer jest numerem WABA, a 24-godzinne okno jest zamknięte, na przykład przy pierwszej wiadomości do klienta, który nigdy nie pisał. Jeśli okno jest otwarte, krok wysyła zwykły tekst. Jeśli okno jest zamknięte, a krok nie ma szablonu, kończy się błędem On a WhatsApp Business number the first message must use an approved template. Pliki dołączone do kroku nie są wysyłane razem z szablonem. Pusta zmienna jest zastępowana myślnikiem zamiast zatrzymywać krok. Jeśli Meta odpowie błędem tymczasowym, krok ponawia próbę raz, zanim zakończy się niepowodzeniem.
Czego nie ma: kampanii masowych
WASync nie ma modułu kampanii masowych ani rozgłoszeniowych: nie można wgrać listy i wysłać szablonu do wszystkich. Wysyła on jeden szablon na rekord CRM, gdy działa reguła automatyzacji. Aby napisać do segmentu, proszę umieścić te leady lub deale na etapie (albo tam je przenieść) i pozwolić regule Send WhatsApp Template (WABA) działać na tym etapie.
Proszę mieścić się w limitach Meta
- Każdy numer ma limit wiadomości zależny od poziomu jakości (strona Connections pokazuje poziom przypisany przez Meta, na przykład 1000 klientów na 24 godziny). Wysyłki ponad limit kończą się błędem.
- Proszę pisać tylko do osób, które spodziewają się kontaktu. Każda blokada lub zgłoszenie obniża ocenę jakości; niższa ocena obniża limit, a szablon z negatywnymi opiniami może zostać wstrzymany.
- Proszę przedstawić się w pierwszej linijce i powiedzieć, jak zrezygnować. Proszę uszanować rezygnację: WASync blokuje szablony do kontaktów, które się wypisały.
- Gdy Meta ogranicza lub blokuje numer, strona Connections i okno Templates pokazują baner (Meta has blocked sending on this number lub Meta has limited sending on this number) z informacją, co zrobić, i linkiem do Meta Account Quality.
Rozwiązywanie problemów
| Co Państwo widzą | Co zrobić |
|---|---|
| Status Rejected, z powodem na karcie | Proszę przeczytać powód podany przez Meta. Typowe przyczyny to tekst promocyjny w szablonie Utility, zmienna na początku lub końcu tekstu albo brak przykładów. Proszę utworzyć poprawiony szablon pod nową nazwą. |
| Status Paused | Meta wstrzymała szablon, zwykle z powodu negatywnych opinii klientów. Proszę poprawić tekst lub utworzyć nowy szablon. Nie należy dalej wysyłać wstrzymanego. |
| Baner Meta has blocked / limited sending on this number | Proszę otworzyć Meta Account Quality przyciskiem w banerze i postępować zgodnie z instrukcjami: metoda płatności, weryfikacja firmy lub odwołanie. Wysyłki i nowe szablony pozostają zablokowane, dopóki Meta tego nie zniesie. |
| Access token expired or invalid w oknie Templates | Na stronie Connections proszę uruchomić Connect with Facebook dla tego numeru, aby odświeżyć token. |
| Szablonu nie ma na liście podczas wysyłania | Wyświetlane są tylko szablony Approved. Proszę sprawdzić status, a następnie użyć Resync from Meta. |
| Błąd zmiennej przy tworzeniu (isn't a valid variable, needs a CRM field and an example value) | Proszę dodawać zmienne przez + Personalize, a nie wpisując nawiasy, i podać przykład dla każdej. Numeracja musi biec 1, 2, 3 bez luk. |
| Robot nie wysłał, oś czasu pokazuje empty variable(s) | Pole przypisane do zmiennej było puste w tym rekordzie. Proszę uzupełnić pole w rekordzie albo zmienić zmienną na inne pole lub stały tekst. |
| This template has a … header lub wysyłka jest nieaktywna | Szablon multimedialny wymaga pliku. Proszę wybrać plik przy wysyłce, w regule lub w kroku albo ustawić domyślny plik szablonu. |
| This WhatsApp connection cannot send templates | Numer jest sparowany przez QR. Proszę użyć numeru WABA. |
| This template asks for call permission, but WhatsApp calling is not enabled on this number lub szablonu oznaczonego Needs calling nie można wybrać | Proszę włączyć połączenia dla numeru w Connections → WhatsApp calls albo wysłać inny szablon. |
| Templates to this contact are blocked: this contact asked to stop receiving messages | Kontakt się wypisał. Nadal można odpowiadać na wiadomości, które sam wyśle. Administrator może zdjąć wypisanie tylko wtedy, gdy osoba poprosiła o ponowny kontakt. |
Powiązane
- Connection types: numery sparowane przez QR i numery WABA.
- Bring a number from another provider: przenieś istniejący numer WABA do WASync.
- Smart Processes (SPA) in WASync: robot szablonów działa także w regułach automatyzacji Smart Process.
Smart Processes (SPA) w WASync
Korzystanie z WhatsApp w elementach Smart Process w Bitrix24 — zakładka WASync w karcie elementu, rozmowy powiązane z elementami, roboty i Chat Flows w regułach automatyzacji SPA oraz to, czego element potrzebuje, aby to działało.
OAuth2 dla aplikacji zewnętrznych
Tylko dla aplikacji instalowanych przez innych klientów WASync. Authorization Code z PKCE, rotujące refresh tokeny i jedno ograniczenie strukturalne.