/
Dokumentacja dla programistówwymaga logowania
PLENDE
Start › Dla użytkowników › WhatsApp

WhatsApp

Podłączenie WhatsAppa przez WhatsApp Business Platform (konto Meta, weryfikacja firmy, numer, szablony, test) albo przez telefon z aplikacją Samlavik Most.

Najpierw decyzja o drodze (Ustawienia › Kanały › Dodaj kanał › WhatsApp). Ten rozdział opisuje obie, zaczynając od oficjalnej.

Droga 1: oficjalne API (WhatsApp Business Platform)

Samlavik łączy się z Cloud API - usługą Meta, w której numer firmy działa bez telefonu. Kreator ma sześć kroków.

Krok 1-2: konto Meta firmy

Klikasz „Połącz przez Meta”. Otwiera się okno logowania Facebooka (Meta nazywa je Embedded Signup). Logujesz się jako osoba z uprawnieniami administratora portfolio firmy w Meta Business Suite i wybierasz:

  • portfolio firmy (dawniej Business Manager) - istniejące albo nowe,
  • konto WhatsApp Business - nowe albo istniejące bez numerów,
  • numer (krok 4).

Samlavik dostaje token użytkownika systemowego przypisany tylko do tego konta WhatsApp. Token zapisujemy zaszyfrowany, nigdy nie wraca do przeglądarki. Hasła do Facebooka Samlavik nie widzi. Płatności za szablony ustawiasz w Meta (karta albo faktura) - Samlavik nie pośredniczy w rozliczeniu.

Krok 3: weryfikacja firmy

Meta sprawdza, że firma istnieje: nazwa prawna, adres, NIP, strona internetowa, czasem dokument rejestrowy i potwierdzenie domeny rekordem w DNS. Do czasu weryfikacji:

  • odpowiedzi klientom działają normalnie,
  • wiadomości z inicjatywy firmy (szablony poza oknem 24 h) dostanie najwyżej 250 różnych osób na dobę.

Po weryfikacji limit rośnie do 2000 osób na dobę, potem Meta podnosi go sama do 10 tys., 100 tys. i bez limitu - jeśli jakość numeru jest dobra i w ostatnich 7 dniach firma wykorzystała co najmniej połowę limitu. Limit liczy się dla całego portfolio, wspólnie dla wszystkich numerów. Źródło: dokumentacja Meta „Messaging limits”, developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limits (stan na 15.10.2026).

Nazwa wyświetlana to nazwa nad rozmową u klienta (np. „Hurtownia Rybka”). Meta sprawdza, czy pasuje do firmy. Do czasu zatwierdzenia klient widzi numer.

Krok 4: numer telefonu

Sytuacja Co zrobić
Nowy numer, bez WhatsAppa (stacjonarny albo komórkowy) kod weryfikacyjny SMS-em albo połączeniem głosowym; najprostsza droga
Numer działa w aplikacji WhatsApp Business i ma zostać w telefonie koegzystencja: aplikacja zostaje, numer działa też w Cloud API
Numer działa w zwykłym WhatsAppie najpierw usuń konto WhatsApp z tego numeru; historii nie przeniesiemy

Koegzystencja (stan na 15.10.2026, źródło: Meta, „Onboarding WhatsApp Business app users”): wymaga aplikacji WhatsApp Business w wersji 2.24.17 lub nowszej, historia do 6 miesięcy przechodzi do Cloud API (synchronizacja musi ruszyć w ciągu 24 h od podłączenia), wiadomości wysłane z aplikacji w telefonie przychodzą do Samlavika jako kopia i nie otwierają okna 24 h. Nie działają: grupy, wiadomości znikające i „wyświetl raz”, połączenia, listy nadawcze (zostają tylko do odczytu), katalogi i etykiety. Przepustowość takiego numeru: 20 wiadomości na sekundę.

Kod PIN weryfikacji dwuetapowej numeru zapisujemy zaszyfrowany - jest potrzebny przy przenoszeniu numeru.

Krok 5: szablony

Bez zatwierdzonego szablonu nie napiszesz pierwszy ani po 24 h od ostatniej wiadomości klienta. Szczegóły, kategorie i przykłady: Okno 24 h i szablony WhatsApp.

Krok 6: test

Samlavik sprawdza drogę w obie strony: webhook Meta (zdarzenia podpisane kluczem aplikacji), rejestrację numeru, wiadomość testową (szablon) do wskazanej osoby i jej odpowiedź, która ma wrócić jako sprawa. Dopiero potem przycisk „Uruchom kanał”.

Na co dzień

  • Jakość numeru (wysoka / średnia / niska) - ocena Meta z blokad i zgłoszeń klientów. Spadek jakości obniża limit.
  • Przepustowość: 80 wiadomości na sekundę na numer, więcej dla bardzo dużych nadawców (Meta, „Throughput”, stan na 15.10.2026). W praktyce Samlavik i tak wysyła wolniej.
  • Asystent pisze szkice jak dla poczty. Szablony wysyła wyłącznie jako szkic do akceptacji, nigdy hurtem.
  • Koszt pokazuje Ustawienia › Kanały › Koszty i limity, z raportu Meta.

Droga 2: telefon z aplikacją Samlavik Most

Numer zostaje w aplikacji WhatsApp Business (albo WhatsApp) na telefonie firmowym. Samlavik Most czyta powiadomienia o nowych wiadomościach i przekazuje je do Samlavika, a odpowiedzi wysyła przez przycisk „Odpowiedz” w powiadomieniu - tak jak zrobiłby to człowiek z ekranu blokady.

Co trzeba wiedzieć, zanim wybierzesz tę drogę:

  • To droga nieoficjalna. Regulamin WhatsApp (wersja dla EOG, obowiązująca od 17.08.2026) zakazuje korzystania z usługi „przez zautomatyzowane środki” w sposób, który jej szkodzi, i przewiduje zablokowanie konta. Samlavik nie wysyła hurtem i nie pisze pierwszy, ale ryzyka nie da się wyłączyć do zera. Źródło: whatsapp.com/legal/terms-of-service-eea (stan na 15.10.2026).
  • Odpowiedź działa tylko w rozmowie, która ma jeszcze powiadomienie w telefonie (zwykle z ostatnich godzin). Gdy powiadomienia nie ma, Samlavik pokazuje „Odpisz z telefonu” zamiast wysyłać na ślepo.
  • Grupy są pomijane, wiadomości „wyświetl raz” nigdy nie trafiają do Samlavika, zdjęć z czatów z ukrytymi multimediami aplikacja nie widzi.
  • Telefon musi być włączony, z ładowarką i internetem. Po 30 minutach ciszy Samlavik powiadamia wskazane osoby.

Instalacja i uprawnienia: Samlavik Most (aplikacja na telefon).

Zmiana drogi

Szczegół kanału › „Zmień drogę”. Przejście z telefonu na API dla tego samego numeru idzie przez koegzystencję (aplikacja zostaje w telefonie, historia 6 miesięcy przechodzi do Meta). Sprawy w Samlaviku zostają bez zmian. Od przełączenia wiadomości z inicjatywy firmy są płatne według cennika Meta.