Setup guide

Connect your WhatsApp number to Piaflo

Everything you need to go from install to your first automated message: which number to use, what Meta asks for, what you pay, and how to fix the errors people run into.

Time needed10 to 15 minutesplus 1 to 2 days for Meta to review your display name, which does not block sending
What you needA personal Facebook account, a phone number, a business cardthe card is for Meta's message fees
What you payYour Piaflo plan to Shopify, messages to Metaat Meta's official rates, with no markup from Piaflo
What you keepYour WhatsApp Business account and numberdisconnect Piaflo at any time without losing your number

1What you are about to create

The regular WhatsApp app cannot send automated messages. For that you need a WhatsApp Business Platform account (often called the "WhatsApp API"). During the connection, Meta creates three things for you in a single window:

  1. A Meta business portfolio (formerly "Business Manager"): your company's folder at Meta. If you already have one for your Facebook or Instagram ads, you can reuse it.
  2. A WhatsApp Business account (WABA) attached to that portfolio.
  3. Your number and its display name, the name your customers see.

Piaflo only receives permission to send and receive messages and to manage message templates on that account. Piaflo has no access to your Facebook pages, your ads or your personal WhatsApp conversations.

2Before you start: choose your number

This is the only important decision. In Piaflo, the question is "Do you already use this number in the WhatsApp Business app?"

Case A · most stores

You already use this number in the WhatsApp Business app on your phone

Choose "Yes, keep using my WhatsApp Business app (recommended for most stores)". This is called coexistence.

  • You keep replying from your phone, as you do today.
  • Piaflo sends the automated messages (order confirmation, abandoned checkout and so on) from the same number.
  • Messages you send from your phone also appear in the Piaflo inbox.

Requirements: the WhatsApp Business app (not the regular WhatsApp app), up to date, version 2.24.17 or later; your phone at hand during the connection, to approve it in the app. Availability depends on your country: if the option is not offered for your number, use case B.

Limits: up to 20 messages per second (plenty for a store), no groups or calls through the API.

Case B

You use a separate number that is not on WhatsApp yet

Choose "No, it is a separate number that is not on WhatsApp yet".

  • The number must not be registered in any WhatsApp app (WhatsApp or WhatsApp Business). If it is, first delete the account in the app: Settings → Account → Delete my account. This erases that account's history.
  • It must be able to receive an SMS or a call for the verification code. A landline works (choose "voice call"). A virtual number works if it receives SMS or calls.
  • Short codes and premium-rate numbers do not work.
  • You will no longer be able to use this number in the WhatsApp app. You reply from the Piaflo inbox, on desktop or in the Shopify mobile app.
Case C

Your number is already connected to another WhatsApp tool

  • The number can be moved, but the previous tool has to release it.
  • In the previous tool (or in WhatsApp Manager → Phone numbers → your number → Settings), turn off two-step verification or write down the 6-digit PIN.
  • Keep the same business portfolio: your approved message templates are kept, because they belong to your WhatsApp Business account, not to the tool.
  • Contact us before you start: we help you switch off the previous tool without a gap in sending.
Case D

You have no spare number: get a dedicated number from Piaflo

In Settings, next to the connection form, the Get a dedicated number card offers a local number rented by Piaflo, already verified by Meta. Your personal WhatsApp stays private.

  • No SIM card and no code to receive.
  • Ready instantly in some countries, 1 to 3 business days in France after a quick business check.
  • Included with yearly billing on paid plans.
  • Once the number is ready, connecting it to WhatsApp takes two minutes, with no code to enter.

See Get a dedicated number for the full steps.

Tip: for a small store that already answers customers on WhatsApp, case A is the simplest. For a brand with a support team, case B keeps personal and store messages apart. With no spare number, case D gives you one.

3Prepare (5 minutes)

  • Log in to your personal Facebook account in your browser. Meta uses it to identify you; nothing gets posted.
  • Keep the phone for that number at hand, for the verification code (case B) or the approval in the app (case A).
  • Know your company's legal name, address and website. Meta asks for them to create the business portfolio.
  • Choose your display name (see section 6). It has to follow Meta's rules.
  • Have a business card ready, to add right after (see section 5).
  • Allow pop-up windows for admin.shopify.com and piaflo.com: the connection opens in a separate window.

4Connect the number, step by step

  1. In Shopify, open Apps → Piaflo → Settings (or follow the setup guide on the app's home page).
  2. Answer "Do you already use this number in the WhatsApp Business app?" (see section 2), then click Connect WhatsApp.
  3. A window opens. It is operated by Zernio, our technical partner for the WhatsApp Business Platform, so its logo appears next to Piaflo. Click Continue with Facebook.
  4. Facebook login: sign in with your personal account, then click Get started.
  5. Business portfolio: select your company in the list, or choose Create a business portfolio and fill in the legal name, business email, website and country.
  6. WhatsApp Business account: choose Create a WhatsApp Business account (or an existing account, case C).
  7. Profile: enter the display name (section 6), the business category (for example "Retail") and, optionally, a description.
  8. Number:
    • Case A (coexistence): enter your number, then open the WhatsApp Business app on your phone. Meta asks you to confirm the connection there; depending on the app version, it is a notification, a message or a QR code to scan. You can choose to share your recent chat history with Piaflo; this is optional.
    • Case B (new number): enter the number, choose SMS or Voice call, then type the code you receive.
  9. Permissions: Meta shows what Piaflo will be able to do (send and receive messages, manage templates). Leave everything ticked and click Confirm, then Finish.
  10. The window closes. In Piaflo, click I finished, check my connection if needed. The WhatsApp health block on the app's home page shows your number with its Quality and Limit: {tier} / 24 h badges: you are connected.
  11. In Settings → Send a test message, enter your number in Your phone number, choose an approved template in Template and click Send test. No test is possible until you have an approved template: the list then reads "No approved template yet". Activate a recipe and wait for Meta's approval (section 8). See Send a test message.

In Settings → WhatsApp account, each connected number has its own card. It shows the Connected status and badges for Sending (available, limited or blocked), Quality, Messaging limit, Display name and Business verification. Below come your Meta IDs (Meta business portfolio ID, WhatsApp Business account, Phone number ID), the Connected since date, the Last checked date, and the Open WhatsApp Manager, Open Meta billing and Disconnect buttons.

5Add a payment method at Meta (required)

Without a payment method, Meta refuses to send automated messages (confirmations, reminders, campaigns). Only your replies to customers who write to you remain possible.

  1. Go to business.facebook.com and select your portfolio.
  2. Open Settings → Billing and payments. Depending on Meta's interface, it can also be under WhatsApp Manager → Settings → Payment methods.
  3. Click Add payment method and add your company card.
  4. Choose the currency carefully: it cannot be changed later.
  5. Back in Piaflo, open Settings. Under WhatsApp account, a paragraph reminds you that Meta needs a payment method to bill your automated messages, with an Open Meta billing link to your account's payment settings.

If Meta reports that the WhatsApp Business account has no valid payment method (code 141006 or 131042), the number's card in Settings shows a banner, "No valid payment method on this WhatsApp Business account, so Meta blocks templates.", with an Add a payment method button. See Meta payment method and display name.

What Meta charges

Meta charges per delivered template message. The price depends on the message category and on your customer's country:

CategoryExamplesPrice level
Utilityorder confirmation, shipping update, cash on delivery confirmationlower rate
Marketingabandoned checkout reminder, promotion, campaignhigher rate
Serviceyour replies to a customer who wrote to you, within 24 hourscovered by Meta's customer service rules

Rates change over time, so always check Meta's official pricing page. Piaflo shows an estimate before each campaign and the actual cost in your stats. Meta bills you directly; Piaflo adds no markup.

6Choose your display name

This is the name your customers see at the top of the conversation. Meta reviews it, usually within 1 to 2 days. In the meantime, your messages go out normally and show your number.

Accepted

  • Your brand name as it appears on your website ("Maison Lune").
  • Your brand plus a precision ("Maison Lune Paris", "Maison Lune Customer Care").

Rejected

  • A name with no visible link to your website or business.
  • A generic word on its own ("Shop", "Fashion", "Deals").
  • A name in all caps (unless it is an acronym), with emojis or unnecessary punctuation.
  • A person's name on its own, unless it is the brand.
  • The word "WhatsApp", or a brand you do not own.

The review status shows in the Display name badge on your number's card in Piaflo's Settings. If the name is rejected, change it in WhatsApp Manager → Phone numbers → Profile → Display name (the Open WhatsApp Manager button on the card takes you there), or ask us for help.

7Verify your business (recommended)

Without verification, a new number can reach 250 different customers per 24 hours with automated messages (replies to customers who write to you are not limited). Verification quickly unlocks 2,000, then 10,000, 100,000 and unlimited, depending on the quality of your messages.

  1. Go to business.facebook.com → Settings → Security center (or Business info → Verification, depending on the interface).
  2. Click Start verification.
  3. Enter the exact legal name (with the company type, for example "Maison Lune SAS" or "Maison Lune Ltd"), the address and phone number, identical to your documents.
  4. Upload a recent official document, such as your company registration certificate or articles of association. A utility or internet bill in the company's name can prove the address.
  5. Confirm your link to the company: email on your website's domain (not Gmail), SMS, call or domain verification.

It takes from a few minutes to a few days. Piaflo shows the result in the Business verification badge on your number's card in Settings. Common reasons for rejection: the name differs by one letter between Meta and your registration document, a cropped or unreadable document, a website without legal notices, a free email address.

Another way to raise the limit: send 2,000 quality messages within 30 days, without recipients reporting them.

8Your first message templates

Automated messages use templates approved by Meta.

  • When you turn on a recipe (for example "Abandoned checkout recovery"), Piaflo submits its templates in English and French automatically.
  • Approval takes from a few minutes to 24 hours. You can follow the status in Piaflo → Templates.
  • While approval is pending, the recipe is active and its messages wait (24 hours at most), then go out as soon as the template is approved.
  • If a template is rejected, Piaflo shows the reason given by Meta.

Good practice: a "utility" template (order, shipping) must contain no promotion, otherwise Meta reclassifies it as marketing, which costs more. Marketing messages include "Reply STOP to unsubscribe", already present in Piaflo's templates.

10Troubleshooting

Message or symptomCauseSolution
The window does not openPop-ups are blockedAllow pop-ups for admin.shopify.com and piaflo.com, then try again.
"Connection did not complete"The window was closed before the end, or the connection was left open for more than 2 hoursClose the window and start again from Piaflo. The business portfolio you already created will be offered.
"This number is already connected"The number is registered in a WhatsApp app or with another toolCase A: choose "Yes, keep using my WhatsApp Business app (recommended for most stores)". Case B: delete the account in the app. Case C: release it in the previous tool (section 2).
The connection form no longer shows in SettingsA number is already connected: Settings shows its card insteadNo plan limits the number of numbers, and Settings lists every connected number. To connect another number of your own in its place, click Disconnect on its card first.
Verification code never arrivesSMS blocked, or a landlineChoose "Voice call" and wait 2 minutes between two requests.
"Enter the PIN"Two-step verification turned on at a previous providerEnter the 6-digit PIN, or turn it off in WhatsApp Manager.
Messages "pending" in PiafloThe template is not approved yetWait (24 hours at most). Check the status in Templates.
Messages "failed" mentioning a payment methodNo valid payment method at Meta (code 141006 or 131042)Click Add a payment method in the banner on your number's card. See section 5.
Display name "rejected"Meta's naming rulesChange the name in WhatsApp Manager (section 6).
"Limit reached" failures250 contacts per 24 hours on a new numberVerify your business (section 7). In a campaign's schedule, Spread sending over sends it gradually.
Number quality "low" (red)Too many reports or blocksPiaflo marks the campaigns that are sending as paused, but messages already queued still go out: click Cancel campaign to stop them (see Number limited or blocked). Space out your sends, target engaged customers and take care of your messages.
A customer says they receive nothingThey blocked the number, do not have WhatsApp, or Meta limits the marketing messages they receive from all brands combinedCheck the message status in the Piaflo inbox. Order messages are not affected by this limit.

11Frequently asked questions

Do I lose my number if I uninstall Piaflo?

No. The number and the WhatsApp Business account belong to you. With coexistence, you keep your app as before. With a separate number of your own, you can connect it to another tool or put it back in the WhatsApp Business app. A number rented from Piaflo (case D) is the exception: it is released 30 days after you uninstall Piaflo or leave yearly billing on a paid plan.

Can I use my personal number?

Technically yes (case B), but you will no longer be able to use it in the WhatsApp app. A business number is a better choice. With no spare number, Piaflo can rent you one (case D).

How long before I send my first messages?

The same day: the connection takes about 15 minutes, and templates are usually approved in less than an hour.

Will my customers see "Piaflo"?

No. They see your shop's display name and your number.

Can I reply from my phone?

With coexistence (case A), yes, from the WhatsApp Business app. In every case, the Piaflo inbox works in the Shopify mobile app.

Who pays what?

Your Piaflo subscription is billed by Shopify. Messages are billed by Meta to your card, at Meta's official rates, with no markup from Piaflo.

How do I disconnect Piaflo?

In Piaflo, open Settings and click Disconnect on your number's card. To remove the access entirely, go to business.facebook.com → Settings → Integrations → Connected apps.