Skip to main content
Use manual setup when you manage the Meta Business Portfolio and want to connect a dedicated WhatsApp Cloud API number to Kapso. Manual setup does not require Facebook Login for Business and does not require an embedded signup config ID.

​
Before you start

You need:
  • a Meta app
  • admin access to the Meta Business Portfolio
  • access to the WhatsApp account or permission to create one
  • a phone number you can verify by SMS or voice call if it’s not already added to the portfolio

​
Add the phone number in Meta

In case you haven’t added the number in your Meta app:
  1. Open Use cases.
  2. Click Customize on Connect with customers through WhatsApp.
  3. Open API Setup.
  4. In Send and receive messages, open the From selector.
  5. Click Add phone number.
  6. Add your phone number.
  7. Verify it by SMS or voice call.
  8. Copy the Phone number ID.
  9. Copy the WhatsApp Business Account ID.
  10. Do not copy or generate a temporary access token for Kapso.
Paste the Phone number ID and WhatsApp Business Account ID into Kapso when the manual setup wizard asks for them.

​
Create a permanent system-user token

In Meta Business Settings:
  1. Go to Users > System users.
  2. Add a system user, such as Kapso API Access.
  3. Open the system user and click Assign assets.
  4. Under Apps, select the Meta app you saved in Kapso and grant full access.
  5. Under WhatsApp accounts, select the WhatsApp Business Account that owns the phone number and grant all available permissions.
  6. Save the app asset assignment.
  7. Click Generate token.
  8. Select the same Meta app.
  9. Set token expiration to Never.
  10. Select both whatsapp_business_management and whatsapp_business_messaging.
  11. Generate the token and copy it.
Meta only shows the token once. Paste it into Kapso before closing the Meta dialog. The system user needs both asset assignments. App access lets the token belong to your Meta app. WhatsApp account access lets Kapso manage the WABA assets behind that app, including phone number registration, templates, messaging, and webhook-related operations.

​
Create the number in Kapso

In Kapso:
  1. Open Connected numbers.
  2. Start the manual phone number setup flow.
  3. Choose the Meta app you saved under Meta apps.
  4. Enter the WhatsApp number name.
  5. Paste the Phone number ID.
  6. Paste the WhatsApp Business Account ID.
  7. Paste the permanent system-user token.
  8. Create the configuration.
Kapso generates a webhook verify token for this number.

​
Configure the Meta webhook

After Kapso creates the manual configuration, Kapso shows the callback URL and verify token to use in Meta. In your Meta app:
  1. Open Use cases.
  2. Click Customize on Connect with customers through WhatsApp.
  3. Open Configuration.
  4. In Webhooks, click Configure or Edit.
  5. Paste this callback URL:
https://meta-webhooks.kapso.ai/whatsapp
  1. Paste the verify token shown in Kapso.
  2. Subscribe to all webhook fields available in Meta.
  3. Click Verify and Save.
If you later change the webhook verify token in Kapso, update the verify token in Meta too.