WhatsApp embedded signup
Use embedded signup to connect Braze to a WhatsApp Business Account (WABA) through Meta’s hosted signup flow.
The WhatsApp embedded signup workflow opens when you first integrate WhatsApp into your Braze workspace, and when you add a WhatsApp Business account or phone number to an existing integration.
You can add multiple WhatsApp Business Accounts to a Braze workspace. However, each specific WhatsApp Business Account can be added to only one Braze workspace.
Accessing the workflow
- Go to Partner Integrations > Technology Partners.
- Search for and select WhatsApp.
- Select the option that matches your use case:
- First-time integration: Select Begin Integration.
- Additional account or number: On the WhatsApp Messaging Integration page, select Add account or number or Add WhatsApp Business Account.
The Meta embedded signup flow is the same after you launch it from either entry point. Your workspace may also show integration tabs, such as Native Integration or BYO Connector - Infobip, depending on your configuration. Select the tab that matches your setup before you begin.
Prepare for signup
When you select Begin Integration, Braze opens an onboarding window. Review each slide, then select Begin Integration again to launch Meta embedded signup.
Before you start, prepare the following:
- Meta Business Manager access: Most companies use Meta Business Manager to manage Facebook Pages, Ads, and related business assets. If you don’t have access, ask an admin to grant permissions or create a Business Manager account during signup.
- Phone number: Use a number that meets Meta’s WhatsApp phone number requirements. You’ll receive a one-time verification code by text message or phone call during signup.
You’ll only complete the initial embedded signup once per integration path, so enter your business details as accurately as possible.
WhatsApp embedded signup workflow
After Braze launches Meta embedded signup, sign in with a Meta account that has access to your company’s Business Manager. Meta hosts the signup screens; Braze doesn’t control their layout or labels.
Meta may change embedded signup screens without notice. If the workflow differs from this article, follow Meta’s prompts and refer to Meta’s embedded signup documentation.
In general, Meta guides you through:
- Sign in and grant permissions. Authenticate with Meta and allow Braze to connect to your WhatsApp Business Account.
- Select your business portfolio. Connect the Business Manager portfolio that should own the WhatsApp Business Account. If you don’t see the portfolio you expect, confirm your Meta permissions.
- Connect or create a WhatsApp Business Account. Create a new account or select an unused account when prompted. Don’t select a WhatsApp Business Account that’s actively connected to another messaging provider; that connection won’t succeed in Braze. To migrate a number from another provider, contact your Braze account team before you begin.
- Provide business and display details. Enter the account name, display name, and category Meta requests for your WhatsApp Business Account.
- Verify your phone number. Add the number you want to use for WhatsApp messaging and complete verification by text message or phone call.
When Meta finishes embedded signup, control returns to Braze.
Complete the Braze integration
After embedded signup, Braze runs setup steps automatically. On the WhatsApp Messaging Integration page, you may see progress messages such as Sign-up flow completed, integration with WhatsApp in progress while Braze does the following:
- Retrieves your WhatsApp Business Account ID and phone numbers from Meta
- Adds the Braze system user to your WhatsApp Business Account
- Registers phone numbers and subscribes to webhook events
- Creates a Braze subscription group for each connected number
Wait until integration completes before you send messages. If setup fails, review the error on the integration page and see WhatsApp setup for general guidance.