100%
Integrations › WhatsApp

Connecting WhatsApp to the store

Entering the Meta app's details on the WhatsApp page, pointing the app's webhook at AmigoPOS, and testing, changing or disconnecting.

With the four values from Setting up the store’s Meta app at hand, open Back Office › Integrations › WhatsApp. Changing the connection needs Back Office configuration permission.

1. Enter the details

In the WhatsApp Number card, fill in Phone Number ID, WhatsApp Business Account ID, Permanent Access Token and App Secret, then choose Save And Check. Before anything is saved, AmigoPOS checks with Meta that:

  • the token opens that phone number,
  • the App Secret belongs to the same app as the token,
  • the number is on that WhatsApp Business Account.

It then subscribes the app to the account’s events. If a check fails, the card shows Meta’s own message and nothing is saved.

Image needed · wa-10
Capture: The WhatsApp Number card before connecting: the four fields and the Save And Check button.
The token and the App Secret are stored encrypted and never shown again. To change another field later without retyping them, leave those two boxes blank.

2. Point the app’s webhook at AmigoPOS

Once connected, the card shows a Callback URL and a Verify Token, each with a Copy button. They let Meta tell AmigoPOS about deliveries, template approvals and customer replies.

Image needed · wa-11
Capture: The connected WhatsApp Number card: Connected badge, number and name, Callback URL, Verify Token and the webhook status line.
  1. In the Meta app, choose Use cases (the pencil icon), then Customize on Connect with customers through WhatsApp, then Configuration, and choose Edit under Webhook.
  2. Paste the Callback URL and the Verify token, then Verify and save.
  3. Under Webhook fields, subscribe to messages, message_template_status_update and template_category_update.
Image needed · wa-12
Capture: Meta app › Use cases › Customize (WhatsApp) › Configuration: the webhook Edit dialog with the Callback URL and Verify token filled in.
Image needed · wa-13
Capture: Meta app › Use cases › Customize (WhatsApp) › Configuration: Webhook fields with messages, message_template_status_update and template_category_update subscribed.

To confirm it works, send the store’s WhatsApp number a message from your own phone. Within a minute the card’s status line changes from No webhook received yet to Last Webhook Received, and the message appears in the WhatsApp Inbox.

When several of the merchant’s stores use the same Meta app, set the app’s webhook once, with any one of those stores’ Callback URL: Meta allows one per app, and AmigoPOS sorts each event to the right store.

3. Test, change or disconnect

  • Test Connection repeats the checks. Use it after changing anything in Meta: a problem turns the badge red and shows Meta’s message.
  • Change reopens the fields — for a new token, a new App Secret or another number.
  • Disconnect (press it twice to confirm) stops WhatsApp at once and erases the saved token and App Secret. Messages go by text where the store allows it. The templates are kept for a later reconnect.
Connecting a different WhatsApp Business Account turns the store’s templates back into drafts, because templates belong to the account. Submit them again on the WhatsApp page.

Next: WhatsApp message templates.