Why Connect WhatsApp?
Instant AI Responses
Customers get immediate answers based on your website’s knowledge base
24/7 Availability
AI responds day and night, even when your team is offline
Human Takeover
Support agents can jump into any conversation from the dashboard
Conversation History
All WhatsApp conversations are logged and searchable
Multi-Language
AI supports 100+ languages for international customers
Knowledge-Powered
Answers based on your website’s content and documentation
What Can the WhatsApp Bot Do?
Answer Customer Questions Instantly
Your customers can ask questions about your products, services, or content directly through WhatsApp: Example Questions:Provide 24/7 Support
- Responds instantly to common questions
- No waiting for business hours
- Reduces support ticket volume
- Consistent, accurate answers
Search Your Knowledge Base
The bot uses your website’s content to provide accurate answers:- Product information
- Help articles
- FAQ sections
- Pricing details
- Shipping information
Human Agent Handoff & Unified Inbox
WhatsApp messages appear in your Live Support unified inbox alongside website widget and other platform conversations. Each conversation shows a WhatsApp badge so you always know the source platform.WhatsApp has a 24-hour messaging window for customer-initiated conversations. After 24 hours, only template messages can be sent. BubblaV handles this automatically.
- Go to Live Support in your dashboard
- Find the WhatsApp conversation (look for the WhatsApp badge)
- Click to open and type your reply
- Your message is sent directly to the customer’s WhatsApp
- The AI remains paused while you’re active in the conversation
Prerequisites
- A WhatsApp Business API account linked to a Meta Business account
- A Facebook Page connected to your WhatsApp Business account
- Active BubblaV account with a website
- Website with knowledge base content (crawled pages)
Setup Steps
Authorize with Meta
You’ll be redirected to Meta:
- Log in to your Meta/Facebook account if prompted
- Review the permissions requested
- Click Continue to authorize BubblaV
Select Phone Numbers
If your WhatsApp Business account has multiple phone numbers:
- All eligible numbers will be connected automatically
- You’ll see a summary of connected numbers
Verify Connection
Return to the BubblaV dashboard. The WhatsApp integration should now show Connected with your phone numbers
Managing Your Integration
View Connected Numbers
From the WhatsApp configuration page, you can see:- Display phone number
- Phone name and business name
- Connection status
Debug Information
The configuration page includes a Developer Debug Information section with:- Phone Number ID
- Business Account ID
- Access Token (masked)
- Webhook URL
- Meta Developer Console link
Disconnect Your Numbers
To remove the WhatsApp integration:- Go to Dashboard → Your Website → Integrations
- Click WhatsApp → Configure
- Scroll to Danger Zone
- Click Disconnect
- Confirm the disconnection
How Messages Are Processed
- Customer sends message → Message arrives at your WhatsApp Business number
- Webhook triggers → BubblaV receives the message via Meta’s WhatsApp Business API
- AI analyzes question → Your website’s knowledge base is searched
- Response generated → AI formulates an answer with sources
- Sent to WhatsApp → Customer receives the response
- Conversation logged → Message stored in your dashboard
WhatsApp Messaging Policies
24-Hour Messaging Window
WhatsApp has specific policies about when you can send messages:- Customer-initiated: Free-form messaging allowed within 24 hours
- After 24 hours: Only pre-approved template messages are allowed
- Our bot tracks: We automatically respect the 24-hour window
Rate Limits
- Messages are subject to WhatsApp’s rate limits
- Messages are truncated at 4096 characters
- Our implementation handles these limits automatically
Troubleshooting
Messages Not Being Received
- Check webhook status in Meta Developer Console
- Verify phone number is subscribed to messaging events
- Check BubblaV logs for errors in the dashboard
- Confirm integration is active in your settings
Bot Not Responding
- Verify integration is active in the dashboard
- Check your website has crawled content in Knowledge section
- Test with a simple question like “What are your hours?”
- Check the debug information section for missing credentials
OAuth Errors
- Verify redirect URI matches the expected callback URL
- Check Meta App permissions include WhatsApp messaging permissions
- Try disconnecting and reconnecting the integration
- Ensure you’re a Business account admin with proper permissions
Human Takeover Not Working
- Check Live Support is enabled for your website
- Verify agent is active in the conversation
- Look for takeover status in the conversation metadata
- Ensure the AI paused when agent joined
FAQ
Do I need a WhatsApp Business API account?
Do I need a WhatsApp Business API account?
Yes. WhatsApp requires a Business API account (managed through Meta Business Suite) for automated messaging. BubblaV helps you connect this during the setup process.
Can I connect multiple WhatsApp numbers?
Can I connect multiple WhatsApp numbers?
Yes! You can connect multiple WhatsApp Business numbers to a single website. All eligible phone numbers linked to your Meta Business account will be connected automatically during setup.
What happens when the AI can't answer?
What happens when the AI can't answer?
If the AI is unsure or the customer needs complex help, they can be escalated to a human agent. You’ll see all conversations in the Live Support dashboard and can jump in anytime.
Is there a messaging limit?
Is there a messaging limit?
WhatsApp has messaging window policies for business-initiated conversations. Customer-initiated conversations have a 24-hour window for free-form messaging. After that, only template messages can be sent.
Can I customize the bot responses?
Can I customize the bot responses?
The AI uses your website’s content to generate responses. To improve answer quality, ensure your website has comprehensive, up-to-date information. You can also add custom content through the Knowledge section.
What languages does the bot support?
What languages does the bot support?
The AI supports 100+ languages and can automatically detect the language being used to respond appropriately.
Next Steps
- Set up your Live Support to monitor conversations
- Improve your Knowledge Base content for better answers
- Explore other Integrations to connect more platforms
