Szablony WhatsApp (WABA)
Twórz szablony wiadomości WhatsApp Business API w WASync, śledź ich akceptację 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. To jedyny rodzaj wiadomości, jaki 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 przygotować 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-godzinne okno obsługi klienta. Otwiera się, gdy klient do Państwa napisze, i pozostaje otwarte przez 24 godziny od jego ostatniej wiadomości.
- W oknie można wysłać dowolny tekst, plik lub wiadomość głosową.
- Poza oknem (klient nigdy nie pisał albo napisał ponad 24 godziny temu) wyjść może tylko zatwierdzony szablon. Gdy klient odpowie, okno otwiera się ponownie na 24 godziny.
W WASync Chat zamknięte okno pokazuje baner Rozmowa wstrzymana — wyślij szablon, aby wznowić kontakt z przyciskiem Wybierz szablon, a znacznik w nagłówku czatu pokazuje, ile czasu pozostało do końca okna.
Każdy szablon należy do jednej z trzech kategorii, których Meta używa do oceny i do rozliczeń:
| Kategoria | Do czego służy |
|---|---|
| Utility | Informacja o sprawie, którą klient już zainicjował: potwierdzenie wizyty, status zamówienia, faktura, dostawa, przypomnienie o płatności. |
| Marketing | Oferty, promocje, nowości, ponowny kontakt z dawnym klientem. |
| Authentication | Kody jednorazowe, 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, a nie przez WASync. Tworzenie i zgłaszanie szablonu nic nie kosztuje.
Wymagania
- Numer WABA podłączony do WASync, w planie WABA. Różnice względem numeru sparowanego przez QR opisuje strona Typy połączeń.
- Do zarządzania szablonami: administrator lub pracownik z uprawnieniem do zapisu w sekcji Numery WhatsApp i szablony (macierz dostępu pracowników). Do przeglądania listy wystarczy uprawnienie do 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. Dla numeru sparowanego przez QR przycisk szablonu nie jest dostępny, a robot lub automatyzacja, która spróbuje go wysłać, zakończy się błędem: To połączenie WhatsApp nie może wysyłać szablonów. Szablony wymagają numeru WhatsApp Business (Cloud API).
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 wiadomość?
Wybierz Poinformuj klienta (Utility), Promuj ofertę (Marketing) lub Wyślij kod (oznaczone Wkrótce). Wybór ustawia kategorię za Państwa. Proszę zachować tu rzetelność: tekst promocyjny zgłoszony jako Utility zostanie przez Meta odrzucony lub przeniesiony do kategorii Marketing.
Można też zacząć od przykładu (Przypomnienie o wizycie, Zamówienie jest gotowe, Oferta z obrazem, Wróćmy do rozmowy) i zmienić wszystko w kolejnym kroku. Proszę wybrać Język wiadomości. Szablon ma jeden język; dla innego języka tworzy się osobny szablon.
Napisz wiadomość
Proszę napisać tekst w takiej postaci, w jakiej otrzyma go klient; podgląd po prawej stronie pokazuje, co klient zobaczy (do 1024 znaków).
- Personalizacja. Kliknij + Personalizuj, aby dodać zmienną: popularną
(Imię klienta, Data, Godzina, Numer zamówienia, Data ważności,
Produkt lub usługa, Kwota), pole Bitrix24 albo własną etykietę.
W tle każda z nich zamienia się w
{{1}},{{2}}itd. Nawiasów klamrowych nie należy wpisywać ręcznie. - Przykłady do akceptacji. Meta wymaga realistycznej przykładowej wartości dla każdej zmiennej (na przykład „Ania”, „31 października”). Proszę używać wiarygodnych wartości, nigdy prawdziwych danych klientów. Nie są one nikomu wysyłane.
- Nagłówek (opcjonalnie). Tytuł (do 60 znaków, bez zmiennych) albo Obraz (JPEG lub PNG, do 5 MB), Wideo (MP4, do 16 MB) lub PDF (do 16 MB). Przesłany plik jest przykładem oceniany przez Meta. WASync zachowuje go jako domyślny plik szablonu, dzięki czemu operatorzy nie muszą go podawać za każdym razem.
- Więcej opcji. 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 Dołącz prośbę o zgodę na połączenie WhatsApp. Etykiety przycisków mogą mieć do 25 znaków.
WhatsApp odrzuca wiadomość, która zaczyna się lub kończy zmienną, dlatego proszę dodać słowo przed pierwszą zmienną i po ostatniej. WASync sprawdza tę i inne zasady, zanim będzie można przejść dalej.
Wyślij do akceptacji
Proszę nadać szablonowi Nazwę szablonu, którą rozpozna Państwa zespół
(widzi ją tylko 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.
Klientom nic nie jest wysyłane.
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 ocenia: zwykle trwa to kilka minut, czasem kilka godzin, a okazjonalnie do doby. WASync automatycznie odbiera decyzję Meta i aktualizuje status. Przycisk Resync from Meta pobiera bieżący stan, jeśli chcą Państwo sprawdzić go od razu.
| Status | Znaczenie |
|---|---|
| Pending | Meta ocenia szablon. Nie można jeszcze go wysłać. |
| Approved | Gotowy. To jedyny status, w którym można wysyłać. |
| Rejected | Meta odrzuciła szablon. Powód widać na karcie. Proszę poprawić tekst i utworzyć nowy szablon. |
| Paused | Meta wstrzymała szablon. Wysyłki kończą się błędem do czasu ponownej aktywacji. |
| Disabled, In appeal, Pending deletion, Deleted, Limit exceeded | Własne stany Meta, pokazywane tak, jak zostały odebrane. |
Przycisk ✕ 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 czas oceny, dlatego WASync przechowuje przesłany przykład jako plik domyślny szablonu. Dla szablonu zatwierdzonego wcześniej lub utworzonego w Meta należy użyć na jego karcie przycisku Set default image (albo video, document); 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
Szablony utworzone w WhatsApp Manager nie ma w WASync, dopóki nie klikną Państwo Resync from Meta na liście szablonów. Synchronizacja importuje je wraz z przyciskami i nagłówkiem, odświeża wszystkie statusy i oznacza szablon jako Deleted, gdy nie istnieje już w Meta. Można ją bezpiecznie uruchamiać w dowolnej chwili.
Wysyłanie szablonu
Wszystkie trzy opisane niżej sposoby wysyłają wyłącznie szablony Approved, tylko z numeru WABA, i odmawiają wysyłki do kontaktu, który poprosił o zaprzestanie wiadomości. Jeśli klient odpowie prośbą o zatrzymanie wiadomości, WASync oznacza go jako wypisanego; administrator może zdjąć to oznaczenie, gdy osoba poprosi o ponowny kontakt.
Z czatu
W zakładce WASync leada, transakcji lub elementu Smart Process oraz w WASync Chat kliknij ikonę szablonu obok pola wiadomości (Wyślij szablon zatwierdzony przez Meta). Gdy 24-godzinne okno jest zamknięte, przycisk Wybierz szablon w banerze otwiera tę samą listę.
- Wyszukaj po nazwie, języku lub treści i wybierz szablon.
- Wypełnij każdą zmienną. Pierwsza jest wstępnie wypełniona imieniem kontaktu, jeśli jest znane; można ją edytować. Podgląd pokazuje gotową wiadomość.
- Jeśli szablon ma nagłówek multimedialny, wybierz plik: domyślny plik szablonu (wstępnie zaznaczony, jeśli istnieje) lub prześlij inny. Przycisk Wyślij pozostaje nieaktywny, dopóki plik nie zostanie wybrany.
- Opcjonalnie zaznacz Poproś też o zgodę na połączenie WhatsApp po wysłaniu (ukryte, gdy szablon już zawiera prośbę o zgodę na połączenie).
- Kliknij Wyślij. Wiadomość pojawi się w rozmowie i na osi czasu rekordu, w gotowej postaci.
Z reguł automatyzacji Bitrix24
Otwórz etap leada, transakcji lub Smart Process → Reguły automatyzacji → Dodaj automatyzację i wybierz Send WhatsApp Template (WABA) w grupie WASync. Reguła uruchamia się dla każdego rekordu, który trafia na ten etap, po jednym rekordzie naraz.
- WABA Connection: numer, z którego wysyłamy.
- 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. Jeden 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) lub Template's example (plik domyślny przechowywany przez WASync).
Odbiorcą jest telefon klienta z rekordu. Transakcja bez kontaktu jest sprawdzana ponownie w tle, zanim WASync zrezygnuje.
Gdy coś zatrzyma wysyłkę, powód jest zapisywany na osi czasu rekordu zamiast błędu bez komunikatu: zmienna, która okazała się pusta, szablon, który nie jest już zatwierdzony, brak pliku nagłówka, kontakt, który się wypisał, lub problem z licencją. Puste zmienne wstrzymują wysyłkę, ponieważ Meta odrzuca puste parametry.
Po zainstalowaniu lub zaktualizowaniu WASync proszę raz przeładować stronę automatyzacji: Bitrix24 buforuje definicje robotów do czasu przeładowania strony.
Z Chat Flows
W edytorze przepływu krok Message ma sekcję Szablon WhatsApp Business
(okno zamknięte). Proszę wybrać numer, zatwierdzony szablon, wypełnić każdą
zmienną (polem CRM, takim jak {{NAME}}, lub stałym tekstem) 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 Na numerze WhatsApp Business pierwsza wiadomość musi używać zatwierdzonego szablonu. 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 tymczasowym błędem, krok ponawia próbę jeden raz, zanim zakończy się niepowodzeniem.
Czego nie ma: kampanii masowych
WASync nie ma modułu kampanii masowych ani rozsyłania: nie można wgrać listy i wysłać szablonu do wszystkich. Wysyła on jeden szablon na rekord CRM, gdy uruchamia się reguła automatyzacji. Aby napisać do segmentu, należy umieścić te leady lub transakcje na etapie (albo tam je przenieść) i pozwolić, by reguła Send WhatsApp Template (WABA) uruchomiła się 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 przyznany 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 pierwszym wierszu i poinformować, jak zrezygnować z wiadomości. Proszę uszanować rezygnację: WASync blokuje szablony do kontaktów, które się wypisały.
- Gdy Meta ograniczy numer lub nałoży na niego limity, strona Connections i okno szablonów pokazują baner (Meta zablokowała wysyłanie z tego numeru lub Meta ograniczyła wysyłanie z tego numeru) z informacją, co zrobić, oraz 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. Proszę nie wysyłać dalej wstrzymanego szablonu. |
| Baner Meta zablokowała / ograniczyła wysyłanie z tego numeru | Proszę otworzyć Meta Account Quality przyciskiem w banerze i wykonać wskazane kroki: metoda płatności, weryfikacja firmy lub odwołanie. Wysyłki i nowe szablony pozostają zablokowane, dopóki Meta nie zdejmie blokady. |
| Token dostępu wygasł lub jest nieprawidłowy w oknie szablonów | Na stronie Connections proszę uruchomić Connect with Facebook dla tego numeru, aby odświeżyć token. |
| Szablonu nie ma na liście przy wysyłaniu | Wyświetlane są tylko szablony Approved. Proszę sprawdzić status, a następnie użyć Resync from Meta. |
| Błąd zmiennej przy tworzeniu (nie jest prawidłową zmienną, wymaga pola CRM i przykładowej wartości) | Zmienne należy dodawać przyciskiem + Personalizuj, a nie wpisując nawiasy, i podać przykład dla każdej z nich. Numeracja musi biec 1, 2, 3 bez przerw. |
| Robot nie wysłał, oś czasu pokazuje puste zmienne | 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. |
| Ten szablon ma nagłówek … lub wysyłka jest nieaktywna | Szablon multimedialny wymaga pliku. Proszę wybrać plik przy wysyłce, w regule lub w kroku albo ustawić plik domyślny szablonu. |
| To połączenie WhatsApp nie może wysyłać szablonów | Numer jest sparowany przez QR. Proszę użyć numeru WABA. |
| Szablony do tego kontaktu są zablokowane: kontakt poprosił o zaprzestanie wiadomości | 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
- Typy połączeń: numery sparowane przez QR i numery WABA.
- Przenoszenie numeru od innego dostawcy: przeniesienie istniejącego numeru WABA do WASync.
- Smart Processes (SPA) w 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.