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.

February 28, 2026•6 min read•By Alaa Sumrain

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

  1. Go to your Zaki dashboard
  2. Navigate to Channels → WhatsApp
  3. Click "Connect"
  4. A QR code appears

Step 2: Scan QR Code

  1. Open WhatsApp on your phone
  2. Go to Settings → Linked Devices
  3. Scan the QR code
  4. 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:

  1. Dashboard → Channels → WhatsApp → Disconnect
  2. 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

  1. Deploy your Zaki (60 seconds)
  2. Connect WhatsApp (2 minutes)
  3. Start messaging your AI assistant

Related

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.