Onboarding

Link your WhatsApp Business App to the Cloud API using Meta's Embedded Signup flow.

Option A — Embedded Signup (production)

Shows Meta's official popup. Business admin scans the QR code with their WhatsApp Business App. This option requires your Meta app to have Tech Provider status and an Embedded Signup config_id. See the Tech Provider steps at the bottom of this page.

Option B — Manual test number (development)

Every Meta developer app gets a free WhatsApp test number you can use immediately — no Tech Provider approval needed. Paste its credentials into Settingsand you're live.

  1. Go to developers.facebook.com/apps and create a Business-type app.
  2. Add the WhatsApp product.
  3. On the WhatsApp → API Setup page, copy the test number's Phone Number ID, WABA ID, and temporary access token.
  4. Paste them into Settings. Save.
  5. Add your own WhatsApp number as a recipient in the same API Setup page (test numbers can only message 5 pre-approved recipients).

How the QR scan actually works (behind the Embedded Signup popup)

  1. Admin clicks Connect via WhatsApp Business App.
  2. Meta opens the Embedded Signup popup on top of this page.
  3. Admin signs into Facebook and picks the Meta Business account that owns the phone number.
  4. The popup shows a QR code. Admin opens WhatsApp Business App → Settings → Linked Devices → Link a device → scans the code.
  5. Meta provisions a Cloud API session tied to the same number. Phone app keeps working.
  6. Popup returns a short-lived code to this page. We POST it to /api/embedded-signup/exchange, which swaps it for a long-lived WABA access token and subscribes the webhook.
After this, the phone app must be opened at least once every 14 days to keep the Cloud API link alive.