Kuai Pro

Connect your WhatsApp Business Account

Kuai needs four values from your Meta account, and your WhatsApp account needs to know where to send incoming messages. The setup itself takes about fifteen minutes and you only do it once, but start the business verification below first, because that is the part with a waiting period.

Before you start

• A Meta business portfolio with your business verified. Do this before you create anything else. Meta reviews it by hand and asks for business documents (in Singapore that is normally your ACRA Business Profile, elsewhere the equivalent certificate of incorporation or business registration), along with your legal business name and registered address entered exactly as they appear on those records. Verification can take a few days, and longer if a document is rejected and has to be resubmitted, so start it first if you have not already: open business.facebook.com and find verification under your business portfolio's settings. You can work through the rest of this page while it is in review, but you cannot message real customers until it passes.
• A phone number that is not currently registered to the WhatsApp or WhatsApp Business app. If it is, delete that account first; the number cannot be in both places.
• Your Kuai company on the Pro plan.

The steps

1. 1

   Create an app in Meta for Developers

   Go to developers.facebook.com/apps and select Create App. Meta walks you through five stages.

   

   1. App details: give the app a name, such as your business name, and an email address you actually check. Meta uses it if your app is ever restricted.
   2. Use cases: choose Connect with customers through WhatsApp. Pick only this one; some use cases cannot be combined in a single app.
   3. Business: attach the app to your business portfolio. It is required for WhatsApp, so if you do not have one yet, create it here.
   4. Requirements and Overview: read through and confirm.

   

   If you are following older instructions elsewhere, ignore any mention of choosing an app type such as “Business” or “Other”. Meta replaced that with the use case picker above.

   Once the app exists, its left-hand menu has a Use cases entry listing Connect with customers through WhatsApp with a Customize button beside it. That is where all the WhatsApp settings live from now on. There is no separate “WhatsApp” product in the menu.

   

2. 2

   Set up your WhatsApp Business Account

   The WhatsApp Business Account is part of your business portfolio, not of the app, so this step happens elsewhere. Open business.facebook.com and select Settings at the bottom of the left-hand menu.

   Expand Accounts, choose WhatsApp accounts, and select Add. Follow the flow through to create the account, add the phone number you want customers to message, and verify it by SMS or call.

   

   In the same place, assign your app from step 1 to this WhatsApp account. Without that the app cannot act on its behalf, and the ids in the next step will not appear.

   Use your own number. The test number Meta offers can only message a handful of pre-approved recipients, never real customers.

3. 3

   Copy the WABA ID and Phone Number ID

   Back in your app, go to Use cases, select Customize beside the WhatsApp use case, then API Setup. Both values are on that page, beneath the number you just added.

   • WABA ID is labelled WhatsApp Business Account ID
   • Phone Number ID is labelled Phone number ID, not the phone number itself

   Both are long numbers. The phone number ID is the one Kuai sends messages through, so make sure you copy the ID and not the number you dialled.

   There is nothing to add on this page. Your account and number already exist from step 2, so use the selectors at the top to pick them and read off the ids. Ignore any “add phone number” prompt.

4. 4

   Create a permanent access token

   The token shown on the API Setup page expires after 24 hours. You need a permanent one, which comes from a system user.

   Open business.facebook.com, go to your business portfolio's settings, then Users → System users, and select Add. Give it a name such as “Kuai” and the Admin role.

   Select Assign assets, choose your app and your WhatsApp Business Account, and grant Full control of each.

   Then select Generate new token, pick your app, set the expiry to Never, and tick both whatsapp_business_messaging and whatsapp_business_management.

   Copy the token immediately. Meta shows it once and you cannot retrieve it afterwards; you would have to generate a new one.

5. 5

   Copy the app secret

   In your app, go to App settings → Basic. Next to App secret, select Show and copy the value.

   Kuai uses this to verify that incoming messages genuinely came from Meta and not from someone imitating them.

6. 6

   Paste the four values into Kuai

   In Kuai, go to Dashboard → your company → WhatsApp, find Use Your Own WhatsApp Business, and paste in the WABA ID, phone number ID, access token and app secret. Select Connect.

   Kuai checks the details with Meta straight away. If anything is wrong you will see Meta's own error message, which usually names the problem exactly.

7. 7

   Point your webhook at Kuai

   Important: After connecting, Kuai shows you a Callback URL and a Verify token. Both are unique to your business.

   Back in your Meta app, go to WhatsApp → Configuration, select Edit beside Webhook, and paste them in. Save, then select Manage and subscribe to the messages field.

8. 8

   Send yourself a test message

   Message your business number from your own phone. It should appear in Kuai under Conversations on the same WhatsApp settings page within a few seconds.

   If it does not, the webhook in step 7 is almost always the reason. Check that the messages field is subscribed.