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.
How to connect your agent to WhatsApp
- Install CatalEx. Download CatalEx for Mac and sign in with Google.
- 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.
- 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.
- Choose who may message it. Decide who the agent answers, then send it a message from your phone.
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.
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.