Szablony WhatsApp i Business API

WhatsApp wymaga, aby wiadomości biznesowe działały według reguł: wstępnie zatwierdzone szablony dla pierwszej wiadomości, 24-godzinne okno dla wiadomości dowolnych oraz limity załączników. Oto jak działa to w Tesoro za pośrednictwem Twilio.

Ustawienia WhatsApp — Ustawienia szablonów na ekranie ustawień osobistych.

Kiedy to jest istotne?

Pierwsza wiadomość do kontaktu kończy się błędem, szuka Pan/Pani reguły dotyczącej szablonów
Okno 24-godzinne wygasło i nie rozumie Pan/Pani, dlaczego nie może już Pan/Pani wysyłać
Chce Pan/Pani wiedzieć, ile to kosztuje

Jak działa integracja

Tesoro nie komunikuje się bezpośrednio z WhatsApp:

Tesoro → wiadomość do API Twilio
Twilio → przekazanie do WhatsApp Business API (prefiks whatsapp:)
WhatsApp → dostarczenie do odbiorcy
Aktualizacje statusu (delivered, read, failed) zwracane przez webhooki Twilio
Wiadomości przychodzące → w czasie rzeczywistym do wszystkich członków zespołu

Co jest potrzebne

Element	Opis
Konto Twilio	Aktywne, z saldem
Profil WhatsApp Business	Zatwierdzony przez Meta za pośrednictwem Twilio
Zarejestrowany numer WhatsApp	Specyficzny dla WhatsApp Business API; skonfigurowany w Settings → Company Settings → Call Settings
Twilio SID + Token	Dane uwierzytelniające API, skonfigurowane przez administratora systemu

Szablony wiadomości: co i dlaczego

Wstępnie zatwierdzone formaty wiadomości. Obowiązkowe dla pierwszej wiadomości do kontaktu.

W Tesoro każdy szablon ma:

Pole	Opis	Walidacja
Title	Nazwa do rozpoznania	3–100 znaków
Description	Treść, która zostanie wysłana	3–100 znaków

Przeglądanie szablonów

Automatycznie ładowane po otwarciu zakładki WhatsApp na rekordzie. Dostępne dla Admin + Employee.

Wysyłanie szablonu

Zakładka WhatsApp kontaktu/dealu/leada/relacji.
Brak historii rozmowy? → system prosi o wybór szablonu.
Wybór z listy rozwijanej (widoczny tytuł).
Get Started → description zostaje wysłana jako treść wiadomości.
Wiadomość zarejestrowana ze statusem dostarczenia, identyfikatorem Twilio SID i kierunkiem.

Proces zatwierdzania (Meta)

Utworzenie szablonu: w Twilio lub Meta Business Manager. Tekst + kategoria (marketing, transakcyjny, uwierzytelnianie) + zmienne.
Ocena Meta: od minut do dni.
Zatwierdzenie/odrzucenie: dashboard Twilio lub Meta Business Manager pokazuje status.
Rejestracja w Tesoro: zatwierdzone szablony pojawiają się na liście rozwijanej.

Typowe przyczyny odrzucenia

Przyczyna	Wyjaśnienie
Wprowadzająca w błąd treść	Nieprawdziwe lub wprowadzające w błąd informacje
Brak opcji rezygnacji	Brak możliwości rezygnacji dla odbiorcy
Treść zabroniona	Hazard, alkohol itp.
Nieprawidłowy format	Zmienne lub formatowanie nie spełniają wymagań technicznych

Kiedy: pierwsza wiadomość lub po wygaśnięciu okna 24-godzinnego
Jak: wybór szablonu, system wysyła description
Załączniki: nieobsługiwane

Porównanie:

Cecha	Szablon	Dowolna
Pierwsza wiadomość	✅ wymagany	❌
Treść	Zdefiniowana z góry	Dowolna
Maks. długość	100 znaków (limit szablonu)	1 600 znaków
Załączniki	❌	✅ (do 10)
Wymagane zatwierdzenie	✅ (Meta)	❌

24-godzinne okno rozmowy

Reguła WhatsApp zapobiegająca spamowi.

Wysyła Pan/Pani wiadomość szablonową → rozmowa otwarta.
Kontakt odpowiada → rozpoczyna się okno 24-godzinne.
Przez 24 godziny → może Pan/Pani wysyłać wiadomości dowolne bez szablonu.
Brak odpowiedzi w ciągu 24h → okno zamyka się. Potrzebny nowy szablon, aby ponownie otworzyć rozmowę.

Co zrobić, gdy okno wygasło

Próbuje Pan/Pani wysłać wiadomość dowolną po 24 godzinach? WhatsApp odrzuci.

Proszę wrócić do wyboru szablonu.
Proszę wybrać zatwierdzony szablon.
Proszę wysłać, okno otworzy się ponownie.
Proszę czekać na odpowiedź, aby móc wysyłać wiadomości dowolne.

Wiadomości multimedialne: wysyłanie plików

Tylko w wiadomościach dowolnych, nie w szablonach.

Jak Tesoro to przetwarza:

Każdy plik = osobna wiadomość WhatsApp przez Twilio z mediaUrl
Tekst = osobna wiadomość
Pliki zapisywane w Tesoro + powiązane z rekordem wiadomości

Obsługiwane typy

Typ	Przykłady
Dokumenty	PDF, Word, Excel
Obrazy	JPEG, PNG, GIF, WebP
Audio	MP3, OGG
Wideo	MP4
Archiwa	ZIP, RAR

Limity: maks. 10 plików na wiadomość, 1,5 MB na plik.

Odbieranie plików

Kontakt wysyła plik → Tesoro:

Wykrywa przez webhook NumMedia Twilio
Pobiera z adresu URL multimediów Twilio
Zapisuje w Tesoro z właściwym rozszerzeniem (na podstawie typu MIME)
Powiązuje z rekordem wiadomości + kontaktem

Status dostarczenia i aktualizacje w czasie rzeczywistym

Statusy

Status	Opis
queued	W kolejce w Twilio
sent	Wysłana do WhatsApp
delivered	Na urządzeniu odbiorcy
read	Odbiorca przeczytał
failed	Niedostarczona

Aktualizacje w czasie rzeczywistym

Wiadomość przychodząca → powiadomienie do wszystkich użytkowników
Zmiana statusu → aktualizacja na żywo w widoku czatu (bez odświeżania strony)

Koszty

Komponent	Wyjaśnienie
Taryfa za wiadomość Twilio	Za wiadomość (przychodzącą + wychodzącą), różna w zależności od kraju
Taryfa za rozmowę WhatsApp	Za okno 24-godzinne, różnica między rozmową rozpoczętą przez firmę (szablon) a rozpoczętą przez użytkownika (odpowiedź)
Kategoria szablonu	Marketing > transakcyjny > uwierzytelnianie
Wiadomości multimedialne	Dodatkowe koszty w zależności od typu + rozmiaru

Uprawnienia

Akcja	Kto
Wysyłanie wiadomości (dowolnych)	Admin, Employee
Wysyłanie wiadomości (szablon)	Admin, Employee
Odczytywanie wiadomości	Admin, Employee
Przeglądanie szablonów	Admin, Employee

Częste błędy

Szablon się nie pojawia: proszę sprawdzić tytuł + description (oba 3–100 znaków). Możliwe, że nie został zarejestrowany w Twilio.
“The selected template doesn’t match our records”: identyfikator szablonu już nie istnieje (usunięty?).
Wiadomość odrzucona po 24 godzinach: okno wygasło. Proszę wysłać nowy szablon.
Załączniki niemożliwe przy szablonie: proszę użyć wiadomości dowolnej (po odpowiedzi kontaktu).
“Company with Twilio WhatsApp number attached not found”: numer w webhooku Twilio nie pasuje do żadnej firmy. Proszę sprawdzić Settings → Company Settings → Call Settings.

Następne kroki

Podstawy WhatsApp i SMSJak wysyłać + odbierać i jaka konfiguracja jest potrzebna.

Rozmowy telefonicznePlanowanie + dzwonienie przez Twilio.