
What is Embedded Signup?
Embedded Signup is Meta’s recommended onboarding flow for Tech Provider apps like Galantis. Instead of asking you to set things up in Meta Business Manager and copy access tokens, the modal walks you through everything in one place and returns the credentials Galantis needs automatically. From your point of view, it’s a single pop-up with 5–7 steps.You don’t need a pre-existing WABA or Meta access token. The modal creates them for you if needed — or attaches your existing ones if you have them.
Before you start
- Have your Facebook or Meta Business credentials ready (the email and password you use to log into Meta Business Manager)
- Decide which phone number you’ll connect — see Choose a phone number
- Make sure the number can receive an SMS or voice call for verification
- If you’re migrating from the WhatsApp Business mobile app, keep the device with the app available — Meta may ask you to confirm the migration there
Pick your starting point
- I'm new to WhatsApp Business Platform
- I already have a WhatsApp Business Account
- I'm currently using the WhatsApp Business app
You’re setting up your first WhatsApp Business Account. The modal will create your WABA, attach a phone number, and verify it — all in one pass.
Open the Galantis app and click Connect WhatsApp
On the in-app onboarding screen (or under Settings → WhatsApp Connection afterward), click Connect WhatsApp. Meta’s Embedded Signup modal opens inside the app.
Log in to Facebook / Meta
Use the Facebook account that administrates (or will administrate) your Meta Business. If you’re not signed in, the modal shows the standard Facebook login screen.
Choose or create your Meta Business
Select an existing Meta Business if you already have one (for example, for Facebook/Instagram ads). Otherwise create one in the modal — give it your store name and confirm your country.
Create your WhatsApp Business Account (WABA)
Confirm the name of your WABA. This is internal — customers don’t see it; they see your phone number’s display name.
Add your phone number
Enter the number you decided on in Choose a phone number. Meta will send a 6-digit code via SMS or voice call — enter it in the modal to confirm ownership.
Set your display name
Pick the name customers will see in WhatsApp alongside your number — typically your store or brand name. Meta reviews display names; approval is usually quick but can take 1–2 business days. See Meta’s guidelines for naming rules.
How to know it worked
Once the modal closes successfully, three things confirm the connection:WhatsApp tab in Galantis
The Galantis dashboard shows your connected WABA name, phone number, and display name under Settings → WhatsApp Connection.
Verified status
The number shows a “Verified” or “Pending verification” badge. Marketing-category messages require display-name approval (1–2 days); utility-category messages are sendable immediately.
Test message
From Templates, send a test utility template to your own phone. A delivered message is the cleanest proof the connection works end-to-end.
Adding more numbers later
You can attach additional phone numbers to the same WABA after the initial connection — useful as your store scales to multiple brands, regions, or message types. Open Settings → WhatsApp Connection → Add number to re-launch the Embedded Signup modal for the additional number. See Multiple phone numbers for when and why to use more than one.Troubleshooting
The modal won't open or closes unexpectedly
The modal won't open or closes unexpectedly
Check your browser’s pop-up blocker — the Embedded Signup modal is a Facebook-hosted pop-up. Allow pop-ups for the Galantis app domain and try again. If you’re using strict privacy extensions, temporarily disable them for this session.
Verification SMS / call never arrives
Verification SMS / call never arrives
Make sure the number is correct including country code, and that it can receive international SMS or calls. Retry in the modal — Meta sends a new code each time. If the number is a VoIP or toll-free number, it may not be supported; check Meta’s phone number requirements.
Display name was rejected
Display name was rejected
Meta rejects names that contain URLs, email addresses, promotional language (“Best”, “Cheap”, “Sale”), all-caps shouting, or that don’t match your brand. Resubmit with a clear brand-aligned name. See Meta’s display name guidelines.
Migration from WhatsApp Business app fails
Migration from WhatsApp Business app fails
The modal will explain the specific reason — usually an owner mismatch (the Meta Business doing the migration is different from the one that originally registered the number) or a Meta-side hold. Contact Galantis support with the modal’s error message and we’ll guide the next step.
I need to disconnect and reconnect later
I need to disconnect and reconnect later
See the Technical reference: connecting WABA for token expiry handling, reconnection, and how the Cloud API access token is stored and refreshed.
Send your first campaign
With a connected number, create a template and send your first WhatsApp broadcast.
Technical reference: connecting WABA
OAuth scopes, token storage, reconnection, and what Galantis does behind the scenes.