WhatsApp Business App Coexistence Onboarding (Embedded Signup)
This guide explains how to onboard existing WhatsApp Business App users to Cloud API using Embedded Signup coexistence mode.
Quick answer
Enable `featureType=whatsapp_business_app_onboarding`, subscribe to required coexistence webhooks, capture FINISH onboarding session events, skip phone registration for already-registered numbers, then initiate contact and history synchronization.
Requirements checklist
- Embedded Signup implemented with session logging.
- Webhook endpoint can ingest high-volume coexistence payloads.
- Customer app version supports coexistence flow.
- Operational plan to run onboarding + synchronization promptly.
Implementation flow
- Subscribe app to coexistence webhook fields (history, contact sync, message echoes).
- Set Embedded Signup extras `featureType` to `whatsapp_business_app_onboarding`.
- Surface the coexistence flow to customers and complete onboarding.
- On FINISH event, capture IDs/token code and continue onboarding logic.
- Skip phone registration for already-registered business app numbers.
- Initiate contact sync, then history sync, then mirror new app-originated messages.
Operational notes
- Coexistence numbers have fixed throughput constraints compared with pure Cloud API setups.
- Some message types/features are not mirrored/supported exactly the same way.
- Expect occasional unsupported webhook events during sync and handle gracefully.
- If customers disconnect/re-register, watch account update events and automate recovery workflows.
Reference
Source documentation: Meta Embedded Signup Coexistence Guide