Onpipeline’s WhatsApp integration allows your business to connect WhatsApp Business numbers to the CRM, manage customer communications, and send messages directly from Onpipeline.
This guide explains how to connect a WhatsApp number, the different types of supported numbers, and how to use WhatsApp Business App Coexistence.
Requirements
Before connecting WhatsApp to Onpipeline, make sure you have:
- A Standard+ account.
- Access to the relevant Meta Business account and WhatsApp Business Account (WABA).
- A business phone number eligible for the WhatsApp Business Platform.
- The ability to verify or authorize the phone number through Meta.
- A valid Meta billing configuration when chargeable messaging is required.
To connect your WhatsApp number to Onpipeline:
- Open Onpipeline → Settings → WhatsApp.
- Start the connection process.
- Sign in using the appropriate Meta account.
- Select or create your WhatsApp Business Account.
- Select the phone number you want to connect.
- Follow Meta’s verification or authorization steps.
- Complete the connection and confirm that the number appears as active in Onpipeline.
You can connect multiple eligible phone numbers, subject to Meta and Onpipeline account restrictions.
Which Phone Numbers can be connected?
There are two main ways to connect WhatsApp to Onpipeline.
WhatsApp Cloud API Number
A WhatsApp Cloud API number is registered with the WhatsApp Business Platform and used to exchange messages through Onpipeline.
This option is suitable for businesses that want to manage WhatsApp communications directly inside their CRM.
Important considerations:
- A new eligible phone number can normally be registered through Meta.
- An existing number may be migrated, subject to Meta’s eligibility and migration rules.
- A number registered with personal WhatsApp cannot simply be connected simultaneously to the Cloud API.
- A number already connected to another API provider may require migration or reassignment.
- Once connected, the number can send and receive supported WhatsApp messages through Onpipeline.
Important: Do not unregister an existing WhatsApp number before checking the available migration options and their implications.
WhatsApp Business App Coexistence
WhatsApp Business App Coexistence is a Meta feature that allows an eligible WhatsApp Business App number to connect to the WhatsApp Business Platform while continuing to use the mobile Business App.
With Coexistence, your business can potentially use both:
- WhatsApp Business App: For everyday communication from a mobile device.
- Onpipeline CRM: For supported WhatsApp API messaging and CRM integration.
This is particularly useful for businesses that already use the WhatsApp Business App and want to integrate their communications with Onpipeline without abandoning their existing mobile workflow.
Coexistence Requirements and Limitations
Coexistence is subject to Meta’s eligibility requirements and supported onboarding process.
Consider the following limitations:
- Coexistence is not available for every number or WhatsApp account.
- It supports eligible WhatsApp Business App accounts, not ordinary personal WhatsApp accounts.
- The availability and synchronization of existing messages may vary.
- Some WhatsApp Business App features may behave differently after connecting.
- Messages sent through the Business App may also appear in Onpipeline when supported by Meta’s message synchronization or echo events.
Important: Connecting WhatsApp through Coexistence does not guarantee that your complete historical chat archive will be imported into Onpipeline.
Always check eligibility before modifying an existing WhatsApp Business App number.
Troubleshooting Connection Errors
Error: “This phone number is already registered to a WhatsApp account”
This message may appear when attempting to activate WhatsApp Business App Coexistence.
One possible reason is that the phone number is currently registered with the regular WhatsApp app rather than the WhatsApp Business App.
How to resolve it:
- Check whether the phone number is registered with WhatsApp or WhatsApp Business.
- If it uses regular WhatsApp, switch to the WhatsApp Business App.
- Complete the WhatsApp Business App activation.
- Return to Onpipeline and retry the connection process.
Newly activated WhatsApp Business accounts may not immediately be eligible for Coexistence.
The WhatsApp Number is not visible in Onpipeline
If a connected WhatsApp number does not appear in your account:
- Verify that the number was successfully connected.
- Check that you have permission to access the corresponding WhatsApp channel.
- Confirm whether the number is assigned to an individual user or a team.
- Contact your Onpipeline administrator if the number is still unavailable.
Important Recommendations
Before connecting an existing business number:
- Verify whether it is currently registered with WhatsApp, WhatsApp Business App, or another API provider.
- Check Meta’s migration and Coexistence requirements.
- Review any potential impact on existing messaging workflows.
- Confirm that the correct Meta Business Account is selected.
- Ensure the required billing configuration is available.
- Avoid disconnecting or unregistering numbers without understanding the consequences.
Need Help?
For assistance with Onpipeline configuration or channel permissions, contact your Onpipeline administrator or support team. For Meta account eligibility, number migration, or WhatsApp Business App Coexistence, consult the Meta Business Help Center.
Note: WhatsApp Business Platform eligibility, migration options, and Coexistence availability depend on Meta’s current policies and the configuration of your business account.

