PALMS uses the official WhatsApp Business Platform (Cloud API) from Meta. You connect by logging in with Facebook in a window from Meta (called Embedded Signup); PALMS then sets everything up automatically. You never copy IDs or tokens.
What you need
- A Facebook account with admin access to your business’s Meta business portfolio (or permission to create one).
- The phone number you want to use, and the phone or SIM that receives its calls or SMS.
- Your business name, website and privacy policy link.
- 10–15 minutes.
Which number will you use?
The first step asks about your number, because what to prepare depends on where it is used today.
| Your situation | What happens |
|---|---|
| A new number, never used on WhatsApp | Verified by SMS or voice call during signup. Details |
| On the WhatsApp Business app, and you want to keep using the app | Same number in the app and in PALMS (coexistence). Details |
| On the WhatsApp Business app, moving fully to PALMS | Back up, delete the app account, then continue as a new number. Details |
| On personal WhatsApp | Back up, delete the account (or move to the Business app first). Details |
| With another provider (BSP) | Release or migrate the number first. Details |
| A landline | Verified by voice call. Details |
A new number
Use a number that is not registered on any WhatsApp app.
- Keep the phone with the SIM at hand: Meta sends a 6-digit code by SMS, or calls you if you choose voice call.
- During the Facebook login, enter the number and choose Text message or Phone call.
- Enter the code. That’s it: the number now works only through PALMS (not in a WhatsApp app).
Business app number — keep using the app (coexistence)
You can use the same number in the WhatsApp Business app and in PALMS. Meta calls this coexistence.
Requirements
- WhatsApp Business app version 2.24.17 or later (update it from your app store). This is Meta’s requirement.
- The phone with the Business app, with a working camera (to scan a QR code) and internet.
Recommended (providers report fewer failures this way; Meta may refuse otherwise)
- The number has been active on the WhatsApp Business app for at least 7 days, with real conversations.
- Two-step verification turned off in the app (Settings → Account → Two-step verification) during the connection.
What happens
- During the Facebook login, choose to connect your existing WhatsApp Business app and enter the number.
- Meta sends a message to the app from the official Facebook Business account: tap Connect, then Connect to the Business Platform, and confirm whether to share your chat history.
- PALMS imports your contacts and up to 6 months of individual chats. Keep the app open until the import is finished; it can take a while for long histories.
In PALMS afterwards
- Imported chats appear as closed conversations, so they don’t fill your inbox or trigger automations. They reopen when the customer writes again.
- Messages you send from the phone appear in PALMS as sent by WhatsApp Business app, so the team sees the whole conversation.
- If you declined to share the history on the phone, only new messages arrive; contacts are still imported.
- The usual WhatsApp rule applies to PALMS: free-form replies only within 24 hours of the customer’s last message, templates otherwise.
What syncs and what doesn’t
| Synced between the app and PALMS | Not synced or turned off |
|---|---|
| Individual chats (last 6 months, then live in both directions) | Group chats |
| Contacts with a WhatsApp number | Disappearing messages and view-once messages (turned off) |
| Messages you send from the app (they appear in PALMS) | Live location (turned off), broadcast lists (become read-only) |
| Calls, catalogue, labels, quick replies and away messages of the app |
Your linked devices are unlinked once; link them again afterwards. WhatsApp for Windows and Wear OS aren’t supported with coexistence. Messages sent from the app stay free; messages sent from PALMS follow Meta’s pricing.
Business app number — move fully to PALMS
Choose this if you’ll stop using the app on this number.
- In the WhatsApp Business app: Settings → Chats → Chat backup and back up your chats.
- Settings → Account → Delete account. Enter the number and confirm.
- Wait a few minutes, then continue as a new number.
Personal WhatsApp number
A number on personal WhatsApp must leave it first.
- To use only PALMS: back up your chats (Settings → Chats → Chat backup), then Settings → Account → Delete account. Wait a few minutes and continue as a new number.
- To keep a WhatsApp app on the number: first move it to the WhatsApp Business app (it can transfer your chats on the same phone), use it for 7 days, then choose coexistence.
Number with another provider (BSP)
If another company (a Business Solution Provider) connected your number to the WhatsApp API:
- Ask them to release the number, or to start a migration to your own WhatsApp Business Account. A migration keeps your display name, quality rating and templates.
- Turn two-step verification off for the number (in their dashboard or in WhatsApp Manager).
- Remove their access to your WhatsApp account in Meta Business Settings if it is shared with them.
- Start the connection in PALMS.
If Meta shows “already shared with a partner” (error 2655093), the account is still shared with the previous provider: ask them to remove it, then retry. See Troubleshooting.
Landline
A landline works: choose Phone call when Meta asks how to send the code. The line must accept calls from abroad, and the call must not land in a voice menu. Have pen and paper ready for the code.
Your business
PALMS asks for your business name, the display name customers will see, your category, website and privacy policy link. Meta checks the display name before it appears.
Display name rules
Meta approves a display name when it:
- clearly relates to your business, and matches your website or signage;
- uses normal capitals (all capitals only for acronyms) and no emojis or decorative symbols;
- isn’t only a generic word (like “Shop”) or a person’s name, unless that is the business;
- doesn’t include “WhatsApp” or impersonate another brand.
If Meta rejects it, you can change it in WhatsApp Manager; messages still work meanwhile, showing your number.
Log in with Facebook
Click Continue with Facebook. A window from Meta opens, with your business details already filled in:
- Log in and choose (or create) your business portfolio.
- Choose or create the WhatsApp Business Account; check the display name and category.
- Enter the number and verify it with the code — or, with coexistence, scan the QR code with the Business app.
- Confirm the permissions for PALMS and click Finish.
The window closes and PALMS continues by itself: you never copy an ID or a token. If you close the window early, PALMS shows where you stopped and you can start again. If the window doesn’t open, allow pop-ups for PALMS in your browser; if the button stays greyed out, an ad blocker may be blocking facebook.com.
Automatic setup
After the login, PALMS:
- Receives a secure access token for your account from Meta and stores it encrypted.
- Checks with Meta that the account and number are the ones you chose.
- Subscribes to your number’s messages.
- Registers the number for sending, with a security PIN it keeps encrypted (not needed with coexistence).
- Reads your quality rating and messaging limit, and imports your existing templates.
- With coexistence, asks the app for your contacts and chat history.
Each part shows a tick. If one fails, the number is still connected: you see why, and Retry runs just that part again.
Payment and limits
Meta bills WhatsApp messages directly, not PALMS.
- Since 1 July 2025, Meta charges per delivered template message (marketing, utility, authentication). Prices depend on the category and the customer’s country.
- Replies within 24 hours of the customer’s last message are free, and utility templates sent in that window are free.
- To send templates, add a payment method in WhatsApp Manager (Settings → Payment methods).
Messaging limit: how many different people you can start conversations with (using templates) in a rolling 24 hours. New accounts start at 250; the limit rises (2,000, 10,000, 100,000, unlimited) as you send messages people value and verify your business. PALMS shows your current limit on the channel.
Open WhatsApp Manager · Meta’s pricing
Reconnect
When the channel card shows Reconnect (for example after the number was removed from PALMS in Meta, or access was revoked), click it. The same wizard opens with only the login and test steps: log in with Facebook again and choose the same number. PALMS replaces the access in place; conversations, contacts and templates stay as they are. A different number is refused — connect it as a new channel instead.
Advanced connection
If the Facebook login isn’t available for your organization yet, or your number is already on the Cloud API in a business portfolio you manage, use the Advanced connection: you paste the number’s IDs and a permanent token, following a step-by-step guide. See WhatsApp Advanced connection.