> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kapso.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Manual phone number setup

> Connect a WhatsApp number you configure directly in Meta

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](/docs/platform/create-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](https://business.facebook.com/latest/settings/system_users):

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:

```text theme={null}
https://meta-webhooks.kapso.ai/whatsapp
```

6. Paste the verify token shown in Kapso.
7. Subscribe to all webhook fields available in Meta.
8. Click **Verify and Save**.

If you later change the webhook verify token in Kapso, update the verify token in Meta too.