WhatsApp Channel
Connect your Pearl Text agent to WhatsApp through your WhatsApp Business account. Pearl replies using the flow, knowledge, and actions defined in your Pearl, across both inbound conversations and outbound campaigns. The connection runs through Meta Embedded Signup: a Meta window opens on the platform, you log in with the Facebook account that manages your business, and Meta links your WhatsApp Business account to NLPearl. You can start it from two places:- Settings → Text Channels, then click Connect WhatsApp.
- From a Pearl’s Overview page, through the Add a Channel chooser.
Choose a connection mode
Before connecting, pick how NLPearl should use your number:
Both modes share WhatsApp’s messaging limits: business-initiated conversations start at 250 per 24 hours and scale automatically to 2,000, 10,000, 100,000, then unlimited - once you verify your business with Meta or sustain enough high-quality template volume.
If you already use the number in the WhatsApp Business app, choose Coexistence - you keep your app and chat history while Pearl handles conversations on the same number. Choose Dedicated for high-volume campaigns or when the channel must not depend on a phone.
Connect in Coexistence mode
Before you start, keep your number active in the WhatsApp Business app on your phone - Meta requires app version 2.24.17 or later, and the regular WhatsApp app is not supported.1
Start the connection
Select Keep using WhatsApp on my phone, then click Connect WhatsApp.
2
Log in and continue
A Meta window opens. Log in with the Facebook account that manages your business and click Continue.
3
Select your business assets
Pick or create your Business portfolio.
4
Enter your business information
Fill in your business details - they only affect newly created assets.
5
Enter your WhatsApp Business phone number
Enter the number that is active in your WhatsApp Business app.
6
Get the QR code
Meta shows a QR code and offers to import your business profile, contacts, and the last 6 months of chat history. Keep this window open - you’ll scan the code with your phone.
Group chat history is not shared - only individual conversations are imported.
7
On your phone, start the link
In the WhatsApp Business app, open the message from the official Facebook Business account and tap Connect.
8
Scan the QR code
Point your phone at the QR code displayed in the Meta window.
9
Confirm your WhatsApp Business account
Back in the Meta window, confirm or edit your WhatsApp Business account name and timezone, then finish the signup.
10
Your number is connected
The number is imported automatically and appears with the App + API tag: it keeps working in your WhatsApp Business app while Pearl uses it through the API.
- Messages you send from the WhatsApp Business app stay free and don’t affect the API conversation windows Pearl uses.
- Onboarding unlinks the app’s companion devices (WhatsApp Web, desktop apps); you can re-link supported devices afterwards.
- For the full technical details, see Meta’s coexistence documentation.
Connect in Dedicated mode
1
Start the connection
Select Dedicate this number to NLPearl, then click Connect WhatsApp. A Meta window opens - log in with the Facebook account that manages your business and continue through the intro.
2
Select your business assets
Pick or create your Business portfolio, and under WhatsApp Business account select Create a WhatsApp Business account (or pick an existing one).
3
Enter your business information
Fill in your business name, category, country, and website.
4
Add your WhatsApp phone number
Choose how you want to be identified when sending messages.Use a display name only - people only see a display name in the chat, without a phone number.
With a display name only, Meta reviews your business name and display name before you can send freely. This can take up to 1 business day; during the review you can send 5 business-initiated test messages every 24 hours.
5
Review permissions and confirm
Review what NLPearl will be able to access and do, then click Confirm.
6
Finish the signup
Your account is connected. Meta reviews your business against WhatsApp’s Commerce Policy and reaches out within 24 hours if there’s an issue. You can also add a payment method now or later - Meta bills the conversations your business initiates to the payment method on your WhatsApp Business account.
Import your numbers
Once connected, the platform lists the phone numbers of your WhatsApp Business account. Click Add to account next to each number you want to use - each one becomes a text channel on the platform.
Coexistence numbers are imported automatically after the QR code scan and never ask for a PIN.
Manage the connection
Everything is managed from the WhatsApp Business account screen in Settings → Text Channels:- Add a number from your WhatsApp app - connect an additional number in coexistence mode at any time.
- Remove a number - disconnects the number from NLPearl and deletes its text channel. Any Pearl using it is paused, and you can import the number again later.
- Disconnect - disconnects your WhatsApp Business account from NLPearl. You can reconnect it at any time.
Troubleshooting
My coexistence number disconnected after two weeks
My coexistence number disconnected after two weeks
Meta drops the coexistence connection when the WhatsApp Business app stays inactive for about 14 days, and your campaigns stop with it. To reconnect the number, open the WhatsApp Business app on your phone, then go to Settings → Text Channels, open your WhatsApp Business Account, and click Add a number from your WhatsApp app - the Meta window opens and you scan the QR code again, exactly like the first connection. To prevent it, open the app at least once every 14 days.
I forgot the two-step verification PIN
I forgot the two-step verification PIN
The 6-digit PIN requested when importing a dedicated number is WhatsApp’s two-step verification PIN.
- If the number is still registered in the WhatsApp Business app, reset it from the app under Settings → Account → Two-step verification.
- If the number is already registered on the Cloud API, manage its PIN from Meta’s WhatsApp Manager, in the phone number’s settings.
Meta says my number is already registered to a WhatsApp account
Meta says my number is already registered to a WhatsApp account
In dedicated mode, the number can’t be attached to any WhatsApp or WhatsApp Business app account.
- If you want to keep using the app with this number, connect it in Coexistence mode instead.
- Otherwise, release the number by deleting its account in the app (Settings → Account → Delete account), then try again. It can take up to 3 minutes for Meta to refresh the number’s status.
Inbound
Deploy your agent on inbound channels to answer incoming WhatsApp messages instantly.
Outbound
Launch outbound WhatsApp campaigns to reach customers proactively.