Blog
Zaki + WhatsApp: AI Assistant on Your Primary Messaging App
Connect Zaki to WhatsApp for AI assistance on the messaging app you already use. Setup guide, capabilities, and limitations.
WhatsApp is where 2 billion people message. If that includes you, connecting Zaki to WhatsApp means your AI assistant is always one text away.
But WhatsApp integration has quirks you should know about. Here's the honest guide.
Why WhatsApp?
It's Already Your Messaging App
You don't need to install anything new. You don't need to check a different app. Your AI assistant lives where you already communicate.
Universal
Your clients, family, and colleagues are probably on WhatsApp. An AI that works on WhatsApp integrates into your real communication patterns.
Voice Messages
Record a voice note, get a response. Great for hands-free operation or when typing is inconvenient.
Global
WhatsApp dominates in Europe, Latin America, India, and much of the world. If you work internationally, it's often the default communication channel.
The Honest Limitations
Before setup, understand what you're getting into:
Session Persistence
WhatsApp uses a web-based authentication that requires periodic re-authentication. If your server restarts, you may need to scan a QR code again.
This is a WhatsApp limitation, not a Zaki limitation. It's why Telegram is often recommended as the more stable option.
Rate Limits
WhatsApp has strict rate limits to prevent spam. If you send too many messages too quickly, you may get temporarily blocked.
Business vs Personal
WhatsApp Business API is more stable but requires application approval and has costs. Personal WhatsApp works but has the session persistence issues noted above.
No Read Receipts for Bots
You can't see if someone read your bot's message through the standard bot interface.
Setup: Personal WhatsApp
Step 1: Connect in Dashboard
- Go to your Zaki dashboard
- Navigate to Channels → WhatsApp
- Click "Connect"
- A QR code appears
Step 2: Scan QR Code
- Open WhatsApp on your phone
- Go to Settings → Linked Devices
- Scan the QR code
- Wait for connection confirmation
Step 3: Configure
Set your preferences:
- Allow from: Which numbers can message your Zaki
- Group policy: Whether to respond in groups
Step 4: Test
Send a message to your own number (or the linked number) and verify Zaki responds.
What You Can Do
Personal Assistant
Text your Zaki just like texting a friend:
You: What's on my calendar today?
Zaki: You have 3 meetings: 10am standup, 2pm client call, 4pm 1:1 with Sarah.
You: Remind me to call the dentist at 3pm
Zaki: Done. I'll remind you at 3pm.
You: Draft a reply to John's email about the proposal
Zaki: Here's a draft: "John, thanks for sending..."
Voice Commands
Hold to record, release to send:
"Hey, I need to reschedule tomorrow's call with Sarah to Thursday afternoon. Can you draft a message for me?"
Zaki transcribes, processes, and responds.
File Sharing
Send documents for processing:
[Attached: contract.pdf]
You: Summarize the key terms
Zaki: Key terms:
• 12-month commitment
• 30-day termination notice
• Liability cap: $100,000
• Auto-renewal unless cancelled
Quick Captures
WhatsApp is always accessible. Use it for quick captures:
You: Note: Mike mentioned they're launching in March
Zaki: Saved. I've added this to your notes about Mike's company.
Business Use Cases
Client Communication
Forward client messages for quick responses:
You: [Forwards client message] How should I respond to this?
Zaki: Based on your past conversations with this client, I'd suggest: "..."
Team Coordination
Add Zaki to a team group (with appropriate permissions):
Team member: @Zaki when is our next deadline?
Zaki: Your next deadline is March 15th - the proposal submission.
Sales Support
Quick info lookup while in conversations:
You: What's our pricing for enterprise plans?
Zaki: Enterprise starts at $X/month for Y users, includes Z features.
Stability Tips
Use Telegram as Backup
Given WhatsApp's session persistence issues, set up Telegram as a backup channel. It's more stable for always-on bot connections.
Keep Your Server Running
Session breaks often happen when the server hosting your Zaki restarts. With managed hosting like Zaki, this is handled for you.
Don't Spam
WhatsApp's rate limits are strict. Don't configure automation that sends dozens of messages quickly.
Regular Check-ins
Occasionally verify your WhatsApp connection is still active. The dashboard shows connection status.
Security
Who Can Message
Configure allowlist in your dashboard:
- Specific phone numbers
- Anyone (not recommended)
What Gets Stored
- Messages process through WhatsApp's servers (end-to-end encrypted)
- Your Zaki processes on dedicated hardware
- Conversation memory stays on your instance
Disconnecting
To fully disconnect:
- Dashboard → Channels → WhatsApp → Disconnect
- On your phone: Settings → Linked Devices → Remove the session
WhatsApp vs Telegram
| Feature | WhatsApp | Telegram | | ----------------- | ----------------------------- | --------------- | | Session stability | Poor (requires re-auth) | Excellent | | Setup complexity | Medium | Easy | | Global reach | Highest | High | | Voice messages | Yes | Yes | | File handling | Good | Excellent | | Rate limits | Strict | Relaxed | | Recommended | For users already on WhatsApp | For reliability |
Bottom line: If WhatsApp is your primary messaging app and you're okay with occasional re-authentication, use it. If you want maximum reliability, use Telegram.
Troubleshooting
QR Code Won't Scan
- Ensure your phone has internet connection
- Try refreshing the QR code in dashboard
- Clear WhatsApp cache and try again
Connection Dropped
- Server restart likely caused session loss
- Re-scan QR code to reconnect
- With managed hosting, this happens less frequently
Messages Not Delivering
- Check connection status in dashboard
- Verify recipient number is correct
- Check if you've hit rate limits
Slow Responses
- Complex requests take time
- Large file analysis adds latency
- Check your AI API key status
Get Started
- Deploy your Zaki (60 seconds)
- Connect WhatsApp (2 minutes)
- Start messaging your AI assistant
Related
- Zaki + Telegram Integration (recommended for stability)
- Zaki + Discord Integration
- 50 Things to Do With Zaki
Related Articles
11 Businesses You Can Build on OpenClaw Right Now (Before Everyone Else Does)
Every major platform shift creates a new economy. OpenClaw is the Linux kernel moment for AI agents. Here are 11 real businesses you can build in the agent economy—from forks and skills to deployment and professional services.
Zaki vs Zaki: Managed AI Agents vs Self-Hosted (2026 Comparison)
The honest comparison between Zaki managed hosting and self-hosted Zaki. Costs, security, setup time, and which one is right for your use case.
Zaki + Telegram: Your AI Assistant in Your Pocket
How to connect Zaki to Telegram for mobile AI assistance. Text commands, voice messages, file sharing, and 24/7 automation from your phone.
Ready to deploy your Mission Control?
Stop managing servers. Start managing outcomes. Deploy your first Zaki agent in 60 seconds.
Alaa Sumrain
Building Zakified — dedicated AI agent hosting powered by OpenClaw. These guides come from running real agent swarms in production across dozens of business use cases.