Create or Link an Existing WABA through Embedded Sign-Up

What It Is: If you already have a WhatsApp Business Account, you can link it directly to our platform using the embedded sign-up process provided by our Business Solutions Provider (BSP) integration.
How It Works: Through our platform, you’ll be guided to link your existing WABA seamlessly. This process is straightforward and allows you to maintain control over your existing account while leveraging the features and tools available on our platform.
Who It’s For: This option is perfect for businesses that already have an established WhatsApp presence and want to integrate their existing WABA with our platform without creating a new account. Even though your business doesn't have a WABA created, you can create a new one by yourself easily from our platform.

In this section, we are going to provide a detailed explanation of the embedded signup process, including its key features, and outline the steps required to link your WABA account to our platform.

What is Embedded Sign-Up?

Embedded Signup is a way for Solution Partners to let businesses onboard to the WhatsApp Business API directly from our platform. Therefore, the embedded sign-up process is a seamless and efficient method that allows you to link your existing WhatsApp Business Account (WABA) directly to our platform. This process is designed to simplify the integration by guiding you through each step without requiring extensive technical knowledge.

Key features of Embedded Sign-Up:

Streamlined Integration: The embedded sign-up is fully integrated into our platform, meaning you don’t have to leave our system or navigate multiple interfaces. Everything is handled in one place, making the process quick and user-friendly.
Maintains Account Control: By using the embedded sign-up, you retain full control over your existing WABA. This ensures that you can continue to manage your WhatsApp communications as usual, while also taking advantage of the additional features and tools offered by our platform.
Guided Process: Our platform provides clear, step-by-step instructions throughout the embedded sign-up, ensuring that you understand each stage of the integration. This helps to minimize any potential errors and speeds up the overall setup time.
Self-Service Option: Even if you don’t already have a WABA, the embedded sign-up process allows you to easily create a new one directly from our platform. This flexibility ensures that all businesses, whether new to WhatsApp or already established, can efficiently set up their accounts.

Before starting the embedded sign-up configuration, please consider the following :

A WhatsApp Business Account (WABA) can have multiple phone numbers (senders).
A single WhatsApp Business Account (WABA) can be shared across different spaces.
Once a sender is linked to a specific WABA and space, it cannot be shared with other spaces.
Only one WABA can be assigned per space.

For example, suppose you manage a company called “TechWorld” that operates in multiple regions, each with its own customer support team. You decide to use WhatsApp Business for customer communication.

Multiple Senders: "TechWorld” creates a WhatsApp Business Account (WABA). Under this WABA, you assign different phone numbers as senders for each region. For example, you have one sender (phone number) for the North American region, another for Europe, and a third for Asia. This means your single WABA can manage multiple senders, each designated to handle communications for a specific region.
Sharing WABA Across Spaces: Your company uses different spaces within your communication platform to manage operations in each region. You decide to share the same WABA across these different spaces, allowing your North American, European, and Asian teams to access and use the WABA for their respective regional communications.
Sender Linking Restrictions: Once you link the North American sender (phone number) to the WABA within the North American space, this specific sender cannot be linked to another space, such as the European or Asian space. Each sender is exclusively tied to the space it was initially linked with, ensuring that customer communications are organized and region-specific.
Embedded Signup restriction: If you have previously requested the support team to create a WABA, and the sender is currently active on our platform, you won’t be able to link an existing WABA from your business or set up a new WABA using the embedded signup feature. To enable this feature, you’ll need to request the support team to remove the WABA currently on the platform.

📘
WABA Approval Time
The approval timeline for a WhatsApp Business Account (WABA) is subject to Meta’s verification procedures and the validation of submitted documentation.
Both the account status and the business verification must be approved before the WABA is considered fully active.
While approval is typically granted within 2 to 7 business days, cases requiring manual review by Meta may extend the process to up to 14 days (2 weeks).
Until the business verification is approved, the WABA will not have full capabilities:

You will be able to send messages only with the initial limitations (250 conversations per 24 hours, without newly approved templates).

You will not have access to large-scale messaging or advanced features until both statuses are approved.

Setup Embedded Signup

Follow these steps to link your existing WhatsApp Business Account (WABA) to our platform through the embedded signup process:

Add sender: Start by accessing the “Preferences” section and click on the “Channel Management” tab. This tab displays a list of all enabled channels currently available on the platform.

In this section, click on the "Add Sender" button.
Start the Embedded Signup Process: Here, click on the Sender Type dropdown menu and select the Embedded Signup (WhatsApp) option. Once selected, click on the "Add" button to start the embedded signup process. This will redirect you to Meta’s interface for managing your WhatsApp Business Account.
Authenticate with Facebook Business Manager: Log in with your Facebook Business Manager account credentials. This account should have access to the WABA you want to link.

📘
NOTE
If you don’t have a Facebook Business Manager account, you’ll need to create one before proceeding.

To continue with the Facebook Authentication, accept that the messaging solution provider (BSP) will receive basic information like the user’s name and profile picture, but this does not allow the provider to post on Facebook without the user’s permission.

The user needs to click on the “Continue as [Name]” button to proceed. If the user is not the person shown, they can choose to log in with another account.

This step ensures that the correct Facebook account is linked to the WABA and that the user authorizes the necessary permissions for the integration.
Authorize the Integration with Meta: After successfully authenticating with your Facebook Business Manager account, Meta will display a confirmation view explaining that you are about to connect your business assets to your WhatsApp Business Solution Provider (BSP).

By selecting Continue, you agree to the Meta Hosting Terms for Cloud API and the Meta Terms for WhatsApp Business. These agreements are required before Meta can grant the BSP access to your business assets. At this stage, no Business Portfolio, WhatsApp Business Account, or phone number has been created or linked. You are only authorizing Meta to proceed with the asset selection and configuration process.

Once clicked, you will be guided through each of the following steps:
- First, you will either create a new Business portfolio and WhatsApp Business Account or select existing ones.
- Next, you will verify the phone number associated with your WhatsApp Business Account. This involves receiving a verification code via SMS or phone call.
Create or Select a Business Portfolio & WhatsApp Business Account: In this step, you must define which Meta business assets will be connected to the WhatsApp Business Solution Provider (BSP).

You have two possible paths, depending on your current configuration in Meta:
- Create a new Business Portfolio and a new WhatsApp Business Account
- Select an existing Business Portfolio and an existing WhatsApp Business Account
1. Create a New Business Portfolio and a New WABA: If you do not yet have a Business Portfolio and a WhatsApp Business Account configured in Meta, select Create a Business Portfolio and Create a WhatsApp Business Account. Then click Next. At this point, Meta will move you to the business information screen where the new assets are defined.
  
  After clicking Next, the system displays a form where you must provide the details required to create the new Business Portfolio and WhatsApp Business Account. These details define how your business will be registered inside Meta Business Manager.
  
  You must complete the following fields:
  - Name: Enter the internal name for the new assets. It identifies the Business Portfolio inside Meta and is visible only within your Meta Business Manager. As a recommendation, use your legal company name or a clear business identifier.
  - Email: Business contact email associated with the new Business Portfolio. It should belong to the business domain.
  - Category: Select the category that best describes your business activity.
  - Country: Select the country where your business is legally registered. This selection is important for regional settings and compliance with local regulations.
  - Website: Enter your company’s official website.
  - Timezone: Choose the time zone where your business primarily operates. This setting is important for scheduling messages and managing your business hours accurately.
  - Description (Optional): You may include a brief explanation of your business activity. This field is not required to continue.
  Click Next to proceed with the creation of your Business Portfolio and WhatsApp Business Account.
2. Select an existing Business Portfolio and a WABA: If you already have an existing Business Portfolio and a WABA. Click Next. At this point, Meta will validate your selections and proceed to display the details and summary of the chosen assets.
Verify the Business Phone Number: Once you have selected or created a Business Portfolio and a WhatsApp Business Account, the onboarding process continues with phone number verification and linking.

In this step, you are required to add a phone number that will be associated with your WhatsApp Business Account. This is the number that customers will see and use to contact your business on WhatsApp.
- Enter the Phone Number: Enter the phone number you wish to use for your WhatsApp Business Account in the provided field. Ensure that the country code is correct (e.g., MX +52).
- Choose Verification Method: You must verify the phone number by receiving a verification code. Choose how you would like to receive this code: by Text Message (select this option to receive the verification code via SMS), or by Phone Call (select this option to receive the verification code via a voice call).
After selecting your preferred verification method, click the Next button to initiate the verification process. You will receive a verification code based on the method you selected.

Enter this code in the subsequent step to confirm ownership of the phone number, and click Next.
Finalizing the Process: After verifying your phone number, Meta displays a confirmation screen indicating that your account has been successfully connected to the WhatsApp Business Solution Provider. Your business will be reviewed to ensure compliance with WhatsApp’s Commerce Policy. If there are any issues, they will reach out within 24 hours.

Click the Finish button at the bottom right to complete the setup-embedded signup process.

Initial Messaging Limits for New WhatsApp Business Accounts

You can start with:

250 Business-Initiated Conversations: You are allowed up to 250 business-initiated conversations per phone number within a rolling 24-hour period. This allows you to proactively reach out to customers.
Unlimited Customer-Initiated Conversations: There is no limit to the number of conversations that can be initiated by customers. This means customers can contact your business freely without restrictions.
Up to 2 Phone Numbers: You can associate up to two phone numbers with your WhatsApp Business Account if the WABA is not yet verified, enabling you to manage communications through multiple lines.
Once your WABA is verified, you can add up to 25 phone numbers.

Assign WABA & Phone Number (Sender)

In this section, we’ll learn how to assign a WABA and phone number (sender) to the current Workspace.

The platform will display the next view after setting up the Embedded Signup process.

Here, there is a dropdown menu labeled Select WABA which allows users to choose from a list of available WABAs (verified or not verified).

📘
WABA Verification
If the selected WABA has been successfully verified, the “Add” button becomes active, enabling the user to assign the WABA to the current space.
If the WABA has not been verified, the “Add” button changes to a Warning Icon ⚠️, indicating that the WABA cannot be added until the verification process is completed. If the Warning icon persists, please contact the Support Team.

Once the WABA is successfully verified, we continue by selecting the WABA and clicking on the "Add" button. A confirmation pop-up window appears titled “Assign WABA.”

Click on the "Confirm" button to assign the WABA to the current space. Once clicked, it will display the WhatsApp Business Account configuration table.

This table summarizes the key details and settings of your newly linked WhatsApp Business Account (WABA) and associated phone numbers.

Here’s what each part of the table represents:

Alias: This column displays the alias or label assigned to the phone number, and it shows the unique identifier (ID) of your WhatsApp Business Account. This ID is important for managing and configuring your WABA within the platform.
Phone Number: The actual phone number associated with your WhatsApp Business Account is listed here. This is the number (sender) that customers will use to contact your business via WhatsApp.
Daily Quota: This column indicates the number of business-initiated conversations allowed per day for that phone number. In this example, the quota is set to 1000 conversations per day.
Rate Limit: The rate limit defines how many messages can be sent per second or minute from the phone number. Here, the rate limit is set to 80, meaning the number can send 80 messages per second/minute.
Assigned: To assign the WABA to the current space, select the checkbox.\

📘
NOTE
If the phone number (sender) of the WABA is already assigned to another space, the "Assigned" checkbox will be disabled.

This table provides a clear overview of your WhatsApp Business Account’s configuration, including key details about each associated phone number, making it easy to manage and monitor your WhatsApp communications from within the platform.

WABA Configuration: Once assigned the WABA to the space, it will be listed in the “Enabled channels” table located in the "Channel management" section regardless of its verification status.

To know the phone numbers (senders) associated with the WABA, follow these steps:
1. Locate the WABA: From the "Enabled channels" table, you should look at the "Type" column. The WABA you are looking for will have the value “WhatsApp Shared Waba” in this column.
  
  Next to the WABA, click on the "Edit" icon. This action will open the configuration options for the selected WABA.
2. Once clicked, it will display the WhatsApp Business Account configuration table. Here, you can assign phone numbers (senders) to the current space.
  
  To assign the desired phone number to the current space, check the "Assigned" checkbox. Once selected, it will display the following pop-up window. Click on the "Confirm" icon.
  📘
  NOTE
  Remember,
  - Only you are able to add a single WABA for each space.
  - Phone Numbers with the checkbox disabled are currently assigned to another space.
  After assigning the phone number to the space, it will appear in the “Enabled channels” list.

If you want to delete a WABA or unassign a phone number from the current space, the steps are the following:

Delete WABA

Next to the WABA, click on the "Edit" icon. This action will open the configuration options for the selected WABA.
To delete the selected WABA associated with the space, click on the "Trash" icon. Once clicked a confirmation pop-up window appears.

The pop-up lists the active processes associated with the WABA. The details provided include:
- Sender: The phone number associated with the WABA that is being used in the process.
- Process Name: The name of the process (campaign) that is active for this WABA.
- Type: The type of process.

Unassign Phone Number

Next to the WABA, click on the "Edit" icon. This action will open the configuration options for the selected WABA.
To unassign a phone number (sender) associated with the space, click on the uncheck the "Assigned" checkbox. Once clicked a confirmation pop-up window appears.

The pop-up lists the active processes associated with the phone number. The details provided include:
- Process Name: The specific name of each process (campaign) that is currently using this phone number.
- Type: The type of process.

An alternative method for creating a new WhatsApp Business Account (WABA) is through the Partner-Initiated Process, in which you can request assistance from our support team to initiate the creation of a new WABA.

How It Works: Our team will handle the entire setup process, including creating the WABA and configuring the sender (the phone number that will be used for messaging).
Who It’s For: This option is ideal if you’re starting from scratch and want a hassle-free setup. Our support team ensures that everything is configured correctly, so you can focus on your business without worrying about the technical details.