Słownik WhatsApp Coexistence
Pojęcia związane z WhatsApp Coexistence łatwo pomylić. W praktyce większość nieporozumień wynika z tego, że dwie osoby używają jednego słowa na określenie różnych rzeczy. Poniżej znajdziesz definicje używane w tym serwisie, każda z odnośnikiem do strony, która omawia ją dokładniej.
EasyCoexistence łączy numer przez własny proces Meta, a następnie monitoruje połączenie.
- Coexistence
Oficjalny tryb Meta, w którym aplikacja WhatsApp Business i Cloud API działają jednocześnie na jednym numerze. To nie osobne API: to samo Cloud API, wdrożone tak, aby aplikacja dalej działała.
WhatsApp Coexistence- Cloud API
API platformy WhatsApp Business hostowane przez Meta. Każda wysyłka, każdy szablon i każdy webhook w tym serwisie przechodzą przez nie.
Cloud API czy Coexistence- Aplikacja WhatsApp BusinessWhatsApp Business app
Aplikacja, której firma używa na telefonie. Różni się od zwykłej aplikacji WhatsApp, a numer musi w niej być, zanim Coexistence będzie mogło go połączyć.
- Konto WhatsApp BusinessWABA
Obiekt Meta, który przechowuje numery telefonów i szablony. Znajduje się w Business Portfolio. Nadpisania webhooka stosuje się na tym poziomie, a nie dla każdego numeru osobno.
- Business Portfolio
Kontener na poziomie firmy w Meta Business Manager. Zawiera jedno lub więcej kont WhatsApp Business. Numer klienta pozostaje w jego portfolio, a nie w portfolio dostawcy.
Meta Tech Provider- Phone number id
Identyfikator Meta dla jednego połączonego numeru. Wysyłka kieruje się do niego, a nie do samego numeru, i pojawia się on w każdym payloadzie przychodzącego webhooka.
- Embedded Signup
Własne okno wdrożenia Meta. Wybiera się w nim portfolio, konto i numer, a w przypadku Coexistence zawiera kod skanowany w aplikacji WhatsApp Business.
Jak łączy się numer- Tech Provider
Status w Meta, który pozwala firmie łączyć numery innych firm przez własną zatwierdzoną aplikację. Jest bezpłatny, ale wymaga weryfikacji firmy i App Review. Nie oznacza poparcia ze strony Meta.
Co to oznacza- BSPBusiness Solution Provider
Firma sprzedająca platformę do komunikacji, zwykle wspólną skrzynkę odbiorczą. Pokrywa się z Tech Provider, ale opisuje produkt, a nie status w Meta.
Coexistence czy BSP- Miejsce docelowe webhookaWebhook destination, webhook override
Miejsce, do którego Meta dostarcza zdarzenia konta WhatsApp Business. Ustawia się je jako nadpisanie w subskrypcji aplikacji, dlatego usunięcie połączenia je odinstalowuje.
Webhooki WhatsApp- hub.challenge
Wartość, którą Meta wysyła w weryfikacyjnym żądaniu GET. Endpoint musi zwrócić ją jako surową treść odpowiedzi. Zwrócenie zamiast niej JSON to najczęstszy powód, dla którego webhook nigdy niczego nie odbiera.
Weryfikacja webhooka- messages
Pole webhooka, które przenosi to, co wysyłają klienci. Część ścieżki wiadomości, czyli tego, co nadpisanie webhooka odsuwa od dostawcy.
- smb_message_echoes
Pole webhooka, które przenosi to, co zespół wysyła z aplikacji WhatsApp Business. Istnieje tylko na numerach Coexistence i dzięki niemu oprogramowanie widzi odpowiedzi człowieka.
- Okno obsługi klientaCustomer service window, okno 24-godzinne
Dwadzieścia cztery godziny od ostatniej wiadomości klienta, w ciągu których dostarczany jest dowolny tekst. Poza nim dostarczany jest tylko zatwierdzony szablon.
Błąd 131047- SzablonTemplate
Wiadomość przesłana wcześniej do Meta do sprawdzenia. Jedyna rzecz, która dociera poza oknem obsługi klienta, a na numerze Coexistence można ją wysłać tylko przez API.
Błąd 132001- Ocena jakościQuality rating
Zielona, żółta lub czerwona, nadawana przez Meta na podstawie reakcji odbiorców. Spada, zanim zacznie Cię to cokolwiek kosztować, i nic nie zapowiada tego spadku.
Błąd 131048- Poziom wiadomościMessaging tier
Z iloma unikalnymi klientami numer może rozpocząć rozmowy w ciągu doby. Zmienia się w obu kierunkach. Różni się od przepustowości, która jest tempem.
- PrzepustowośćThroughput
Ile wiadomości na sekundę może wysłać numer. Na numerze Coexistence ustala ją na stałe Meta, zamiast skalować ją wraz z jakością i poziomem.
Błąd 130429- Połączone urządzenieLinked device
Zwykły klient WhatsApp zalogowany w innym miejscu, tak jak robi to WhatsApp Web. To właśnie automatyzują nieoficjalne narzędzia, tego zabraniają warunki WhatsApp i przez to numery są blokowane.
Ryzyka nieoficjalnego API- MCPModel Context Protocol
Sposób, w jaki asystent AI dociera do narzędzia, które nie jest jego. Tylko żądanie i odpowiedź: przychodząca wiadomość nie może obudzić serwera MCP.
Serwer MCP dla WhatsApp
Dlaczego słownictwo powoduje tyle problemów?
Ponieważ kilka z tych pojęć oznacza rzeczy znajdujące się na różnych poziomach, które wszystkie wydają się należeć do tego samego poziomu.
Business Portfolio zawiera WhatsApp Business Account, który zawiera numery telefonów, a każdy z nich ma phone number id. W rozmowie wszystkie cztery elementy bywają nazywane kontem, więc zdanie „sprawdź, czy konto działa” może oznaczać cztery różne kontrole. To samo dotyczy dwóch dwudziestoczterogodzinnych okien na tej platformie. Mierzą one niezależne rzeczy i są stale ze sobą mylone.
Drugą przyczyną jest to, że Meta i dostawcy używają różnych określeń na tę samą rzecz, a sami dostawcy również nie są zgodni. Ta strona używa słownictwa Meta tam, gdzie jest ono dostępne, i jasno wskazuje, gdy dane pojęcie pochodzi od nas.
Które rozróżnienia naprawdę mają znaczenie w praktyce?
Trzy, a każde z nich kosztowało kogoś cały dzień pracy.
Okno obsługi klienta i okno synchronizacji trwają po dwadzieścia cztery godziny, ale nie mają ze sobą nic wspólnego. Jedno określa, czy zwykły tekst zostanie dostarczony, licząc od ostatniej wiadomości klienta. Drugie określa, czy historię czatu można jeszcze pobrać, licząc od momentu wdrożenia.
Połączone urządzenie nie jest API. To klient WhatsApp dla użytkowników, zalogowany w innym miejscu. Właśnie to automatyzują nieoficjalne narzędzia i właśnie dlatego numery bywają blokowane.
Miejsce docelowe webhooka nie jest ustawieniem numeru. To nadpisanie subskrypcji aplikacji dotyczącej konta. Dlatego znika po usunięciu połączenia i trzeba je ponownie ustawić po ponownym połączeniu.
Najczęściej zadawane pytania
Czy Coexistence to inne API niż Cloud API?
Nie. Coexistence to sposób wdrożenia numeru do Cloud API, który pozostawia działającą na nim aplikację WhatsApp Business. Endpointy, format wiadomości i zasady są identyczne.
Jaka jest różnica między Business Portfolio a WABA?
Business Portfolio to kontener firmy na poziomie Meta Business Manager. WhatsApp Business Account znajduje się w nim i przechowuje numery telefonów. Jedno portfolio może zawierać kilka WABA.
Czy BSP to to samo co Tech Provider?
Te pojęcia częściowo się pokrywają, ale oznaczają różne rzeczy. Tech Provider to status Meta pozwalający firmie łączyć numery innych firm przez własną aplikację. BSP zwykle oznacza firmę sprzedającą platformę do obsługi wiadomości, która może mieć ten status, ale nie musi.
Co MCP ma wspólnego z WhatsApp?
Samo w sobie nic. MCP to protokół zapewniający asystentowi AI dostęp do narzędzia, a serwer WhatsApp MCP udostępnia numer jako jedno z takich narzędzi. Nie może odbierać wiadomości, lecz tylko działać na żądanie.
Gotowy, aby zacząć?
Skonfiguruj WhatsApp Coexistence w kilka minut, nie miesięcy. Aplikacja nadal działa na telefonie.
Rozpocznij bezpłatny okres próbnyPrzez 3 dni nic nie zapłacisz. Anuluj w dowolnym momencie.