Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

WhatsApp Embedded Signup dla klientów: własna aplikacja Tech Provider czy strona hostowana

SaaS może połączyć numery klientów z WhatsApp Business z Cloud API przez Embedded Signup Meta na dwa sposoby. Może sam zostać Tech Providerem Meta, co wymaga weryfikacji firmy, App Review z dwoma nagraniami wideo i własnej implementacji Embedded Signup. Może też przekierować klientów na stronę hostowaną Embedded Signup, prowadzoną przez dostawcę, który już nim jest, i odebrać gotowe połączenie.

easyCoexistence uruchamia Embedded Signup Meta z Coexistence na stronie hostowanej, która nosi Twoją nazwę, więc Twoi klienci łączą numery bez zostawania Tech Providerem.

10 to 200

Nowych klientów biznesowych, których Tech Provider może wdrożyć w ciągu kroczącego 7 dni: 10 domyślnie, 200 po weryfikacji i przeglądzie.

2 videos

Nagrania ekranu, o które App Review prosi Tech Providera: wysłanej i odebranej wiadomości oraz tworzenia szablonu wiadomości.

About 24 hours

Deklarowany przez Meta średni czas oczekiwania na App Review aplikacji WhatsApp.

2.24.17

Najstarsza wersja aplikacji WhatsApp Business, którą klient może połączyć przez Coexistence.

30 seconds

Jak długo kod zwracany przez Embedded Signup pozostaje ważny, aby serwer mógł wymienić go na token biznesowy klienta.

Jakie są dwa sposoby wdrażania numerów klientów?

Oba korzystają z Embedded Signup Meta z Coexistence i kończą się w tym samym miejscu: numer klienta jest na Cloud API, nadal działa w aplikacji WhatsApp Business, a Twój backend przechowuje własny token biznesowy klienta. Różni się to tym, kto odpowiada za wymagania Meta i za kod wokół okienka.

Your own Tech Provider appeasyCoexistence's hosted page
Before the first customerBusiness verification, App Review and your own Embedded Signup buildAn API key and a card on the account
Name in Meta's popupYour appeasyCoexistence, with your name on the page around it
Code you maintainThe popup, the token exchange, webhook subscriptions and the history syncA session request and a return page
The 14-day ruleA PARTNER_REMOVED webhook for your app to handleconnection.disconnected with PRIMARY_INACTIVITY
Meta's message chargesOn the customer's WhatsApp Business AccountOn the customer's WhatsApp Business Account

Czego Meta wymaga, aby zostać Tech Providerem?

Meta wymienia kroki w przewodniku Become a Tech Provider, który App Dashboard otwiera w ramach onboardingu Tech Provider dla przypadku użycia WhatsApp:

  • Aplikacja Meta z przypadkiem użycia WhatsApp, połączona z Twoim portfolio firmy.
  • Weryfikacja firmy, która jest pierwsza: Meta uruchamia App Review wyłącznie dla zweryfikowanej firmy.
  • Ustawienia aplikacji, takie jak ikona, polityka prywatności i kategoria.
  • Dostęp zaawansowany do whatsapp_business_messaging i whatsapp_business_management, przyznawany w App Review z pisemnym uzasadnieniem i nagraniem ekranu dla każdego z nich.
  • Łącznie dwa nagrania: wiadomość wysłana z Twojej aplikacji i odebrana w WhatsApp oraz utworzenie przez Twoją aplikację szablonu wiadomości.

Co budujesz po zatwierdzeniu?

Sam onboarding, który przewodniki Embedded Signup Meta opisują krok po kroku:

  • Przepływ na Twojej stronie, przez Facebook Login for Business i JavaScript SDK Meta, na domenach HTTPS dozwolonych w aplikacji.
  • Coexistence włączone w konfiguracji przepływu, z logowaniem sesji, którego Meta wymaga dla tej funkcji.
  • Wywołanie serwera, które wymienia zwrócony kod na token biznesowy klienta w ciągu 30 sekund.
  • Webhooki: Twoja aplikacja subskrybuje konto każdego klienta, z polami account_update, history, smb_app_state_sync i smb_message_echoes.
  • Synchronizacja kontaktów i historii w ciągu 24 godzin od onboardingu; po tym czasie klient musi się wyrejestrować i ponownie uruchomić przepływ.

Co przejmuje strona hostowana?

Całą część związaną z oknem Meta. easyCoexistence uruchamia Embedded Signup z Coexistence przez własną aplikację Meta jako Tech Provider, na stronie easycoexistence.com, która pokazuje Twoją nazwę. Wymiana tokenu, subskrypcja webhooków i żądanie historii odbywają się tam, a Twój backend otrzymuje identyfikator połączenia. Z webhook_url w sesji Meta dostarcza wiadomości z numeru bezpośrednio na Twój serwer, wraz z jednorazowym importem kontaktów i, gdy klient je udostępni, do 180 dni czatów. Twój kod wywołuje następnie Graph API Meta bezpośrednio tokenem klienta, a easyCoexistence obserwuje numer i wysyła podpisane zdarzenia, gdy się zmieni.

Co widzi Twój klient?

Stronę z Twoją nazwą i jednym przyciskiem Connect. Zanim otworzy się okno Meta, lista kontrolna prosi klienta o potwierdzenie pięciu rzeczy: aktualnej aplikacji WhatsApp Business, numeru w rzeczywistym użyciu przez co najmniej 7 dni, braku innego dostawcy API lub narzędzia automatyzacji na numerze, braku nieoficjalnych aplikacji oraz telefonu pod ręką z logowaniem do Facebooka. Nie prosi się go o konto, e-mail ani kartę.

1Your pageYour name, the checklist and one Connect button
2Meta's popupFacebook sign-in, the number, then the business portfolio
3QR codeScanned from inside the WhatsApp Business app
4In the appConnect, then Confirm: share chat history or not
5Back to youConnected, then your redirect_url

Co dzieje się w oknie Meta?

Przepływ Meta loguje klienta przez Facebooka, prosi o autoryzację aplikacji i wpisanie numeru oraz pokazuje profil aplikacji WhatsApp Business tego numeru do potwierdzenia. Klient wybiera lub tworzy portfolio firmy, następnie skanuje kod QR z wnętrza aplikacji WhatsApp Business. Meta wysyła też na numer wiadomość WhatsApp z linkiem do kodu. W aplikacji klient klika Connect i wybiera, czy udostępnić historię czatów. Na końcu są nazwa konta, strefa czasowa i warunki Meta. Kolejność może się różnić, gdy Meta wdraża przepływ oparty najpierw na numerze telefonu.

Czyją nazwę pokazuje okno Meta?

Nazwę aplikacji, która prosi o dostęp. Na stronie hostowanej jest to easyCoexistence, której nie można zmienić, podczas gdy strona wokół okna pokazuje Twoją nazwę z partner_name. Własna aplikacja Tech Provider pokazuje natomiast nazwę Twojej aplikacji, kosztem weryfikacji, przeglądu i budowy opisanych wyżej.

Na czym polega zasada 14 dni?

Meta rozłącza numer Coexistence, gdy telefon z aplikacją WhatsApp Business był nieaktywny przez około 14 dni, i podaje przyczynę jako PRIMARY_INACTIVITY. Klient łączy się ponownie, uruchamiając przepływ z tym samym numerem. Przez stronę hostowaną easyCoexistence obserwuje każdy numer i wysyła na Twój adres zdarzeń URL connection.disconnected z tą przyczyną, więc nowy link do połączenia dla klienta może przywrócić numer.

Typowe błędy

  • Budowanie na Embedded Signup v2 lub v3. Meta wycofała obie wersje 15 października 2026 i obsługuje żądania do nich jako v4.
  • Żądanie uprawnień, których aplikacja nie używa. Meta wymienia niepotrzebne uprawnienia jako częsty powód odrzucenia zgłoszenia w App Review.
  • Nagranie jednego wideo dla obu uprawnień. Meta chce osobnego nagrania ekranu i osobnego uzasadnienia dla każdego z nich i może odrzucić wideo pokazujące kilka.
  • Proszenie klientów o połączenie z telefonu, na którym jest numer. Okno Meta otwiera się tam jako nowa karta, a ten sam telefon musi zeskanować kod QR, dlatego wygodniej jest użyć komputera.
Z EasyCoexistence zrobisz to

Twój backend otrzymuje token każdego klienta, Meta dostarcza wiadomości bezpośrednio na Twój webhook, a rozłączenia trafiają do Ciebie jako podpisane zdarzenia. Od US$ 9 do US$ 0.75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, z pierwszymi 3 dniami za darmo.

Najczęściej zadawane pytania

Czy muszę być Tech Providerem Meta, aby wdrażać numery WhatsApp moich klientów?

Tylko po to, by uruchamiać Embedded Signup z własnej aplikacji Meta. Wysłanie klientów na stronę hostowaną, prowadzoną przez Tech Providera, łączy ich numery bez Twojej własnej weryfikacji firmy i App Review.

Ile trwa App Review Meta dla aplikacji WhatsApp?

Meta podaje średnio około 24 godzin. Weryfikacja firmy musi być zakończona, zanim można rozpocząć przegląd, a każde odrzucone zgłoszenie dodaje kolejną rundę.

Czy mój klient nadal korzysta z aplikacji WhatsApp Business?

Tak. Aplikacja działa dalej na jego telefonie obok API, a wiadomości są lustrzane między nimi. Niektóre funkcje aplikacji się zmieniają: listy rozsyłania stają się tylko do odczytu, a wiadomości znikające i jednorazowego wyświetlenia zostają wyłączone.

Kto płaci Meta za wiadomości?

Klient. Meta obciąża wiadomości wysłane przez API na konto WhatsApp Business Account klienta, przy metodzie płatności, którą dodaje tam sam, natomiast wiadomości wysłane z aplikacji WhatsApp Business pozostają bezpłatne.

Czytaj dalej

Połącz pierwszy kanał w dwie minuty.

Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.

  • 3 dni za darmo
  • Rezygnacja w każdej chwili
  • Tylko oficjalne API
  • Monitorowanie 24/7

Zweryfikowano w