WhatsApp Business API Setup Guide 2026
Learn how to set up the WhatsApp Business API step by step — eligibility, BSP selection, template approval, and common errors fixed.
Connect your WhatsApp to Claude AI in minutes. Send messages, manage conversations, and automate workflows — all by talking to the most powerful AI assistant.

Imagine telling Claude: "Reply to my last 5 WhatsApp messages with a friendly response" — and it actually does it. No coding. No complicated setup. Just you and the most powerful AI assistant on the market, working together.
In this guide, you'll learn how to:

Think of it this way: right now, if you want Claude to help you with WhatsApp, you'd have to copy messages from your phone, paste them into Claude, get a response, and then copy it back to WhatsApp. Tedious, right?
With this integration, Claude talks directly to your WhatsApp. You simply tell Claude what to do — "send a message", "check my unread chats", "create a group" — and it happens instantly.
It's like connecting your email to Gmail. Once it's set up, it just works.
This is powered by something called MCP (Model Context Protocol) — but you don't need to understand what that means. All you need to know is: it's the bridge that lets Claude control your WhatsApp.
Not all AI assistants are created equal. Here's why Claude stands out for WhatsApp automation:
| Feature | Claude | ChatGPT | Other AI Tools |
|---|---|---|---|
| Thinks before acting | Yes | Partial | Varies |
| Handles multi-step tasks autonomously | Yes | Limited | Rarely |
| Understands full conversation context | Yes | Yes | Varies |
| Available as desktop app, web, CLI, and API | Yes | Web + API | Limited |
| Native WhatsApp integration support | Yes | Yes | Some |
Claude doesn't just respond — it reasons. When you ask it to "find my unhappy customers and draft personalized responses", Claude will:
No other AI assistant does this as reliably.
You only need two things:
1. A WhatsTeam account — This connects your WhatsApp number to the cloud so Claude can access it.
Don't have one? Create a free account here — it takes less than 2 minutes.
2. Your API key — Think of this as a personal password that lets Claude access your WhatsApp. Get your API key here — go to Settings → API Keys and create a new one or copy an existing one.

Works on both claude.ai and the Claude Desktop app. No installation required — this is the fastest way to get started.
Open Claude (web or desktop) and click the Customize icon in the left sidebar.

In the Customize panel, click Connectors.

Click the + button at the top, then select Add custom connector.

In the modal, enter a name (e.g., "WhatsApp") and paste your MCP server URL (replace YOUR_API_KEY with your actual key):
https://api.whats.team/mcp?key=YOUR_API_KEY
Then click Add.

Open a new conversation and try typing:
"Show me my connected WhatsApp devices"
Claude will respond with your WhatsApp account information. You're connected!
Get your free WhatsTeam API key and start automating WhatsApp with Claude in under 2 minutes!
You can also add the connector by editing a configuration file directly:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonhljs json{
"mcpServers": {
"whatsteam": {
"type": "http",
"url": "https://api.whats.team/mcp?key=YOUR_API_KEY"
}
}
}
Already have other integrations? Add the
"whatsteam": { ... }block inside the existing"mcpServers"section, separated by a comma.
After editing, restart Claude Desktop (Cmd + Q on Mac, Alt + F4 on Windows) and reopen it.
Perfect for: Developers who work from the terminal and want WhatsApp in their workflow.
Run this single command:
hljs bashclaude mcp add whatsteam https://api.whats.team/mcp?key=YOUR_API_KEY
Or add it to your project's .mcp.json file:
hljs json{
"servers": {
"whatsteam": {
"type": "http",
"url": "https://api.whats.team/mcp?key=YOUR_API_KEY"
}
}
}
Restart Claude Code and verify with:
"Ping the WhatsApp MCP server"
Perfect for: Building products, chatbots, or autonomous agents powered by Claude + WhatsApp.
hljs pythonimport anthropic
client = anthropic.Anthropic()
response = client.messages.create(
model="claude-sonnet-4-20250514",
max_tokens=1024,
messages=[
{"role": "user", "content": "Send a WhatsApp message to +12345678909 saying hello"}
],
mcp_servers=[
{
"type": "url",
"url": "https://api.whats.team/mcp?key=YOUR_API_KEY",
"name": "whatsteam"
}
]
)
hljs javascriptimport Anthropic from '@anthropic-ai/sdk'
const client = new Anthropic()
const response = await client.messages.create({
model: 'claude-sonnet-4-20250514',
max_tokens: 1024,
messages: [
{ role: 'user', content: 'Send a WhatsApp to +12345678909 saying hello' }
],
mcp_servers: [
{
type: 'url',
url: 'https://api.whats.team/mcp?key=YOUR_API_KEY',
name: 'whatsteam'
}
]
})
For full API documentation, visit the Anthropic MCP docs.
Here's what a real conversation with Claude looks like once WhatsApp is connected:
You: "Show me my connected WhatsApp devices"
Claude:
I found 3 connected devices on your WhatsTeam account:
Device Phone Status Sales +1 415 555 1234 Online Support +1 415 555 5678 Online Marketing +44 20 7946 0958 Online All 3 devices are online and ready to send messages. Which one would you like to use?
You: "Send a message from Sales to +1 212 555 9876 saying: Hi! Just checking in on your order. Let me know if you need anything."
Claude:
Message sent successfully!
From: Sales (+1 415 555 1234) To: +1 212 555 9876 Message: Hi! Just checking in on your order. Let me know if you need anything.
You: "Show me my last 5 conversations"
Claude:
Here are your 5 most recent conversations on the Sales device:
Contact Last Message Time Status Sarah M. (+1 212 555 9876) "Thanks, I'll check it out!" 2 min ago Active John D. (+44 77 1234 5678) "When will my order arrive?" 15 min ago Pending Maria Lopez (+34 612 345 678) "Perfecto, gracias!" 1 hour ago Active Alex Chen (+1 310 555 4321) "Can I change my delivery address?" 3 hours ago Pending Emma W. (+49 151 1234 5678) "Sent a photo" Yesterday Resolved You have 2 pending conversations that haven't been replied to. Want me to draft responses?
Now that you're connected, let's do something real. Open Claude and type these prompts one by one:
1. Check your connection:
"Show me my connected WhatsApp devices"
Claude will respond with a list of your devices, their phone numbers, and whether they're online — confirming everything works.
2. Send your first AI-powered message:
"Send a WhatsApp message to +12345678909 saying: Hi! This message was sent by Claude AI"
You'll see a confirmation with the sender, recipient, and message content. The message arrives on WhatsApp instantly.
3. Read your recent conversations:
"Show me my last 10 WhatsApp conversations with the contact name and last message"
Claude will show a formatted table of your recent chats with names, last message preview, and timestamps.
4. Get your first AI insight:
"Read my unread WhatsApp messages and give me a summary of what my contacts are asking about"
This is where Claude shines — it reads your messages, understands the context, and gives you a summary like:
"You received 12 messages today. 5 are about order status, 3 are asking for pricing info, 2 are support requests, and 2 are general greetings."
5. Your first automation:
"Check my unread messages. For each one, draft a friendly and professional reply. Show me the drafts before sending."
Claude reads each unread message, drafts a personalized response, and presents them for your approval:
Unread from John D.: "When will my order arrive?" Draft reply: "Hi John! Your order #4521 is on its way and should arrive by Thursday. I'll send you the tracking link shortly!"
Unread from Alex Chen: "Can I change my delivery address?" Draft reply: "Hi Alex! Of course. Could you send me the new address and I'll update it right away?"
Should I send these replies?
Here are real prompts you can copy and paste right now:
1. Customer Support on Autopilot
"Read my unread WhatsApp messages and respond to customer questions with helpful, friendly answers"
2. Smart Lead Follow-Up
"Which of my WhatsApp contacts messaged me in the last 24 hours but haven't received a reply? Draft a follow-up for each one"
Claude will identify unanswered conversations and draft personalized follow-ups:
Found 3 contacts without a reply: Sarah M., John D., and Maria Lopez. Here are my suggested follow-ups...
3. Broadcast a Promotion
"Send a promotional message to my last 20 active contacts saying: Special offer this week! 20% off all services. Reply YES to claim!"
4. Sentiment Check
"Analyze my last 50 WhatsApp conversations and tell me: how many customers seem happy, neutral, or frustrated?"
Claude reads through your conversations and gives you a breakdown:
Out of 50 conversations: 32 positive (64%), 12 neutral (24%), 6 frustrated (12%). The main complaints are about delivery times and response speed.
5. Team Group Creation
"Create a WhatsApp group called 'Q2 Marketing Team' and add these numbers: +12345678909, +12345678909, +12345678909"
6. Monthly Report
"Give me a report of my WhatsApp activity this month: total messages sent, received, most active contacts, and busiest day"
This month: 847 messages sent, 623 received, 45 new conversations. Most active day: Tuesday. Most active contact: Sarah M. (34 messages). Average response time: 12 minutes.
7. Instant Translation
"Translate this message to Spanish and send it to +12345678909: 'Your order has been shipped and will arrive in 2-3 business days'"
Sent to +12345678909: "Su pedido ha sido enviado y llegara en 2-3 dias habiles"
8. Scheduled Reminders
"Send a WhatsApp message to +12345678909 tomorrow at 9 AM saying: Reminder — our meeting is at 2 PM today"
9. Media Management
"Show me all the images and documents I received on WhatsApp today"
10. Team Task Assignment
"Check my unread chats. Assign the first 5 to agent Maria and the next 5 to agent Carlos"
Claude doesn't show WhatsApp tools
Message failed to send
Authentication error
Claude responds but doesn't execute WhatsApp actions
You've just unlocked the most powerful WhatsApp automation setup available today. With Claude's advanced reasoning and WhatsTeam's reliable WhatsApp connectivity, you can:
Start your free trial on WhatsTeam — connect your WhatsApp number to Claude in less than 5 minutes. No credit card required!
Learn how to set up the WhatsApp Business API step by step — eligibility, BSP selection, template approval, and common errors fixed.