Onboard customers with your own Meta app

Onboard customers through Kapso setup links under your own Meta app, without MPS. Kapso runs messaging; customers pay Meta fees directly.

At a glance

Configure Embedded Signup and save the configuration in Kapso.
Create a Kapso customer for each business you serve.
Generate a setup link and let the customer connect their WhatsApp account.
Confirm the connection and start messaging.

Without MPS, Kapso can’t pay Meta for your customers: each customer adds their own payment method in Meta. For managed billing with your own app, set up a Multi-partner Solution, or use Kapso’s Meta app.

Requirements

You need:

a Meta app
Facebook Login for Business on that app
an embedded signup configuration ID
Be a Meta Tech Provider.

In your Meta app:

Add Facebook Login for Business if it is not already present.
Open Facebook Login for Business > Configurations.
Create a configuration from the WhatsApp embedded signup template when available.
If you create a custom configuration, choose the WhatsApp Embedded Signup login variation.
Select only the assets and permissions your customers need.
Save the configuration.
Copy the generated Configuration ID.

This Configuration ID is the Embedded signup config ID Kapso asks for. In Facebook Login for Business > Settings, configure the OAuth and JavaScript SDK settings required by Meta. Add the domains where customers launch setup links or embedded signup. For Kapso-hosted setup links, include the Kapso setup domain shown in the generated link, usually app.kapso.ai. If you launch setup from your own app, include your app domain too. Meta requires HTTPS domains for embedded signup.

Add the config ID in Kapso

In Kapso, open Connected numbers > Meta apps.
Edit or add your Meta app.
Turn on Default app for embedded signup.
Paste the Embedded signup config ID.
Save.

Kapso setup links and reconnect flows can now use this app for embedded signup.

Create customers

Create one Kapso customer per business you serve.

curl -X POST https://api.kapso.ai/platform/v1/customers \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customer": {
      "name": "Acme Clinic",
      "external_customer_id": "acme-clinic"
    }
  }'

Use external_customer_id to map Kapso customers back to your own database.

Generate setup links

Create a setup link for each customer.

curl -X POST https://api.kapso.ai/platform/v1/customers/{customer_id}/setup_links \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "setup_link": {
      "success_redirect_url": "https://your-app.com/whatsapp/success",
      "failure_redirect_url": "https://your-app.com/whatsapp/failed",
      "meta_billing_mode": "customer_managed",
      "allowed_connection_types": ["dedicated"]
    }
  }'

Send the returned url to the customer or open it from your onboarding UI. To launch onboarding directly inside your own product through an active Multi-partner Solution, see Embed WhatsApp onboarding. Use allowed_connection_types to control the customer path:

["dedicated"] for API-only WhatsApp Cloud API numbers
["coexistence"] for customers who want to keep using the WhatsApp Business App alongside Kapso
["coexistence", "dedicated"] when you want the customer to choose

If you want Kapso to provision a number during setup, add:

{
  "setup_link": {
    "provision_phone_number": true,
    "phone_number_country_isos": ["US"]
  }
}

Detect completion

Use both redirect handling and webhooks. The success redirect can include setup details such as:

status
phone_number_id
business_account_id
display_phone_number
setup_link_id

For server-side reliability, subscribe to Kapso project webhooks and listen for whatsapp.phone_number.created. See Detecting WhatsApp connection and Webhooks.

Operate the customer number

After setup completes, use the customer’s phone_number_id.

curl -X POST https://api.kapso.ai/meta/whatsapp/v24.0/{phone_number_id}/messages \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "15551234567",
    "type": "text",
    "text": {
      "body": "Your appointment is confirmed."
    }
  }'

Getting started

WhatsApp

For your team