Pro Client Setup

Set Up WhatsApp for Pro Clients

A complete guide for agencies and ISVs to give each Pro client a dedicated WhatsApp number using Twilio and the Meta WhatsApp Business API.

How It Works

This setup connects three services. Twilio provides the phone number, Meta provides the WhatsApp Business API, and AutoManus runs the AI agent.

1️⃣

Twilio

Phone number provider

About $1 to $5 per month

2️⃣

Meta

WhatsApp Business API

Handles all messaging

3️⃣

AutoManus

AI agent dashboard

Connect via API credentials

Key insight: Twilio only provides the number and verification. All actual WhatsApp messaging runs through Meta's Cloud API, not through Twilio.

What You Need

  • A Twilio account with billing enabled
  • Access to a Meta Business Suite account
  • Your client's business registration details (for the regulatory bundle)
  • An active AutoManus Pro subscription

Phase 1: Get a Twilio Number

1

Go to the Twilio Console

Log in at console.twilio.com, then go to Phone Numbers, then Buy a Number.

2

Search for a number

Select the client's country and choose a number with Voice and SMS capability.

UK numbers: UK numbers require a regulatory bundle before they can be purchased. See the next step.
3

Complete the UK regulatory bundle

If Twilio prompts for a regulatory bundle, create one with these choices:

  • Select ISV or reseller as the business type
  • Select yes when asked about sub-assigning the number to an end user
  • Select that a business receives and uses the number

Enter the client's business information:

  • Business name: The client's registered company name
  • Registration authority: Companies House (for UK companies)
  • Registration number: The client's company registration number
  • Website: The client's business website
  • Address: The client's registered business address

Review usually takes one to three business days. You can look up a company's details on Companies House.

4

Configure call forwarding

Twilio numbers can receive calls. Forward incoming voice calls to a real phone so customers are not dropped.

  1. Open the number in the Twilio Console
  2. Under Voice Configuration, set the call handler to a TwiML Bin
  3. Paste the TwiML below to forward calls
<?xml version="1.0" encoding="UTF-8"?>
<Response>
  <Dial>+YOUR_PERSONAL_PHONE</Dial>
</Response>

Replace +YOUR_PERSONAL_PHONE with the number where you want to receive forwarded calls.

Phase 2: Set Up Meta Business Suite

1

Open Meta Business Suite

Go to business.facebook.com, then Settings, then Accounts, then WhatsApp Accounts.

2

Create a new WhatsApp Business Account

Click Add to create a new WhatsApp Business Account (WABA) with these details:

  • Account name: The client's business name
  • Category: The category that best matches the client's business
3

Add the Twilio phone number

When prompted for a phone number:

  • Select add a new number
  • Enter the Twilio number you purchased
  • Select phone call verification (not SMS)
4

Receive the verification call

Meta will call the Twilio number with a verification code. Thanks to call forwarding, the call reaches your phone. Enter the code in Meta Business Suite.

Call not coming through? Check that call forwarding is configured on the Twilio number and that the forwarding destination can receive calls.
5

Register the number with the Cloud API

Register the phone number with Meta's Cloud API so it can send and receive messages. This step is often missed.

curl -X POST "https://graph.facebook.com/v21.0/PHONE_NUMBER_ID/register" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"messaging_product": "whatsapp", "pin": "123456"}'
If you skip this step:
  • The number will appear connected but messages will fail
  • The webhook will not deliver incoming messages
  • You will see errors when sending from AutoManus

Phase 3: Get API Credentials

1

Open the Meta developer console

Go to developers.facebook.com, then select your app, then go to WhatsApp, then API Setup.

2

Select the new phone number

On the API Setup page, select the client's phone number from the dropdown so the credentials below match it.

3

Copy the credentials

You need three values from the API Setup page:

  • Phone number ID: The ID shown next to the selected number
  • WhatsApp Business Account ID: The WABA ID for the client's account
  • Access token: The temporary token shown on the page
4

Generate a permanent token

The temporary token expires in 24 hours. Generate a permanent token from a system user:

  1. Go to Business Settings, then System Users
  2. Create a system user with the Admin role
  3. Click Generate Token
  4. Select your app and grant these permissions:
    • whatsapp_business_management
    • whatsapp_business_messaging
  5. Copy the generated token and store it securely

Phase 4: Connect to AutoManus

1

Open WhatsApp setup

Log into the client's AutoManus account and go to → /dashboard/whatsapp-setup

2

Use advanced setup

Click Advanced Setup to enter credentials manually instead of using the guided Facebook login.

3

Enter the credentials

Fill the form with the values from Phase 3:

  • Access token: The permanent system user token
  • Phone number ID: The phone number ID from API Setup
  • Business account ID: The WhatsApp Business Account ID
  • Display name: The name customers will see
4

Configure the webhook

In the Meta developer console, set the webhook so AutoManus receives incoming messages:

  • Callback URL: https://automanus.io/api/whatsapp/webhook
  • Verify token: automanus_webhook_2025
5

Connect and test

Save the configuration, then send a test message to the client's number. The AI agent should reply within a few seconds.

Transferring Ownership

When the engagement ends, you can hand the WhatsApp number and account over to the client.

Meta Business Suite

  1. Open Business Settings, then WhatsApp Accounts
  2. Select the client's WABA
  3. Add the client as a partner or assign their business
  4. Grant the client full control of the account
  5. Remove your own access once the client confirms

Twilio

In Twilio, you can sub-account or transfer the number to the client's Twilio account, or keep billing it through your account.

Costs

  • Twilio number: About $1 to $5 per month
  • Meta conversations: User-initiated conversations are free for 24 hours
  • Business-initiated: About $0.005 to $0.05 per conversation

Troubleshooting

UK regulatory bundle rejected

Make sure the business name, registration number, and address exactly match the official Companies House record.

SMS verification not working

Twilio numbers may not reliably receive SMS from Meta. Use phone call verification instead.

Verification call not received

Confirm call forwarding is set on the Twilio number and the destination phone can answer the call.

Number not available

If the number cannot be added in Meta, confirm it is not already registered with WhatsApp and that the regulatory bundle is approved.

Account not registered

If messages fail with a registration error, register the number with the Cloud API:

curl -X POST "https://graph.facebook.com/v21.0/PHONE_NUMBER_ID/register" \
  -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" \
  -d '{"messaging_product": "whatsapp", "pin": "123456"}'

Phone number not found

Confirm you selected the correct phone number in API Setup and that the credentials match that number.

No reply from the AI agent

Check that a deployment exists in own_whatsapp_deployments and that the agent is active for this number.

Resources