Pro Client Setup

Set Up WhatsApp for Pro Clients

This guide is for agencies and ISVs setting up dedicated WhatsApp numbers for Pro clients. You'll purchase a Twilio number, register it with Meta WhatsApp Business API, and connect it to AutoManus.

How It Works

The setup involves two services working together:

1️⃣

Twilio

Phone number provider

~$1.15/month

2️⃣

Meta

WhatsApp Business API

All messaging

3️⃣

AutoManus

AI Agent + Dashboard

Connect via API

Key insight: Twilio only provides the phone number. Meta handles all WhatsApp messaging, webhooks, and API calls. You register the Twilio number with Meta to get WhatsApp capabilities.

What You Need

  • Twilio account (yours as the ISV)
  • Meta Business Suite access (yours as the ISV)
  • Client's business registration info (for UK regulatory bundle)
  • AutoManus Pro subscription for the client

Phase 1: Buy Twilio Number

1

Go to Twilio Console

Log in at console.twilio.com → Phone Numbers → Buy a Number

2

Search for a number

Select the client's country and check Voice capability (for Meta verification).

UK numbers: Most UK local numbers don't have SMS. That's okay - use Voice verification with Meta instead. Mobile numbers (+44 7xxx) may have SMS but require a regulatory bundle.
3

UK Regulatory Bundle (if required)

For UK mobile numbers, Twilio requires a regulatory bundle. When prompted:

  • Select ISV/Reseller (you manage it for clients)
  • Select Yes for subassigning to end customers
  • Select Business for who receives calls

Enter the client's business info:

  • Business Name: Client's registered company name
  • Registration Authority: UK:CRN
  • Registration Number: Their Companies House number
  • Website: Client's website
  • Address: Registered business address

Review takes 1-2 business days. You can look up UK company info at Companies House.

4

Configure call forwarding

To receive Meta's verification call, configure the number to forward to your phone:

  1. Go to Phone Numbers → Active Numbers → Click the number
  2. Under "A Call Comes In", select TwiML Bin
  3. Create a new TwiML Bin with this code:
<?xml version="1.0" encoding="UTF-8"?>
<Response>
 <Dial>+YOUR_PERSONAL_PHONE</Dial>
</Response>

Replace +YOUR_PERSONAL_PHONE with your actual phone number. Save both the TwiML Bin and the number configuration.

Phase 2: Create WhatsApp Business Account

1

Open Meta Business Suite

Go to business.facebook.com → Settings → Accounts → WhatsApp accounts

2

Create a new WhatsApp Business Account

Click + Add → Create a WhatsApp Business Account

  • Account name: Client's business name (e.g., "Patchwork Films")
  • Category: Best match for their 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 for verification (not SMS)
4

Receive verification call

Meta will call the Twilio number. Since you configured call forwarding, it will ring your personal phone. Listen for the 6-digit code and enter it in Meta.

If the call doesn't come through: Check Twilio Console → Monitor → Logs → Calls to see if the call arrived. Make sure your TwiML Bin is saved and assigned to the number.
5

Register with Cloud API (CRITICAL!)

After phone verification completes, you MUST register the number with Meta's Cloud API. 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 won't appear when searched on WhatsApp
  • API returns "Error 133010: Account not registered"
  • Phone verification shows VERIFIED but messaging doesn't work

Phase 3: Get API Credentials

1

Open Meta Developer Console

Go to developers.facebook.com → Select your app → WhatsApp → API Setup

2

Select the new phone number

In the "From" dropdown, select the client's phone number you just added.

3

Copy the credentials

You need three values:

  • Phone Number ID - Numeric ID shown in the panel
  • WhatsApp Business Account ID - Also shown in the panel
  • Access Token - Generate via System User (see below)
4

Generate permanent access token

The temporary token expires in 24 hours. For production, create a System User token:

  1. Go to Business Settings → System Users
  2. Create a System User (Admin role)
  3. Click "Generate Token"
  4. Select your app and grant permissions:
    • whatsapp_business_management
    • whatsapp_business_messaging
  5. Copy the generated token (save it securely - it won't be shown again)

Phase 4: Connect to AutoManus

1

Open WhatsApp Setup

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

2

Use Advanced Setup

Click Advanced Setup (not the OAuth flow)

3

Enter credentials

Fill in the form with the values from Phase 3:

  • Access Token: The System User token
  • Phone Number ID: From Meta Developer Console
  • Business Account ID: From Meta Developer Console
  • Display Name: Client's business name
4

Configure webhook (already done)

AutoManus shows the webhook URL and verify token. These should already be configured in your Meta app:

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

Connect and test

Click Connect WhatsApp. Then send a test message from a personal phone to the new WhatsApp number. The AI agent should respond.

Transferring Ownership Later

If the client wants full control of their WhatsApp Business Account later:

Meta Business Suite

  1. Go to the WhatsApp Business Account → People tab
  2. Click "Assign people" and add the client's email
  3. Give them "Full control" access
  4. They accept the invitation
  5. Optionally remove yourself (or stay for support)

Twilio

The phone number can stay on your Twilio account (it's just a number). If the client wants it transferred, contact Twilio support or have them port it to their own carrier.

Costs

  • Twilio number: ~$1.15/month (varies by country)
  • Meta WhatsApp API: Free (customer-initiated messages for 24h)
  • Business-initiated messages: $0.005-0.05 per conversation

Troubleshooting

UK number requires regulatory bundle

UK mobile numbers (+44 7xxx) require Twilio regulatory bundle approval. Use the client's Companies House registration info. Review takes 1-2 business days.

SMS verification not working

Many UK Twilio numbers can't receive SMS from automated systems. Use Voice verification instead - configure call forwarding in Twilio and select "Phone call" in Meta.

Verification call goes to Twilio demo

You haven't configured call forwarding. Go to Phone Numbers → Active Numbers → Click the number → set "A Call Comes In" to a TwiML Bin that forwards to your phone.

Number "not available" after creating bundle

The specific number was purchased by someone else while you were setting up the bundle. Go back and buy a different number - your regulatory bundle works for any UK mobile number.

API Error: "Account not registered" (133010)

The phone is verified but NOT registered for Cloud API messaging. Run this curl command:

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"}'

Number not found on WhatsApp / shows "Invite to WhatsApp"

The Cloud API registration step was skipped. Phone verification alone is not enough. Run the /register API call above.

Messages received but AI doesn't reply

Check if an AI agent is deployed to this WhatsApp account. Go to AI Agent → Overview → Deploy to the WhatsApp number. Also verify the own_whatsapp_deployments table has a record.

Resources