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.
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.
Zespół odpowiada z telefonu. Niczego nie da się zautomatyzować, podłączyć ani zmierzyć.
Bez APIOprogramowanie ma dostęp do numeru. Aplikacja Business przestaje na nim działać, a zespół zmienia narzędzia.
Bez aplikacjiMeta 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.
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.
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.
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ć.
Nic nie jest jeszcze połączone. To decyduje, gdzie trafią wiadomości. Dostawca na ścieżce wiadomościPrzechowywane na jego serwerachPlatforma dostawcyOdbiera i przechowuje wiadomościTyKopia, według harmonogramu dostawcyEasyCoexistenceTylko konfiguracjaTwój endpointJeszcze niezweryfikowanyMyUstawiamy trasę, ale nie jesteśmy na niejUruchom 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.
Pojawia się drugi kanał. Pierwszy nie znika. Po migracjiJeden kanałTylko Cloud APIAplikacja Business na tym numerze nie działaPo CoexistenceDwa kanałyAplikacja WhatsApp BusinessTe same czaty i historiaCloud APINa tej samej liniiSkieruj 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.
Dokąd trafiają poszczególne zdarzenia, gdy nadpisanie jest aktywne. Zdarzenia operacyjneDostarczane do nasŚcieżka wiadomościDostarczane do CiebiemessagesWszystko, co wysyła klientsmb_message_echoesTo, co zespół wysyła z aplikacjiTwój serwerBezpośrednio, nigdy przez nasUtrzymaj 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.
Co ponowne połączenie przywraca samo, a co trzeba ustawić od nowa. Przywracane przez MetaAutomatycznieWysyłanieCloud API znów działaZdarzenia operacyjneMonitorowanie wracaZnika razem z aplikacjąTrzeba ustawić ponownieNadpisanie Twojego webhookaOdinstalowane razem z aplikacjąDostarczanie wiadomości do CiebiePo cichu ustajeUstawiamy 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.
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.
messagesWszystko, co klient wysyła na numersmb_message_echoesTo, co Twój zespół wysyła z aplikacji WhatsApp Business
account_updateStan połączenia: usunięte, wyłączone (offboarded), połączone ponownie, ograniczonephone_number_quality_updateZmiany oceny jakości i przepustowościaccount_alertsAlerty, które Meta zgłasza wobec kontaaccount_review_updateWyniki weryfikacji przeprowadzonej przez Metabusiness_capability_updateZmiany limitu wiadomości i możliwości kontaphone_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.
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.
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.
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.
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.
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.
Typowy czas połączenia numeru po zeskanowaniu kodu w aplikacji WhatsApp Business.
Jak długo odpowiedź klienta utrzymuje sesję otwartą dla zwykłych wiadomości tekstowych.
Przepustowość wysyłania dla numeru Coexistence, ustalana przez Meta i niemożliwa do zwiększenia.
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.