What's new, 21 October 2026: A customer who sends several messages before the bot's first reply no longer gets the opening sequence of a Chat Flow twice
WASync · Developers

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ń:

KategoriaDo czego służy
UtilityInformacja o sprawie, którą klient już zainicjował: potwierdzenie wizyty, status zamówienia, faktura, dostawa, przypomnienie o płatności.
MarketingOferty, promocje, nowości, ponowny kontakt z dawnym klientem.
AuthenticationKody 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.

StatusZnaczenie
PendingMeta ocenia szablon. Nie można jeszcze go wysłać.
ApprovedGotowy. To jedyny status, w którym można wysyłać.
RejectedMeta odrzuciła szablon. Powód widać na karcie. Proszę poprawić tekst i utworzyć nowy szablon.
PausedMeta wstrzymała szablon. Wysyłki kończą się błędem do czasu ponownej aktywacji.
Disabled, In appeal, Pending deletion, Deleted, Limit exceededWł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ę.

  1. Wyszukaj po nazwie, języku lub treści i wybierz szablon.
  2. 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ść.
  3. 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.
  4. 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).
  5. 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 karcieProszę 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 PausedMeta 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 numeruProszę 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ówNa stronie Connections proszę uruchomić Connect with Facebook dla tego numeru, aby odświeżyć token.
Szablonu nie ma na liście przy wysyłaniuWyś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 zmiennePole 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 nieaktywnaSzablon 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ówNumer jest sparowany przez QR. Proszę użyć numeru WABA.
Szablony do tego kontaktu są zablokowane: kontakt poprosił o zaprzestanie wiadomościKontakt 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.
Czy ta strona była pomocna?

On this page