100%
Integrations › WhatsApp

Setting up the store's Meta app

Step by step on Meta's side: business portfolio, app, the store's number, payment method, permanent token, Phone Number ID and registration, App Secret and publishing.

This is done once per store, on Meta’s websites, by someone with admin access to the store’s Meta business portfolio, and takes about half an hour. At the end you will have the four values the WhatsApp page asks for: the WhatsApp Business Account ID, a permanent access token, the Phone Number ID and the app’s App Secret. Meta renames and moves its screens from time to time; if a label below differs slightly, look for the nearest match.

The phone number must not be on the WhatsApp or WhatsApp Business app. Once registered here it works only through AmigoPOS — use a separate number, or delete that account from the app first.

1. Business portfolio

Go to business.facebook.com and sign in. Use the store’s existing business portfolio, or create one with the store’s legal name, address and website. The app, the WhatsApp account and the number will all belong to it.

2. Create the app

  1. Go to developers.facebook.com, sign in with the same Facebook account and choose My Apps › Create App.
  2. Enter an app name the store will recognise, such as the store’s name followed by “POS messages”, and a contact email.
  3. Choose the use case Connect with customers through WhatsApp, then Next.
  4. Select the store’s business portfolio, choose Next, check the summary and choose Create app.
wa-02

Meta then opens the WhatsApp use case on its Overview page. Keep Integrate with API selected; the setup is the list under Basic setup on the left. To come back to it later, open the app, choose Use cases (the pencil icon) and then Customize on the WhatsApp use case.

Image needed · wa-03
Capture: Use cases › Customize › Overview: Integrate with API selected and the Basic setup steps listed.
Step 1. Try it out sends a message from a free test number Meta provides. It is optional, and the Phone Number ID and WhatsApp Business account ID it shows belong to that test number: don’t use them in AmigoPOS.

3. Add the store’s phone number

  1. Choose Step 2. Production setup and expand Register your WhatsApp phone number. Leave Configure Webhooks, at the top, for later: it needs two values AmigoPOS shows only once WhatsApp is connected.
  2. Choose Add new number. The Add phone number window has four pages:
    • Business information — the business name, a website or social media page and the country. Pick the store’s business portfolio if asked.
    • WA Business Profile — what customers see, including the display name. It must match the business; Meta reviews it.
    • Add number — the store’s number.
    • Verify number — receive the code by text or phone call and enter it.

Until the business is verified (see the tip at the end), Meta allows two numbers per business.

Image needed · wa-04
Capture: Step 2. Production setup with Register your WhatsApp phone number expanded and the Add new number button.
Image needed · wa-05
Capture: The Add phone number window, Business information page, filled in.
Image needed · wa-06
Capture: The Add phone number window, Verify number page, with the code box.

4. Add a payment method and copy the WhatsApp Business Account ID

  1. Expand Add payment to send business-initiated messages and follow its Billing Hub link. It opens Billing & payments › Accounts.
  2. On the WhatsApp Business accounts tab, find the store’s account — not Test WhatsApp Business Account — choose Add payment and add a credit or debit card. Without it Meta does not deliver the messages the store starts.
  3. The number shown as ID under the account’s name is the WhatsApp Business Account ID: copy it.
Image needed · wa-07
Capture: Billing & payments › Accounts › WhatsApp Business accounts: the store's account row with its ID and the Add payment button.

5. Generate the permanent access token

  1. Back on Step 2. Production setup, expand Send message.
  2. Under Step 1: Generate token, choose Generate token and follow Meta’s prompts.
  3. Copy the token straight away; Meta may not show it again.
Image needed · wa-08
Capture: Step 2. Production setup › Send message: Step 1 Generate token with a token generated (masked).
Treat the token like a password: anyone who has it can send messages as the store. Paste it only into Meta’s Graph API Explorer in the next step and into the WhatsApp page in Back Office.

If Meta can’t generate the token, make one by hand, as the link under the box explains: in business.facebook.com › Settings › Users › System users, add a system user with the Admin role; choose Assign assets and give it full control of the app and of the WhatsApp account; then choose Generate token, select the app, set the expiration to Never and tick whatsapp_business_messaging and whatsapp_business_management.

6. Find the Phone Number ID and check the registration

Meta’s setup page shows a Phone Number ID only for its test number, and the store’s number must be registered before it can send. Meta’s Graph API Explorer covers both from the browser:

  1. On developers.facebook.com, open Tools › Graph API Explorer.
  2. In Meta App, select the store’s app. Clear the Access Token box and paste the token from step 5.
  3. Leave GET selected and replace the request path with
    WABA-ID/phone_numbers?fields=id,display_phone_number,verified_name,status
    putting the WhatsApp Business Account ID from step 4 in place of WABA-ID. Choose Submit.
  4. The answer lists the account’s numbers. For the store’s number (display_phone_number), copy the id: that is the Phone Number ID.
  5. If its status is CONNECTED, the number is registered: go on to step 7.
Image needed · wa-09
Capture: Graph API Explorer: GET phone_numbers answer showing the store's number, its id and status CONNECTED (token hidden).

If the status is anything else, register the number:

  1. Change GET to POST and replace the path with
    PHONE-NUMBER-ID/register?messaging_product=whatsapp&pin=123456
    putting the Phone Number ID in place of PHONE-NUMBER-ID and six digits of your choice in place of 123456.
  2. Choose Submit. The answer "success": true means the number is registered; run the GET above again to see CONNECTED.
Image needed · wa-22
Capture: Graph API Explorer: POST register with the answer success true (token hidden).
The six digits become the number’s two-step verification PIN; if the number already has one, use that PIN instead. Keep it with the store’s Meta records: Meta asks for it to move or delete the number. Meta allows 10 registration attempts per number in 72 hours, so fix an error before trying again.

If Meta rejects the display name, correct it in WhatsApp Manager › Account tools › Phone numbers and register again once the new name is approved.

7. App Secret, app details and publishing

  1. In the app, open App settings › Basic (the app’s left bar shows icons; hover over them for their names), choose Show next to App secret — Meta asks for your Facebook password — and copy it.
  2. On the same page fill in the Privacy Policy URL (the store’s website, or the Privacy Policy page of its online ordering site), User data deletion (a page that tells customers how to ask the store to delete their data; the privacy policy page will do if it says so), the App icon (a square image between 512 × 512 and 1024 × 1024 pixels, such as the store’s logo) and the Category, then choose Save changes.
  3. Choose Publish in the app’s left bar, or the Publish your app link under Configure Webhooks. Review the requirements and choose Publish; the page lists anything still missing.
Image needed · wa-23
Capture: App settings › Basic, top of the page: the App secret field (masked) with its Show button.
Image needed · wa-24
Capture: App settings › Basic, further down: Privacy Policy URL, User data deletion, App icon and Category filled in.
Image needed · wa-25
Capture: The app's Publish page with its requirements complete and the Publish button.

Until the app is published, Meta sends only test webhooks, so AmigoPOS would get no delivery updates or customer replies.

What you copied

  • WhatsApp Business Account ID — step 4.
  • Permanent access token — step 5.
  • Phone Number ID — step 6.
  • App Secret — step 7.

Configure Webhooks is finished from the next topic, once AmigoPOS shows the Callback URL and Verify token.

New WhatsApp accounts start with a daily limit on how many customers they can message. It rises as the store sends messages customers don’t block or report. Step 3. Business verification is optional but recommended: the store uploads documents such as its certificate of incorporation, business license or tax registration, and Meta’s review takes 2 to 10 business days. Once verified, the store can message more customers, show its display name in chats and add up to 20 numbers. This is the store’s own step, done in Meta, not in AmigoPOS.

Next: Connecting WhatsApp to the store.