Embedded Signup connects your Edesy number to the WhatsApp Business Platform through Meta's own Facebook login window. You click Connect with Facebook, approve the WhatsApp permissions, and Edesy exchanges the result for an access token, finds your WhatsApp Business Account and phone number, and turns messaging on. There are no IDs or tokens to copy by hand.
Facts#
| Item | Detail |
|---|---|
| Where | wa-connect.edesy.in > Numbers > Enable Messaging |
| Steps | Prepare, Connect, Verify, Done. Resumable: close the tab and the wizard reopens at the same step |
| Pre-flight checklist | Where the number is today, a full-control Meta business admin, a live business website, a computer with pop-ups allowed, wallet balance for one forwarded call. About 10 minutes |
| Verification call | Forwarded from your Edesy number to your own phone for 20 minutes while you are in Meta's window. Billed like normal call forwarding |
| Display name | Checked as you type. See Display Name Rules |
| Not the Meta admin? | Invite the admin to your workspace from the setup page |
| What Edesy does | Exchanges the signup code server-side, resolves the WABA ID and phone number ID, subscribes to the WABA's message webhooks, registers the number, saves the connection |
| Errors | Meta's error codes are shown with a plain-language explanation and what to do next |
| Token storage | The access token is encrypted at rest and never returned by the API |
| Recorded as | onboarding_method: "embedded_signup" on the number's configuration |
| Fallback | Advanced: for developers who already run a Meta app. See Bring Your Own WABA |
How it works#
- Prepare. On Numbers > My Numbers, click Enable Messaging. Say where the number is today. If it is on the WhatsApp or WhatsApp Business app, delete the account there first (WhatsApp > Settings > Account > Delete my account); if another provider or WhatsApp Manager has it, delete it there. Tick the checklist.
- Connect: forward Meta's call. Enter your own phone number with country code. For the next 20 minutes, calls to your Edesy number ring that phone. If the number is already verified in your Meta account, skip this.
- Connect: Connect with Facebook. A Facebook window opens. Pick or create your business and WhatsApp Business Account, add the number, choose Phone call to verify it, and enter a display name. Approve the WhatsApp permissions.
- Verify. Meta calls your Edesy number, the call rings your phone, and you enter the 6-digit code in Meta's window.
- Done. The temporary forwarding rule is removed and the number's usual call routing comes back. The page shows a checklist: add a webhook, create a template, send a test message.
If the Facebook window does not open, allow pop-ups for the site and try again. To change the phone that receives Meta's call, use Stop forwarding / use a different phone.
API#
The portal calls this endpoint after the Facebook window closes. You only need it if you build your own onboarding page with your own Facebook login setup.
| Field | Type | Required | Description |
|---|---|---|---|
pool_number_id |
string (UUID) | Required | The number from Get a Number |
code |
string | Required | Authorization code returned by the Facebook login window |
waba_id |
string | Optional | WABA ID from the signup session, if available. Resolved from the token when empty |
meta_phone_id |
string | Optional | Meta phone number ID, if available. Resolved from the WABA when empty |
Before opening the Facebook window, the portal starts the 20-minute call forwarding with:
POSThttps://voice-api.edesy.in/v1/whatsapp/verify/embedded/prepare with pool_number_id and forwarding_number (E.164). It returns a session with forwarding_number and expires_at. DELETE/v1/whatsapp/verify/{session_id} stops it early. If the number already has a forwarding rule, the response is FORWARDING_ACTIVE.
To resume, GEThttps://voice-api.edesy.in/v1/whatsapp/numbers/{pool_number_id}/setup-status reports where setup stopped (for example forwarding or verifying) and any active session.
The response is the number's WhatsApp configuration (waba_id, meta_phone_id, display_name, quality_rating, messaging_limit, is_verified, is_enabled and more).
FAQ#
What is Embedded Signup?#
It is Meta's official flow for connecting a WhatsApp Business Account to a platform through a Facebook login window, without copying credentials.
Do I need a Facebook account?#
Yes. You sign in with a Facebook account that can manage your Meta business.
What if the Connect with Facebook button is missing?#
The wizard then opens the manual path. Use Bring Your Own WABA.
Does Edesy see my Facebook password?#
No. You sign in on Meta's window. Edesy receives a short-lived code from Meta and exchanges it on the server.
Where is the access token stored?#
It is encrypted at rest in Edesy's database and is never returned in API responses.
What does the display name come from?#
The name you enter in Meta's window, after Meta's review. The portal checks it against Meta's rules first; see Display Name Rules.
How long is Meta's call forwarded to my phone?#
20 minutes from the Connect step. Stop it early, or switch phones, with Stop forwarding / use a different phone. Forwarded calls are billed like normal call forwarding.
I'm not the admin of my Meta business. What now?#
Only a full-control admin in Meta Business Suite can finish the Facebook step. Invite the admin from the setup page; they sign in to your workspace and complete it.
Can I stop halfway?#
Yes. Setup is resumable. The wizard reopens at the step where you stopped, including an active forwarding session.
What should I do after signup?#
Add a webhook to receive messages, create a template, and send a test message. The success screen links to each.