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.
- Coexistence
Meta's official mode for running the WhatsApp Business app and the Cloud API on one number at the same time. Not a separate API: the same Cloud API, onboarded so the app keeps working.
WhatsApp Coexistence- Cloud API
Meta's hosted WhatsApp Business Platform API. Every send, template and webhook on this site runs through it.
Cloud API or Coexistence- WhatsApp Business app
The app a business uses on a phone. Distinct from the consumer WhatsApp app, and a number must be on it before Coexistence can connect it.
- WhatsApp Business AccountWABA
The Meta object that holds phone numbers and templates. Sits inside a Business Portfolio. Webhook overrides are applied at this level rather than per number.
- Business Portfolio
The company level container in Meta Business Manager. Holds one or more WhatsApp Business Accounts. A client's number stays in their portfolio, not a provider's.
Meta Tech Provider- Phone number id
Meta's identifier for one connected number. Sending targets this rather than the number itself, and it appears in every inbound webhook payload.
- Embedded Signup
Meta's own onboarding popup. Picks the portfolio, the account and the number, and for Coexistence includes a code scanned in the WhatsApp Business app.
How a number connects- Tech Provider
A Meta status permitting a company to connect other businesses' numbers through its own approved app. Free to obtain, gated on business verification and App Review. Not an endorsement.
What it means- BSPBusiness Solution Provider
A company selling a messaging platform, usually a shared inbox. Overlaps with Tech Provider but describes the product rather than the Meta status.
Coexistence or a BSP- Webhook destinationwebhook override
Where Meta delivers a WhatsApp Business Account's events. Set as an override on an app's subscription, which is why removing a connection uninstalls it.
WhatsApp webhooks- hub.challenge
A value Meta sends in its verification GET. The endpoint must return it as the raw body. Returning JSON instead is the most common reason a webhook never receives anything.
Webhook verification- messages
The webhook field carrying what customers send. Part of the message path, which is what a webhook override routes away from a provider.
- smb_message_echoes
The webhook field carrying what a team sends from the WhatsApp Business app. Only exists on Coexistence numbers, and is how software sees a human's replies.
- Customer service windowthe 24 hour window
Twenty four hours from the customer's last message, during which free text delivers. Outside it, only an approved template does.
Error 131047- Template
A message submitted to Meta for review in advance. The only thing that delivers outside the customer service window, and on a Coexistence number it can only be sent through the API.
Error 132001- Quality rating
Green, yellow or red, assigned by Meta from how recipients react. Falls before it costs anything, and nothing announces the fall.
Error 131048- Messaging tier
How many unique customers a number may start conversations with per day. Moves in both directions. Distinct from throughput, which is a rate.
- Throughput
Messages per second a number may send. Fixed by Meta on a Coexistence number rather than scaling with quality and tier.
Error 130429- Linked device
The consumer WhatsApp client signed in elsewhere, as WhatsApp Web does. What unofficial tools automate, what WhatsApp's terms prohibit, and what gets numbers banned.
Unofficial API risks- MCPModel Context Protocol
How an AI assistant reaches a tool it does not own. Request and response only: an MCP server cannot be woken by an incoming message.
WhatsApp MCP server
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 7 dni nic nie zapłacisz. Anuluj w dowolnym momencie.