Skip to main content
Prelude lets you send OTP verification messages from your branded WhatsApp number by connecting your WhatsApp Business Account (WABA) through Meta’s Embedded Signup flow. This guide covers each onboarding scenario to help you connect successfully.
If you encounter any issues while following this guide, either contact our support team or reach out to your Meta Account Manager for assistance with account or number provisioning.
1

Prerequisites

Before you begin the onboarding flow, make sure you:
  • have contacted your Meta account manager to ensure access is enabled for your business.
  • are a member of the Meta Business Manager (formerly Facebook Business Manager) with the appropriate admin or developer permissions. If you are not, ask your Business Admin to grant you access.
  • have access to the phone number you plan to use with WhatsApp Business, or you’re willing to use a free test number provided by Meta.
  • have a valid payment method associated with your WhatsApp Business Account. You can configure this here: WhatsApp Billing Settings. Messages will not be sent if billing is not configured correctly.
  • have your WhatsApp Business Account (WABA) approved by Meta. If your WABA is still pending approval, the integration will fail. You can check your WABA status in the WhatsApp Manager.
OTP WhatsApp message templates will be automatically created on your account by Prelude.Do not delete these templates — they are required for the integration to work properly.
Currently, Meta directly handles billing for WhatsApp messages. Prelude will not bill you for any WhatsApp messages sent.
2

Start the integration from the Prelude dashboard

  1. Log in to the Prelude dashboard.
  2. Navigate to Settings → Integrations → Providers.
  3. Click Connect with Facebook. This opens Meta’s Embedded Signup popup.
3

Complete the embedded signup flow

This popup guides you through linking your WhatsApp Business Account. Here’s what you may encounter:
If you already have a Meta Business Manager and a WhatsApp Business Account with an approved phone number:
  1. Select your Business Manager.
  2. Select your WhatsApp Business Account (WABA).
  3. Choose the Phone Number.
  4. Approve all permissions.
  5. Click the blue “Finish” button. The popup will close and the page will begin linking your account. This can take up to a minute. Stay on the page until it completes.
  6. After the spinner disappears, the page will refresh and display your WhatsApp Business Account details.
  1. The popup will prompt you to create a Business Manager.
  2. Fill in the basic details: business name, email, website (optional).
  3. Submit the form and wait for the Business Manager to be provisioned.
  4. Continue by selecting the new Business Manager in the next steps.
  1. You will be prompted to create a WABA linked to your Business Manager.
  2. Name your WABA and continue.
  3. Meta will create the WABA in real time. You can then add a number.
  1. You will be prompted to add a new number.
  2. You can enter your own number or use a free number provided by Meta.
  3. Once verified, the number will appear in the dropdown for selection.
Free numbers behave like standard business numbers, with some important differences:
  1. Typically use a US country code (+1) and a 555 area code.
  2. Are verified automatically.
  3. Can’t be migrated to another WhatsApp Business Account or used outside of the WhatsApp Business platform.
  4. The display name must still be approved, and the number remains subject to conversation-based pricing and quality ratings.
4

Finalize and verify the integration

After completing the popup:
  1. Make sure you clicked the blue “Finish” button to trigger the account linking process.
  2. Wait for the page to reload—it can take up to a minute.
  3. The section will refresh automatically and display your linked WhatsApp account.
  4. The connected phone number will appear in the list of available providers.
  5. Prelude will begin routing OTP messages through your branded WhatsApp number.
5

Open the WhatsApp channel on routes

Once integration is complete, don’t forget to:
  1. Navigate to Settings → Routes.
  2. Enable the WhatsApp channel for the routes where you want to use it.
6

Personalize your WhatsApp profile

You can customize your WhatsApp Business profile after onboarding by visiting the WhatsApp Manager.

​
Troubleshooting

If you encounter any issues while following this guide, please check the troubleshooting section below.
Remove it from the current WABA in WhatsApp Manager, or release it from the WhatsApp app.
Ensure all Meta/Facebook permissions were granted during the flow.
Ask your admin to add you with the appropriate permissions.
Clear cookies or try using a private browser window.
Ensure you added a valid payment method to the WhatsApp Business billing settings—not your ad account.
If you still need help after checking the troubleshooting section, either contact our support team or reach out to your Meta Account Manager for assistance with account or number provisioning.