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

Jak dodać WhatsApp do swojego SaaS dzięki Embedded Signup i Coexistence

Twój SaaS dodaje WhatsApp, łącząc numer każdego klienta z jego istniejącym numerem przez Embedded Signup Meta z Coexistence, dzięki czemu numer nadal działa w aplikacji WhatsApp Business. Przy użyciu Partner API easyCoexistence jedna sesja połączenia na klienta przeprowadza ten przepływ na hostowanej stronie, Meta dostarcza wiadomości z numeru na Twój webhook_url, a Twój backend odpowiada przez Cloud API, używając tokenu danego klienta.

20 mps

Stała przepustowość numeru używanego jednocześnie w aplikacji WhatsApp Business i w Cloud API.

2.24.17

Najstarsza wersja aplikacji WhatsApp Business, z którą numer klienta może połączyć się przez Coexistence.

180 days

Jak daleko wstecz sięga historia czatów, którą Meta może udostępnić przy wdrożeniu; musi zostać zsynchronizowana w ciągu 24 godzin.

24 hours

Okno obsługi klienta WhatsApp po wiadomości lub połączeniu użytkownika; każda nowa wiadomość je resetuje.

October 15, 2026

Data wycofania Embedded Signup w wersjach v2 i v3, z integracjami przeniesionymi na v4.

Z jakich części składa się integracja WhatsApp?

Pięciu, a easyCoexistence przejmuje pierwszą i ostatnią. Twój produkt zachowuje logikę rozmowy, skrzynkę odbiorczą oraz to, co napiszą Twój model lub pracownicy Twoich klientów, a Meta przenosi wiadomości między numerem a Twoim serwerem:

1ConnectEmbedded Signup with Coexistence on a hosted page
2Routewebhook_url set on the number as it connects
3ReceiveMeta posts messages and echoes to your server
4ReplyCloud API calls with the customer's token
5WatchStatus events when the number drops or returns

Co Coexistence zmienia dla Twoich klientów?

Zachowują swój numer i swój telefon. Aplikacja WhatsApp Business dalej działa obok Cloud API, więc personel odpowiada z telefonu, podczas gdy Twój produkt odpowiada przez API. To, co zostanie wysłane z aplikacji, trafia do Twojego webhooka jako smb_message_echoes. Wiążą się z tym trzy ograniczenia: numer wysyła ze stałą prędkością 20 wiadomości na sekundę, szablony może wysyłać tylko API, a Meta odłącza numer, gdy telefon pozostaje nieaktywny przez około 14 dni.

Jak wygląda krok łączenia w Twoim produkcie?

Przycisk Connect WhatsApp wywołuje z Twojego backendu POST /connect-sessions z redirect_url, id klienta jako external_ref oraz webhook_url z webhook_verify_token, dzięki czemu Meta kieruje numer do Ciebie od pierwszej minuty. Klient potwierdza krótką listę kontrolną na hostowanej stronie, uruchamia wyskakujące okno Meta, skanuje kod QR aplikacją WhatsApp Business i wraca do Ciebie z connection_id. Czy zamiast tego uruchomić Embedded Signup we własnej aplikacji Tech Provider, rozstrzyga się w przewodniku po Embedded Signup.

Jak wiadomości docierają do Twojego backendu?

Od Meta, prosto na webhook_url, bez zatrzymywania się w easyCoexistence i bez kopii zapisywanej po drodze. Pole messages zawiera to, co wysyłają klienci, oraz status Twoich wiadomości, a smb_message_echoes zawiera to, co personel wysyła z aplikacji. Meta podpisuje każde dostarczenie sekretem aplikacji easyCoexistence, którego nigdy nie udostępnia się, więc długi, losowy sekret w ścieżce URL go uwierzytelnia. Dwa numery w jednym WhatsApp Business Account współdzielą miejsce docelowe: kieruj na podstawie value.metadata.phone_number_id.

Jak Twój backend odpowiada i wysyła szablony?

Za pomocą Graph API Meta i tokenu klienta z GET /connections/{id}?credentials=1, który zwraca także send_endpoint. Dowolny tekst może zostać wysłany w ciągu 24 godzin od ostatniej wiadomości tej osoby; po tym czasie tylko szablon zatwierdzony przez Meta:

  • Odpowiedź: POST /<PHONE_NUMBER_ID>/messages z type text, w ramach okna.
  • Szablon: to samo wywołanie z type template, nazwą szablonu i jego kodem języka.
  • Utworzenie szablonu: POST /<WABA_ID>/message_templates, a następnie odpytywanie o jego status, ponieważ wyniki weryfikacji nie docierają do webhook_url.
  • Multimedia: POST /<PHONE_NUMBER_ID>/media, aby przesłać plik; przychodzące multimedia pojawiają się jako ID do pobrania tym samym tokenem.
Reply inside the customer service window
curl -X POST "$SEND_ENDPOINT" \
  -H "Authorization: Bearer $CUSTOMER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "5511987654321",
    "type": "text",
    "text": { "body": "Your table for 4 is booked for 8 pm." }
  }'

Czy Twój produkt może zaimportować istniejące czaty klienta?

Raz, przy połączeniu. Gdy w sesji ustawiony jest webhook_url, easyCoexistence prosi Meta o przesłanie kontaktów numeru i, jeśli klient wyrazi zgodę w aplikacji, do 180 dni czatów, które przychodzą jako webhooki smb_app_state_sync i history. Meta pozwala na to tylko w ciągu 24 godzin od połączenia, więc endpoint musi już odpowiadać, zanim link trafi do klienta. Przewodnik po historii czatów opisuje treść tych zdarzeń.

Kto płaci Meta za wiadomości?

Twój klient. Meta obciąża wiadomości, które Twój backend wysyła przez API, na konto WhatsApp Business Account klienta, z metodą płatności, którą klient dodaje w tym koncie. Firma bez takiej metody nie może wysyłać szablonów marketingowych. easyCoexistence pobiera opłatę od Twojego konta za każdy połączony numer i nigdy nie nalicza opłat za wiadomości ani nie dolicza marży do cen Meta.

Co się dzieje, gdy numer wypada?

Na Twój events URL przychodzi connection.disconnected z powodem podanym przez Meta, o ile jest znany. PRIMARY_INACTIVITY oznacza regułę 14 dni, a nowa sesja połączenia dla tego klienta przywraca ten sam numer. connection.token_missing oznacza, że numer połączył się bez tokenu klienta, więc odbiera wiadomości, ale nie może ich wysyłać, dopóki nowa sesja go nie połączy ponownie.

Typowe błędy

  • Wysyłanie linku do połączenia, zanim Twój endpoint webhooka zacznie odpowiadać. Import historii działa raz, w ciągu 24 godzin od połączenia, a treści wysłane, zanim Twój URL zacznie działać, są tracone.
  • Odpowiadanie dowolnym tekstem po zamknięciu okna. Gdy minie 24 godziny od ostatniej wiadomości danej osoby, przechodzi tylko zatwierdzony szablon.
  • Wysyłanie kampanii z jednego numeru z pełną prędkością. Numer Coexistence wysyła 20 wiadomości na sekundę, więc kolejkuj wysyłki każdego numeru z tą szybkością.
  • Oczekiwanie, że personel wyśle szablony z telefonu. W Coexistence szablony wysyła tylko API, więc umieść wysyłki szablonów w swoim produkcie.
Z EasyCoexistence zrobisz to

easyCoexistence dodaje WhatsApp do Twojego SaaS dzięki Embedded Signup Meta i Coexistence na hostowanej stronie z Twoją nazwą: klienci zachowują swój numer i aplikację WhatsApp Business, Meta dostarcza wiadomości na Twój serwer, a zdarzenia dochodzą do Ciebie podpisane. To samo API łączy Instagram, Facebook, TikTok, YouTube, LinkedIn i inne kanały. US$ 9 do US$ 0.75 za połączenie miesięcznie, im więcej połączeń, tym taniej, z pierwszymi 3 dniami za darmo.

Najczęściej zadawane pytania

Czy klient może połączyć numer, który jest u innego dostawcy API WhatsApp?

Nie, dopóki tam pozostaje. Hostowana lista kontrolna wymaga numeru bez innego dostawcy API ani narzędzia automatyzacji, więc klient najpierw odłącza go od tamtego dostawcy.

Czy mój SaaS może wysyłać szablony WhatsApp dla swoich klientów?

Tak, przez Cloud API z tokenem każdego klienta: utwórz szablon na jego koncie WhatsApp Business Account, poczekaj na weryfikację Meta, a potem go wyślij.

Czy easyCoexistence czyta wiadomości WhatsApp moich klientów?

Nie. Meta dostarcza wiadomości numeru prosto na webhook_url, który ustawiasz. Numer bez webhook_url przechodzi na callback easyCoexistence, gdzie wiadomości są odrzucane bez zapisu.

Ile kosztuje easyCoexistence za numer WhatsApp?

US$ 9 do US$ 0.75 za numer miesięcznie, zależnie od pasma łącznej liczby połączeń, z pierwszymi 3 dniami za darmo. Opłaty Meta za wiadomości trafiają na konto WhatsApp Business Account każdego klienta.

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