Zaloguj sięRozpocznij bezpłatny okres próbny
Meta Tech Provider

Jeden numer.Aplikacja i API, jednocześnie.

Coexistence to oficjalny tryb Meta, w którym aplikacja WhatsApp Business i Cloud API działają jednocześnie na jednym numerze. Zespół nadal odpowiada z telefonu, w tych samych czatach i z tą samą historią, a oprogramowanie wysyła i odbiera wiadomości na tej samej linii.

EasyCoexistence łączy numer, a następnie monitoruje połączenie.

Rozpocznij bezpłatny okres próbny3 dni bezpłatnie. Nic nie pobieramy przed końcem okresu próbnego.
+1 415 555 0188
Aplikacja WhatsApp BusinessZespół odpowiada z telefonu, jak dotąd
Cloud APITwoje systemy albo asystent AI, na tej samej linii
Oba kanały widzą ten sam wątek. To, co wysyła API, pojawia się w aplikacji, a to, co zespół pisze w aplikacji, trafia jako zdarzenie smb_message_echoes, więc oprogramowanie nigdy nie odpowiada na wiadomość, na którą człowiek już odpowiedział.
Domyślnie bez zapisu wiadomościAplikacja firmowa + Cloud APIMCP dla Claude i ChatGPTGotowe w 2 minuty

Wybór, który kiedyś istniał, a dziś już nie

Coexistence to nie nowe API. To usunięcie rozwidlenia dróg, które powstrzymywało niemal każdą małą firmę przed automatyzacją czegokolwiek.

WcześniejJeden numer, jeden wybór
Zostać przy aplikacji

Zespół odpowiada z telefonu. Niczego nie da się zautomatyzować, podłączyć ani zmierzyć.

Bez API
Przejść na API

Oprogramowanie ma dostęp do numeru. Aplikacja Business przestaje na nim działać, a zespół zmienia narzędzia.

Bez aplikacji
TerazJeden numer, oba
Jeden numer
Aplikacja WhatsApp BusinessCloud API

Meta podłącza Cloud API do numeru, którego nadal używa aplikacja WhatsApp Business. Oba kanały działają na tej samej linii i każdy widzi, co wysyła drugi.

Kto korzysta z numeru w ten sposób

Dwie grupy, które chcą od tej samej funkcji przeciwnych rzeczy, i dlatego połączenie ma większe znaczenie niż jakikolwiek panel zbudowany na nim.

Zostaje przy telefonieFirma z jednym numerem

Mały zespół, numer wypisany na furgonetce albo witrynie i wieczory spędzone na odpowiadaniu na te same cztery pytania. Nikogo nie zastępują. Chcą, żeby potwierdzenia, przypomnienia i pierwsza odpowiedź po godzinach działy się bez człowieka, a telefon nadal służył do całej reszty.

Wiele numerów, jedno kontoAgencja, firma doradcza lub programista

Wielu klientów, każdy z numerem, którego nikomu nie wolno migrować ani ruszać. Potrzebują, żeby te numery były osiągalne dla systemów, które budują, i żeby kolejny numer dało się dodać bez rozmowy z działem sprzedaży. Coexistence to jedyna oficjalna droga do numeru, na który pracownicy klienta nadal odpowiadają ręcznie.

Jak numer trafia do obu miejsc i dokąd idą zdarzenia wiadomości

Cztery kroki. Jedyny, który dotyczy telefonu, to skanowanie, a ten, który decyduje o Twojej architekturze, jest pierwszy.

  1. Przygotuj endpoint przed rozpoczęciem wdrożenia

    Meta weryfikuje miejsce docelowe, zanim cokolwiek do niego dostarczy. Wywołuje Twój URL żądaniem GET z parametrami hub.mode=subscribe, Twoim hub.verify_token i hub.challenge, a Twój endpoint musi odesłać challenge w niezmienionej postaci.

    Miejsce docelowe musi używać HTTPS, a verify token jest obowiązkowy. Sprawdzamy oba, zanim wywołanie zostanie wysłane, więc błędny adres URL odpada już u nas, zamiast wyglądać na połączony i niczego nie dostarczać.

    Wymagane
    Endpoint HTTPS, który odsyła hub.challenge na żądanie GET od Meta
    Czas
    Około minuty
    Otrzymujesz
    Miejsce docelowe, które Meta może zweryfikować w chwili połączenia numeru
    Nic nie jest jeszcze połączone. To decyduje, gdzie trafią wiadomości.
    Dostawca na ścieżce wiadomościPrzechowywane na jego serwerach
    Meta
    Platforma dostawcyOdbiera i przechowuje wiadomości
    TyKopia, według harmonogramu dostawcy
    EasyCoexistenceTylko konfiguracja
    Meta
    Twój endpointJeszcze niezweryfikowany
    MyUstawiamy trasę, ale nie jesteśmy na niej
  2. Uruchom Embedded Signup od Meta i zeskanuj kod w aplikacji

    Otwiera się okno samej Meta. Wybierasz Business Portfolio, konto WhatsApp Business i numer już zarejestrowany w aplikacji WhatsApp Business, a następnie zatwierdzasz połączenie w telefonie, skanując kod.

    Tutaj decydujesz też, czy udostępnić istniejącą historię czatów. To jednorazowa decyzja podejmowana podczas wdrożenia i nie można jej później zmienić. Aplikacja Business działa dalej od chwili zakończenia skanowania.

    Wymagane
    Dostęp do Business Portfolio i telefon z tym numerem
    Czas
    Dwie do trzech minut
    Otrzymujesz
    Cloud API podłączone do numeru, którego aplikacja nadal używa
    Pojawia się drugi kanał. Pierwszy nie znika.
    Po migracjiJeden kanał
    Numer
    Tylko Cloud APIAplikacja Business na tym numerze nie działa
    Po CoexistenceDwa kanały
    Numer
    Aplikacja WhatsApp BusinessTe same czaty i historia
    Cloud APINa tej samej linii
  3. Skieruj zdarzenia wiadomości do własnego systemu

    Meta pozwala aplikacji nadpisać miejsce, do którego trafiają webhooki danego konta WhatsApp Business. Ustawiamy to nadpisanie na Twój URL, dzięki czemu dwa pola ścieżki wiadomości, messages i smb_message_echoes, trafiają prosto od Meta do Ciebie.

    Pola operacyjne zatrzymujemy, bo z nich składa się monitorowanie: account_update, phone_number_quality_update, account_alerts, account_review_update, business_capability_update i phone_number_name_update. Dzięki temu panel pozostaje użyteczny, a treść rozmów nigdy do nas nie trafia.

    Wymagane
    Endpoint z pierwszego kroku, już zweryfikowany przez Meta
    Czas
    Stosowane od razu po zakończeniu wdrożenia
    Otrzymujesz
    Wiadomości dostarczane od Meta do Ciebie, bez nas na ścieżce wiadomości
    Dokąd trafiają poszczególne zdarzenia, gdy nadpisanie jest aktywne.
    Zdarzenia operacyjneDostarczane do nas
    account_updateZmiany stanu połączenia
    phone_number_quality_updateJakość i przepustowość
    account_review_updateWyniki weryfikacji
    Ścieżka wiadomościDostarczane do Ciebie
    messagesWszystko, co wysyła klient
    smb_message_echoesTo, co zespół wysyła z aplikacji
    Twój serwerBezpośrednio, nigdy przez nas
  4. Utrzymaj połączenie i przetrwaj ponowne połączenie

    Meta rozłącza numer Coexistence po mniej więcej czternastu dniach bez aktywności na urządzeniu głównym. Takie rozłączenie można odwrócić, więc zapisujemy je jako osobny stan, a nie jako klienta, który odszedł.

    Pułapka tkwi w tym, co rozłączenie robi z trasą. Meta przechowuje miejsce docelowe jako nadpisanie w subskrypcji naszej aplikacji do konta, więc PARTNER_REMOVED odinstalowuje aplikację, a nadpisanie znika razem z nią. Ponowne połączenie przywraca wysyłanie i monitorowanie, ale nie Twoje miejsce docelowe. Przywracamy je automatycznie, bo pierwszy numer, który trafił na tę zasadę, połączył się ponownie bez problemu i po cichu przestał dostarczać wiadomości na serwer klienta.

    Wymagane
    Aplikacja otwierana od czasu do czasu na urządzeniu głównym
    Czas
    Na bieżąco
    Otrzymujesz
    Połączenie pod stałą obserwacją i trasa, która przetrwa ponowne połączenie
    Co ponowne połączenie przywraca samo, a co trzeba ustawić od nowa.
    Przywracane przez MetaAutomatycznie
    WysyłanieCloud API znów działa
    Zdarzenia operacyjneMonitorowanie wraca
    Znika razem z aplikacjąTrzeba ustawić ponownie
    Nadpisanie Twojego webhookaOdinstalowane razem z aplikacją
    Dostarczanie wiadomości do CiebiePo cichu ustaje
    Ustawiamy je ponowniePrzy każdym ponownym połączeniu

Dlaczego zespoły korzystają z numeru w ten sposób

  • Zachowujesz numer, który jest już wydrukowany na samochodach, paragonach i stronie internetowej, oraz cały mobilny sposób pracy wokół niego.
  • Dodajesz wysyłkę przez API, obsługę webhooków i szablony, nie przenosząc nikogo do nowego narzędzia.
  • Ruch wiadomości nie trafia do wspólnej skrzynki dostawcy, więc rozmowy nie leżą na cudzej platformie.
  • Agencja może trzymać numery wielu klientów na jednym koncie, każdy połączony w Business Portfolio samego klienta.

Warunki i praktyczne ograniczenia

  • Numer musi być już aktywny w aplikacji WhatsApp Business. Numer z konsumenckiej aplikacji WhatsApp trzeba najpierw tam przenieść.
  • Udostępnienie istniejącej historii czatów to jednorazowa decyzja podejmowana podczas wdrożenia i nie można jej później zmienić.
  • Czaty grupowe są wyłączone z API na numerach Coexistence, u każdego dostawcy.
  • Urządzenie główne wymaga okresowej aktywności. Meta rozłącza połączenie po mniej więcej czternastu dniach bez niej.
  • Ścieżki weryfikacji i odznaki Meta wyglądają inaczej dla numerów Coexistence, a dostępność regionalna zmienia się wraz z polityką Meta.
Dowolny tekstod 0 do 24 godzin po ostatniej wiadomości klientaTylko szablonpotem, dopóki klient znów nie napisze
Zegar startuje od nowa za każdym razem, gdy klient coś wyśle. To zasada, która psuje integracje na produkcji, bo testy zawsze odbywają się kilka sekund po wiadomości, kiedy dowolny tekst jeszcze działa.

Co kierujemy do Ciebie, a co zostaje u nas

Meta pozwala aplikacji nadpisać miejsce, do którego konto WhatsApp Business dostarcza swoje webhooki. Ustawiamy to nadpisanie na Twój adres URL, co dzieli zdarzenia na dwie części.

Dostarczane prosto do Twojego endpointuŚcieżka wiadomości. Domyślnie nigdy nie przechodzi przez nas.
  • messagesWszystko, co klient wysyła na numer
  • smb_message_echoesTo, co Twój zespół wysyła z aplikacji WhatsApp Business
Dostarczane do nasŚcieżka operacyjna. Z tego składa się monitorowanie.
  • account_updateStan połączenia: usunięte, wyłączone (offboarded), połączone ponownie, ograniczone
  • phone_number_quality_updateZmiany oceny jakości i przepustowości
  • account_alertsAlerty, które Meta zgłasza wobec konta
  • account_review_updateWyniki weryfikacji przeprowadzonej przez Meta
  • business_capability_updateZmiany limitu wiadomości i możliwości konta
  • phone_number_name_updateZatwierdzenia i odrzucenia nazwy wyświetlanej

Jeśli numer nie ma ustawionego nadpisania, jego zdarzenia wiadomości trafiają do naszego domyślnego callbacku, gdzie handler odrzuca je bez zapisywania. Wymusza to kod, a nie obietnica w polityce: treść rozmów po prostu nie ma żadnej ścieżki do zapisu.

Zasada czternastu dni i to, co psuje, a o czym nikt nie mówi

Meta rozłącza połączenie Coexistence po mniej więcej czternastu dniach bez aktywności na urządzeniu głównym. Można je przywrócić, więc zapisujemy to jako osobny stan, a nie jako klienta, który odszedł.

Kosztowna konsekwencja pojawia się później. Miejsce docelowe Twoich wiadomości nie jest ustawieniem numeru, tylko nadpisaniem w subskrypcji naszej aplikacji do konta WhatsApp Business. Rozłączenie odinstalowuje aplikację, a nadpisanie znika razem z nią. Łączysz ponownie, wysyłanie działa, monitorowanie działa, a wiadomości przestają docierać na Twój serwer i nic nie zgłasza błędu.

Przy każdym ponownym połączeniu ustawiamy nadpisanie od nowa. To zachowanie istnieje, bo ten problem naprawdę wystąpił: numer trafił na tę zasadę, połączył się ponownie bez problemu i po cichu przestał dostarczać wiadomości.

Nieudany handshake w tym momencie, bo Twój serwer nie działał albo zmienił się token, zostaje zapisany na osi czasu połączenia, a miejsce docelowe jest zachowane, a nie usunięte, więc wystarczy zapisać je ponownie, żeby to naprawić.

Co psuje się po cichu i jak się o tym dowiadujemy

Aplikacja WhatsApp Business działa dalej przy niemal każdej z poniższych awarii, dlatego nikt ich nie zauważa. Oto te, które sprawdzamy, i sposób, w jaki to robimy.

Numer został rozłączonyWebhook, źródło rozstrzygające

Wykrywane z webhooka account_update od Meta, konkretnie PARTNER_REMOVED, a nie wnioskowane z pola, które zmienia się na false. Celowo nie odczytujemy do tego is_on_biz_app, bo to pole ma prawidłowo wartość false na numerach, które nie są Coexistence, i powodowało fałszywe rozłączenia.

Połączenie było nieaktywne przez czternaście dniOsobny stan

Zasada Meta dotycząca braku aktywności na urządzeniu głównym. Połączenie można przywrócić, więc zapisujemy to jako osobny stan, a nie jako klienta, który odszedł, a ponowne połączenie przywraca wysyłanie i monitorowanie.

Trasa Twojego webhooka zniknęła po ponownym połączeniuPrzywracane automatycznie

Miejsce docelowe istnieje jako nadpisanie w subskrypcji naszej aplikacji do konta, więc rozłączenie je odinstalowuje. Wysyłanie wraca po ponownym połączeniu, a dostarczanie na Twój serwer nie. Za każdym razem ustawiamy nadpisanie od nowa, bo numer, któremu się to przydarzyło, połączył się ponownie bez problemu i po cichu przestał dostarczać wiadomości.

Token dostępu przestał działaćDwa tokeny, jedna odpowiedź

Przechowujemy token klienta i nasz własny System User token dla tego samego konta. Gdy jeden zostanie odrzucony, drugi odczytuje konto i ustala, który z nich faktycznie przestał działać, więc unieważniony token nie wygląda już jak utracony numer.

Jakość spadłaSprawdzane cyklicznie

Pobierana z Meta według harmonogramu. Ocena RED oznacza połączenie jako pogorszone, a jakość, poziom wiadomości i poziom przepustowości zapisujemy przy każdym sprawdzeniu, więc spadek widać, zanim będzie kosztował nieudaną wysyłkę.

Podłączenie numeru i pilnowanie numeru to dwa różne produkty. Ten drugi jest powodem, dla którego to istnieje.

2 minutes

Typowy czas połączenia numeru po zeskanowaniu kodu w aplikacji WhatsApp Business.

24 hours

Jak długo odpowiedź klienta utrzymuje sesję otwartą dla zwykłych wiadomości tekstowych.

20 msg/s

Przepustowość wysyłania dla numeru Coexistence, ustalana przez Meta i niemożliwa do zwiększenia.

6 months

Ile historii czatów Meta synchronizuje z API przy pierwszym połączeniu numeru.

Najczęściej zadawane pytania

Czy mój zespół musi przestać korzystać z telefonu?

Nie. Na tym właśnie polega Coexistence. Aplikacja WhatsApp Business nadal działa na tym samym numerze i z tymi samymi rozmowami, a API działa równolegle.

Czy stracę istniejące rozmowy?

Nie. Zostają w aplikacji, a przy połączeniu numeru Meta synchronizuje z API około sześciu miesięcy historii, dzięki czemu oprogramowanie ma kontekst i nie zaczyna od pustej rozmowy.

Czy mogę to cofnąć?

Tak. Numer można odłączyć, a aplikacja będzie działać jak wcześniej. Samo połączenie nie zmienia numeru w sposób trwały.

Czy to to samo co nieoficjalne API WhatsApp?

Nie, a ta różnica decyduje o tym, czy numer przetrwa. Coexistence to oficjalna funkcja Meta w Cloud API. Nieoficjalne bramki sterują WhatsApp Web jako połączonym urządzeniem, co łamie zasady i prowadzi do blokowania numerów.

Gotowy, aby zacząć?

Skonfiguruj WhatsApp Coexistence w kilka minut, nie miesięcy. Aplikacja nadal działa na telefonie.

Rozpocznij bezpłatny okres próbny3 dni bezpłatnie. Nic nie pobieramy przed końcem okresu próbnego.

Czytaj dalej