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
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
Go to Twilio Console
Log in at console.twilio.com → Phone Numbers → Buy a Number
Search for a number
Select the client's country and check Voice capability (for Meta verification).
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.
Configure call forwarding
To receive Meta's verification call, configure the number to forward to your phone:
- Go to Phone Numbers → Active Numbers → Click the number
- Under "A Call Comes In", select TwiML Bin
- 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
Open Meta Business Suite
Go to business.facebook.com → Settings → Accounts → WhatsApp accounts
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
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)
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.
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"}'- 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
Open Meta Developer Console
Go to developers.facebook.com → Select your app → WhatsApp → API Setup
Select the new phone number
In the "From" dropdown, select the client's phone number you just added.
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)
Generate permanent access token
The temporary token expires in 24 hours. For production, create a System User token:
- Go to Business Settings → System Users
- Create a System User (Admin role)
- Click "Generate Token"
- Select your app and grant permissions:
- whatsapp_business_management
- whatsapp_business_messaging
- Copy the generated token (save it securely - it won't be shown again)
Phase 4: Connect to AutoManus
Open WhatsApp Setup
Log into the client's AutoManus account → /dashboard/whatsapp-setup
Use Advanced Setup
Click Advanced Setup (not the OAuth flow)
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
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
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
- Go to the WhatsApp Business Account → People tab
- Click "Assign people" and add the client's email
- Give them "Full control" access
- They accept the invitation
- 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.