# Put your AI agent on WhatsApp

Source: https://catalex.co/whatsapp-ai-agent/ · Updated 2026-11-19

CatalEx connects an existing Claude Code or Codex agent to WhatsApp. People message a WhatsApp number and your agent replies, with buttons, images and files where WhatsApp supports them. Use a WhatsApp Business number through Meta, or link your own number. No server, webhook or public address.

## Two ways to put an agent on WhatsApp

| | WhatsApp Business number | WhatsApp Personal |
|---|---|---|
| Best for | Customers messaging a business | Your own contacts and groups |
| How it connects | Your Meta developer app and WhatsApp Business credentials | CatalEx is linked to your phone as a device, like WhatsApp Web |
| Approvals and questions | Buttons | A message with a poll |
| Status | Available | Available, experimental |

WhatsApp does not officially support linking automation tools to personal numbers and may restrict a number that uses them. Use a business number for customer-facing agents.

## What people see in WhatsApp

Replies arrive as normal WhatsApp messages. CatalEx turns the agent's output into readable text, reply buttons, chart images and the original files. When a reply needs a control WhatsApp cannot show, the person is told to continue in the CatalEx app. Your agent needs no WhatsApp-specific instructions.

When the agent wants to do something you marked as needing approval, it asks in the chat and waits for a yes or no.

## What teams use a WhatsApp agent for

- **Customer support.** Answer order, delivery and refund questions, and hand off to a person when the agent cannot act.

- **Bookings.** Offer slots, confirm appointments and send reminders.

- **Sales follow-up.** Qualify an inbound lead and pass a summary to your team.

- **Proactive messages.** If you allow it, the agent can start a conversation, for example a reminder or a "your report is ready" note, within limits you set.

## How to connect your agent to WhatsApp

1. **Install CatalEx**: Download [CatalEx for Mac](https://downloads.catalex.co/latest/CatalEx-arm64.dmg) and sign in with Google.
2. **Add your agent**: Point CatalEx at your Claude Code or Codex agent's folder and check it answers in the app's chat. [Add an agent](https://docs.catalex.co/agents/add-an-agent).
3. **Add a WhatsApp channel**: Open **Add channel** on the agent and choose **WhatsApp**. Enter your Meta app's WhatsApp Business credentials, or Meta's test number to try it first. [Connect WhatsApp](https://docs.catalex.co/channels/whatsapp).
4. **Choose who may message it**: Decide who the agent answers, then send it a message from your phone.

## Frequently asked questions

### How do I connect an AI agent to WhatsApp?

Install CatalEx on your Mac, add the folder your Claude Code or Codex agent works in, then add a WhatsApp channel with your Meta WhatsApp Business credentials. CatalEx Cloud carries the messages, so you need no server or webhook.

### Do I need the WhatsApp Business API?

For a business number, yes: you need a Meta developer app with the WhatsApp product, a business number or Meta's test number, and a system-user access token. For your own number, WhatsApp Personal links CatalEx as a device instead.

### Can I use my personal WhatsApp number?

Yes, with WhatsApp Personal, which is experimental. WhatsApp does not officially support automation on personal numbers and may restrict a number that uses it, so prefer a business number for customers.

### Can the agent send images and files on WhatsApp?

Yes. CatalEx sends supported files and turns charts into image previews. Approvals and questions appear as buttons on a business number.

### Can a WhatsApp agent message people first?

Yes, if you turn it on. By default an agent only replies; you can let it start messages such as reminders, with limits on those sends.

### What does it cost?

CatalEx is free to download. Meta's own WhatsApp Business pricing applies to business numbers, and your agent's model use is billed by your Claude or OpenAI plan.

## Get CatalEx

- Download for Mac (Apple silicon): https://downloads.catalex.co/latest/CatalEx-arm64.dmg
- Docs: https://docs.catalex.co/
