Integracja WhatsApp

Webivio wysyła powiadomienia WhatsApp do uczestników i odbiera wiadomości w skrzynce w panelu. Działa przez Meta Cloud API na Twoim koncie WhatsApp Business (WABA) — uczestnik widzi nazwę Twojej firmy.

Plan: Pro (zgodnie z aktualnym cennikiem).
Webivio nie dostarcza numeru telefonu — podłączasz własny WABA.

Co możesz wysyłać (per webinar)

  • potwierdzenie zapisu,
  • przypomnienie 24h przed,
  • przypomnienie tuż przed startem,
  • follow-up po webinarze (wszyscy / obecni / nieobecni).

Gdy WhatsApp jest włączony na webinarze, numer telefonu przy rejestracji jest wymagany.

1. Połącz konto WhatsApp

  1. W menu wybierz WhatsApp.
  2. Zakładka Połączenie — uruchom połączenie (Embedded Signup w panelu).
  3. Dokończ kroki Meta. Szablony muszą mieć status zatwierdzony w Meta (APPROVED) zanim pójdzie produkcyjna wysyłka — zwykle od kilku minut do kilku godzin.
  4. Opcjonalnie uzupełnij Profil firmy (opis, e-mail, adres, branża, zdjęcie).

Strona wymagań: /auth/whatsapp/wymagania.

Ważne — rejestracja numeru: po dodaniu nowego numeru Meta często ma status „Oczekuje” / pending. W Webivio na zakładce Połączenie zobaczysz ten status i przycisk Zarejestruj numer (ustaw PIN) — ustaw 6-cyfrowy PIN, a Webivio dokończy rejestrację Cloud API. Błąd (#133010) Account not registered oznacza brak tej rejestracji — to nie awaria Webivio.

Numer z aplikacji WhatsApp Business (coexistence)

Meta pozwala w niektórych przypadkach użyć tego samego numeru w aplikacji WhatsApp Business na telefonie i jednocześnie w Cloud API (Webivio) — to tzw. coexistence. Decyzję o kwalifikacji numeru podejmuje wyłącznie Meta w oknie połączenia.

Jeśli przy wyborze numeru widzisz badge „Brak kwalifikacji” (EN: not eligible) i numer jest wyszarzony:

  • to nie oznacza braku elementów z checklisty Webivio — Meta nie pozwala teraz wybrać tego numeru;
  • najczęstsza przyczyna: numer jest już w aplikacji WhatsApp Business, ale konto nie przechodzi sprawdzenia kwalifikacji (często mała aktywność rozmów; komunikaty Meta w stylu kodu ~3441045);
  • inne powody: numer w zwykłym / prywatnym WhatsAppie (nie Business), numer już podpięty u innego dostawcy API, ograniczenia regionu.

Co zrobić:

  1. Zostać przy tym numerze i aplikacji — używaj WhatsApp Business normalnie (prawdziwe rozmowy z klientami), trzymaj aktualną aplikację, potem uruchom ponownie połączenie w Webivio.
  2. Inny numer albo tylko API — w oknie Meta wybierz „Wprowadź nowy numer telefonu”, albo najpierw odłącz / usuń ten numer z aplikacji na telefonie, odczekaj (zwykle ok. 15–30 min), potem dodaj go ponownie w flow połączenia.

Prywatny WhatsApp (nie Business) na tym samym numerze nie może współistnieć z Cloud API — trzeba go najpierw usunąć z aplikacji.

2. Włącz powiadomienia na webinarze

  1. Kreator → Powiadomienia → WhatsApp.
  2. Włącz wybrane scenariusze (potwierdzenie, 24h, last minute, follow-up…).
  3. Wyślij wiadomość testową z panelu na swój numer — działa dopiero po pełnej rejestracji numeru w Meta.

3. Skrzynka

  1. Menu Skrzynka WhatsApp (/auth/whatsapp/inbox) albo zakładka Wiadomości.
  2. Odpowiadasz tekstem w oknie 24h od ostatniej wiadomości uczestnika (reguła Meta poza szablonem).

Typowe błędy Meta

Kod / komunikatCo oznaczaCo zrobić
Brak kwalifikacji / not eligibleMeta nie pozwala wybrać numeru (często z aplikacji WA Business / coexistence)Używać numeru w aplikacji i spróbować ponownie albo nowy numer / odłączenie z app — sekcja coexistence
(#133010) Account not registeredNumer nie jest jeszcze zarejestrowany do Cloud APIW Webivio → Połączenie kliknij „Zarejestruj numer (ustaw PIN)”; odśwież status
(#200) brak uprawnieńToken / partner / WABA bez pełnego dostępuSprawdzić Partnerów i assety w Meta, potem odłączyć i połączyć ponownie
The token has expired…Wygasł access token Meta (~60 dni przy starym configu)Odłącz i połącz ponownie (Embedded Signup). To ostatnie odświeżenie — nowe połączenia dostają permanentny token. 3 dni przed wygaśnięciem dostaniesz mail i baner w panelu.
Szablon nie APPROVEDMeta jeszcze nie zatwierdziła treściPoczekać na APPROVED w zakładce Szablony

Token permanentny

Webivio zapisuje token z Embedded Signup. Po przejściu na konfigurację Meta never-expiring nowe połączenia nie wymagają cyklicznego odświeżania. Stare tokeny działają do naturalnego wygaśnięcia — wtedy wystarczy raz połączyć ponownie.

Koszty wiadomości

Zależą od kategorii szablonu Meta i kraju odbiorcy — ustalasz po stronie Meta / WABA. Nie podajemy stawek w tej dokumentacji.

Czego nie mylić

WhatsApp nie zastępuje e-maila. To dodatkowy kanał z osobnymi przełącznikami.

Co jeśli wysyłka nie działa

  1. Sprawdź status połączenia, rejestracji numeru i zatwierdzenia szablonu.
  2. Wyślij test z panelu na numer z poprawnym kodem kraju.
  3. Przy błędzie #133010 wróć do Połączenie i wybierz Zarejestruj numer (ustaw PIN).
  4. Webivio nie potwierdza automatycznego fallbacku WhatsApp na SMS lub e-mail — skonfiguruj te kanały osobno, jeśli mają być zabezpieczeniem.