WhatsApp Business
Overview
WhatsApp Business integration enables your AI Agent to communicate with customers through the world's most popular messaging platform. With over 2 billion users globally, WhatsApp provides a familiar and convenient channel for customer support, sales, and engagement.
This integration leverages Meta's WhatsApp Business API to provide:
- 24/7 automated customer support through your verified business number
- Seamless handover to human agents when needed
- Rich messaging capabilities including text, images, and interactive elements
- Global reach with end-to-end encryption for secure conversations
Prerequisites
Before setting up the WhatsApp integration, ensure you have:
✅ A dedicated phone number for WhatsApp Business
- Must be able to receive SMS or voice calls for verification
- Cannot be registered to any existing WhatsApp account (personal or business)
- Can be migrated from another WhatsApp Business provider if needed
✅ Business verification requirements
- Company's legal name and website
- Valid business email address
- SSL-secured website with clear business information
✅ Meta Business Account (or ability to create one)
- Admin access to your Facebook Business Manager
- Authority to grant permissions to third-party apps
✅ Moveo account setup
- An active AI Agent configured
- An environment to connect the integration
How it works
The WhatsApp Business integration creates a bridge between your customers on WhatsApp and your Moveo AI Agent:
- Customer initiates conversation by messaging your WhatsApp Business number
- Moveo receives the message through Meta's WhatsApp Business API
- AI Agent processes and responds based on your configured knowledge and dialogs
- Messages are delivered back to the customer through WhatsApp
- Handover to human agents when the AI Agent determines it's necessary
All conversations maintain WhatsApp's end-to-end encryption and comply with Meta's business messaging policies.
Setup guide
Moveo offers two methods to connect WhatsApp Business:
Option 1: Embedded Signup (Recommended)
The embedded signup flow is the fastest way to get started. It handles all the technical configuration automatically.
📱 Connect with Embedded Signup
Step 1: Prepare your information
Before starting, gather:
- Your phone number for WhatsApp Business
- Company registration details
- Business website URL
- Business email address
Step 2: Start the connection process
- Navigate to Integrations in your Moveo account
- Select your environment
- Click Configure on the WhatsApp card
- Select Connect
Step 3: Authenticate with Meta
- Log in to Facebook with your personal or professional account
- Select Continue as [Your Name]
- Select Get Started
Step 4: Configure Meta Business Account
- Select or create
- Create new account
- Select existing account



- Existing account: Select from dropdown
- New account: Fill in your company information
Step 5: Set up WhatsApp Business Account
- Select or create
- Create new account
- Select existing account



Fill in:
- Account Name
- Display Name (shown to customers)
- Business Category
Step 6: Verify your phone number
- Insert phone number
- Verify phone number
- Permissions
- Limits




- Enter your phone number
- Choose verification method (SMS or voice call)
- Enter the 6-digit verification code
- Review permissions and limits
- Click Finish
Step 7: Activate the integration
- Return to Moveo's Integration page
- Wait for account registration to complete (usually instant)
- Toggle Active to enable the integration
- Click Get Started
Option 2: Manual Setup
⚙️ Manual connection flow (Advanced)
Use this method if you need custom configuration or already have a WhatsApp Business API setup.
Prerequisites for manual setup
- Verified Facebook Business Manager account with admin access
- Meta developer account with an App connected to your Business Manager
Step 1: Create WhatsApp product in your Meta App
- Navigate to your Meta App
- Go to Add Product page
- Click Set up under WhatsApp
- Select your Meta Business Manager account
- Add product
- Select account


Step 2: Add and verify your phone number
- Click Add phone number in your WhatsApp product
- Complete the verification form
- Wait for Meta verification (1-2 business days)
Monitor verification status in WhatsApp Manager:

Step 3: Configure Moveo integration
In Moveo Console:
- Add a new WhatsApp Integration
- Select Manual setup
- Configure the following fields:

Required configuration:
Field | Where to find it |
---|---|
Access Token | Generate via Business Manager with whatsapp_business_messaging and whatsapp_business_management permissions |
App Secret | Meta App → Settings → Basic |
Phone Number ID | WhatsApp product → Your phone number |
Verify Token | Create your own secure token |
Step 4: Configure webhook
- Get your Integration ID from the Moveo URL
- In Meta App → WhatsApp → Configuration:
- Callback URL:
https://channels.moveo.ai/v1/whatsapp/<YOUR_INTEGRATION_ID>
- Verify token: Use the token from Step 3
- Subscribe to
messages
webhook field
- Callback URL:

Step 5: Register phone number
After Meta verifies your number:
- Go to WhatsApp Configuration in Meta App
- Register your phone number

Configuration options
Business profile customization
Customize how your business appears to customers in WhatsApp:
- Profile picture: Your business logo or avatar
- Business description: Brief description of your services
- Business hours: Operating hours displayed to customers
- Category: Industry classification
- Website: Link to your business website
Access these settings in WhatsApp Manager.
Message templates
WhatsApp requires pre-approved templates for business-initiated conversations:
- Create templates in WhatsApp Manager
- Submit for Meta approval (24-48 hours)
- Use approved templates for:
- Appointment reminders
- Order updates
- Account notifications
- Re-engagement campaigns
Rate limits and messaging tiers
WhatsApp assigns messaging tiers based on your business verification and quality rating:
Tier | Daily conversation limit | Requirements |
---|---|---|
Unverified | 50 | Phone number verified |
Tier 1 | 1,000 | Business verified |
Tier 2 | 10,000 | Quality rating: Medium or High |
Tier 3 | 100,000 | Consistent quality metrics |
Tier 4 | Unlimited | High volume, excellent quality |
Testing your integration
Test mode
Before going live, test your AI Agent with WhatsApp using Moveo's test number:
- Go to Integrations → WhatsApp
- Select Test Integration
- Add your personal WhatsApp number
- Send a message to the test number
- Verify AI Agent responses

Test scenarios
Validate these key scenarios:
- ✅ Welcome message and greeting
- ✅ FAQ responses
- ✅ Multi-turn conversations
- ✅ Handover to human agent
- ✅ Media handling (images, documents)
- ✅ Error handling and fallback responses
Common use cases
Customer support
- 24/7 automated responses to common queries
- Order status and tracking information
- Technical troubleshooting guides
- Escalation to human agents for complex issues
Sales and lead generation
- Product information and recommendations
- Price quotes and availability checks
- Appointment scheduling
- Lead qualification and routing
Notifications and updates
- Order confirmations and shipping updates
- Appointment reminders
- Account alerts and security notifications
- Marketing campaigns (with user consent)
Troubleshooting
Connection issues
Phone number verification fails
- Ensure the number can receive SMS/calls
- Check it's not registered to any WhatsApp account
- Try voice call if SMS doesn't arrive
- Contact Meta support if verification repeatedly fails
Business verification pending
- Review your website for clear business information
- Ensure SSL certificate is valid
- Add privacy policy and terms of service
- Typical approval time: 1-2 business days
Messages not being received
- Verify integration is set to Active
- Check webhook configuration in Meta App
- Confirm phone number registration is complete
- Review Meta App permissions
Message delivery issues
Customer doesn't receive responses
- Check WhatsApp messaging tier limits
- Verify template approval for business-initiated messages
- Review quality rating in WhatsApp Manager
- Ensure customer hasn't blocked your number
Media files not sending
- Verify file size limits (images: 5MB, documents: 100MB)
- Check supported formats (JPEG, PNG, PDF, etc.)
- Ensure proper media URL configuration
- Review Meta's media guidelines
Limitations
Platform limitations
- 24-hour messaging window: After 24 hours of customer inactivity, only template messages allowed
- Media restrictions: Limited file types and sizes
- Rate limits: Based on tier and quality rating
- Template approval: Required for business-initiated conversations
Integration constraints
- One phone number per WhatsApp Business account
- Cannot use personal WhatsApp numbers
- Business verification required for higher tiers
- Geographic restrictions in some countries
Resources
Official documentation
Support
Next steps
Once your WhatsApp integration is active:
- Configure your AI Agent with WhatsApp-specific responses
- Set up message templates for proactive messaging
- Test thoroughly before promoting your WhatsApp number
- Monitor analytics to optimize response quality
- Train your team on handover procedures