# Connect Claude to WhatsApp Business

Source: https://postgale.com/guides/claude/whatsapp

Yes, Claude can answer customers and send messages on WhatsApp Business through Postgale. Add https://postgale.com/mcp as a custom connector in claude.ai, Claude Desktop or the mobile app (or with one command in Claude Code) and sign in to Postgale, connect your WhatsApp Business account in Postgale once, and Claude can customer conversations, templates, media and the 24-hour window. A person can be required to approve every post, reply and message before it goes out.

## Can Claude answer customers and send messages on WhatsApp Business?

Postgale is the secure layer for AI agents on social media. MCP (Model Context Protocol) is the open standard that lets AI assistants such as Claude and Cursor use outside tools. An MCP server is what they connect to. Claude does not reach WhatsApp on its own; with Postgale connected it gets tools for the WhatsApp accounts you connected and nothing else.

| Task | What Postgale does |
| --- | --- |
| Read | List conversations (latest first, with unread count and the open messaging window) and their messages, including inbound attachments. |
| Reply | Text, image, video, audio, document, interactive messages and reactions inside the 24-hour window; mark as read. |
| Templates | Send approved templates with parameters outside the window; list templates and their status. |
| Media | Upload media to WhatsApp and read the type, size and hash of inbound media. |
| Events | message.received, message.status, message.delivered, message.read and message.reaction on your webhook, signed. |

## What do you need?

- A WhatsApp Business Account and a phone number for it, set up through Meta’s Embedded Signup from the Postgale dashboard, or an existing number connected with its token.
- A Postgale workspace, and a sign-in or an API key for the agent.
- Message templates approved by Meta if the agent must write first or outside the 24-hour window.
- Claude, set up as below (claude.ai, Claude Desktop, Claude mobile and Claude Code).

## Step 1: connect your WhatsApp Business account

1. Create a Postgale workspace and open Dashboard → Accounts.
2. Choose Connect WhatsApp Business and sign in with the account you own, on Meta’s own Embedded Signup page. Postgale stores the tokens encrypted and refreshes them.

## Step 2: connect Claude to Postgale

1. Create a Postgale workspace and connect the social accounts the agent may use under Dashboard → Accounts.
2. In Claude, open Settings → Connectors → Add custom connector, and paste the server URL:

Connector URL:
```text
https://postgale.com/mcp
```

1. Choose Connect. A Postgale page opens in the browser: sign in, pick the workspace the app may use and approve. The consent page names the app and where it returns to; approve only requests you started yourself.
2. Back in Claude, enable the Postgale tools in a new chat and ask: “Which social accounts are connected in Postgale?” Claude calls `list_accounts` and answers with the accounts and their status.

## How do I set up Claude Code?

1. Create a Postgale workspace and connect the social accounts the agent may use under Dashboard → Accounts.
2. In a terminal, add the server:

Terminal:
```bash
claude mcp add --transport http postgale https://postgale.com/mcp
```

1. Run `/mcp` inside Claude Code, select postgale and choose Authenticate. A Postgale page opens in the browser: sign in, pick the workspace the app may use and approve. The consent page names the app and where it returns to; approve only requests you started yourself.
2. Ask: “Which social accounts are connected in Postgale?” to check the connection.

To use an API key instead (for example on a server without a browser), create one under Dashboard → API keys and add the header:

Terminal (API key):
```bash
claude mcp add --transport http postgale https://postgale.com/mcp \
  --header "Authorization: Bearer sk_…"
```

## What can I ask Claude to do on WhatsApp?

Check the connection first: “Which WhatsApp accounts are connected in Postgale?” Then, in plain language:

> Ask your agent: “Answer the new WhatsApp questions about opening hours. Hold every reply for my approval.”

> Ask your agent: “Send the “order ready” template to the customer in this conversation.”

> Ask your agent: “Summarise today’s WhatsApp conversations and list the ones still waiting for an answer.”

POST /api/v1/whatsapp/accounts/{accountId}/messages:
```json
{
  "to": "+14155550132",
  "type": "text",
  "text": "Yes, M restocks Tuesday. Want me to hold one?"
}
```

## Which WhatsApp rules does Postgale enforce?

- Free-form replies are allowed for 24 hours after the customer’s last message. Outside that window only approved templates can be sent; Postgale refuses anything else and explains why.
- WhatsApp has no human-agent extension of the window (Instagram and Messenger do); Postgale does not pretend otherwise.
- A number must be registered before it can send; a test number can only message its allowed recipients. Postgale returns the specific error code for each case.
- The business token from Embedded Signup is stored encrypted and never shown to the agent.

## How do I keep a person in the loop?

- Approval: tick “Hold posts from this app for approval” when you sign in, or in the Postgale dashboard require approval for the API key the agent uses (or for the whole workspace, or one account). Posts then wait as pending approval; comment replies and moderation, direct messages, WhatsApp sends and edits to live posts wait in the same queue. A person approves, edits or rejects each one in Dashboard → Approvals; the agent’s own key or sign-in cannot approve.
- Tool annotations: every Postgale tool declares whether it only reads, writes, or publishes live, deletes or spends. Clients that honour annotations ask before destructive tools run.
- Audit log: every write the agent makes is recorded with the key or the connected app, the action and the time.
- Revoking: each sign-in appears under Dashboard → Connected apps and each key under Dashboard → API keys; either can be revoked at any time.

## What can’t an agent do on WhatsApp through Postgale?

- Send free-form messages outside the 24-hour window. Meta requires an approved template.
- Avoid Meta’s per-conversation charges. Meta bills the WhatsApp Business Account directly for template messages.
- Post to a feed. WhatsApp is messaging only.

## Questions

### Can Claude answer customers and send messages on WhatsApp Business?

Yes, Claude can answer customers and send messages on WhatsApp Business through Postgale. Add https://postgale.com/mcp as a custom connector in claude.ai, Claude Desktop or the mobile app (or with one command in Claude Code) and sign in to Postgale, connect your WhatsApp Business account in Postgale once, and Claude can customer conversations, templates, media and the 24-hour window. A person can be required to approve every post, reply and message before it goes out.

### Does Claude see my WhatsApp password or tokens?

No. The account owner signs in on the platform’s own page once, and Postgale stores the resulting tokens encrypted. Claude only holds a Postgale sign-in, which you can revoke at any time.

### Can I approve what Claude sends to WhatsApp before it goes live?

Yes. Turn on approval for the connected app (or tick “Hold posts from this app for approval” when you sign in), the account or the whole workspace. Posts, replies and messages then wait in the Postgale dashboard until a person approves, edits or rejects them; Claude’s own access cannot approve.

## Related

- [Claude guide](https://postgale.com/guides/claude)
- [WhatsApp Business for AI agents](https://postgale.com/integrations/whatsapp)
- [Claude and Instagram](https://postgale.com/guides/claude/instagram)
- [Claude and Facebook](https://postgale.com/guides/claude/facebook)
