Need help? Message us on WhatsAppWhatsApp us+33 7 67 93 66 56Open chat
AI coding agents · Whatsable

Vibe Code WhatsApp Automation

Paste one prompt into your AI coding agent. It adds WhatsApp to your app with the Whatsable API v1, the way your code sends and receives WhatsApp messages, and asks you to save your key as a secret first.

Works with your agent

OpenClawCursorClaude CodeGitHub CopilotGemini CLIAmpRoo CodeJunieOpenHands
Quick start

Copy a prompt for your platform

Pick your platform tab, copy the prompt, then paste it into your AI agent. The prompt builds on the Whatsable API v1 and asks you to save your API key as a secret.

Default

Copy full prompt

Paste this into your AI agent chat to start setup.

Agent prompt
Add WhatsApp to this project with the Whatsable API v1.
First, ask me to save my Whatsable API key as the secret WHATSABLE_API_KEY: in my platform's secrets store, or in a local .env file that git ignores. Never hard-code the key, commit it to git, or send it to frontend code.
API reference: https://docs.whatsable.app/api-reference/v1
OpenAPI file: https://api.whatsable.app/v1/openapi.json
Base URL: https://api.whatsable.app/v1
Auth header: Authorization: Bearer <WHATSABLE_API_KEY>
Build rules:
- Call the API only from server-side code (an edge or backend function), never from the browser.
- Test the connection with GET /v1/me.
- Send messages with POST /v1/messages. Phone numbers are E.164 with a leading +.
- To message someone first, or more than 24 hours after their last message, send an approved template: {"to": "+15551234567", "type": "template", "template": {"name": "<template name>", "language": "<language code>", "variables": {}}}.
- Inside the 24-hour window you can send text: {"to": "+15551234567", "type": "text", "text": {"body": "Hi!"}}.
- A 201 means Whatsable recorded the message. Read "status" in the body: "sent" or "failed". Don't resend a failed message whose error is not retryable.
- Send an Idempotency-Key header with each send. Reuse it only to retry a send that got no answer; after a "failed" send with "retryable": true, retry later with a new key.
- To receive messages, add a backend function and point a Whatsable webhook at its URL (Settings → Webhooks → Add endpoint, turn on Incoming messages).
Confirm the secret is set, then build the send flow for my use case.
Prefer to work through your AI assistant instead of code? Connect the Whatsable MCP server: https://docs.whatsable.app/mcp/agent-skill
Requires the Whatsable console

Initial WhatsApp connection, billing, and Meta template approval cannot be done via Lovable. Complete those in the console first.

Whatsable API v1 reference

How it works

Work with an AI agent or write code

MCP is the open standard AI apps like Claude, ChatGPT and Cursor use to call tools. You ask in plain words, and the assistant does the work in Whatsable. Your code can use the Whatsable API v1 for the same jobs.

One agent skill

One Whatsable agent skill tells your AI agent how to connect the Whatsable MCP server. It holds no scripts: the server lists its own tools. For your own code, use the Whatsable API v1.

The Whatsable MCP server

Add Whatsable to your AI app. The app opens a Whatsable page where you sign in and choose what the app may do and which numbers it can use. You can revoke it at any time.

Pro and Agency plans

The Whatsable API and MCP server are on Pro and Agency, not Bulk Message.

Capabilities

What your agent can do

Your agent can work with the account and its numbers, messages, conversations and the AI in each one, templates, contacts and labels, scheduled messages, broadcasts and AI agents through the Whatsable MCP server.

Account and numbers

See which account this connection belongs to, what it may do, the WhatsApp numbers and the team. Read only.

Messages and conversations

Read conversations, send text messages inside the 24-hour window, and send templates for first messages or after 24 hours.

AI in conversations and agents

Work with the AI in each conversation and manage AI agents.

Templates, scheduled, broadcasts

Manage templates, scheduled messages and broadcasts.

Contacts and labels

Read and manage contacts and labels to organize your WhatsApp conversations.

Machine-readable

For AI agents reading this page

One Whatsable agent skill tells your AI agent how to connect the Whatsable MCP server. It holds no scripts: the server lists its own tools. For your own code, use the Whatsable API v1.

For AI agents
- Every Whatsable API route starts with https://api.whatsable.app/v1.
- Send your API key in the Authorization header: Authorization: Bearer <your Whatsable API key>.
- In Whatsable, open Settings → API keys and click Create API key. Copy the key.
- A key from the legacy Whatsable API doesn't work with API v1.
- The Whatsable API and MCP server are on Pro and Agency, not Bulk Message.
- Server URL: https://api.whatsable.app/mcp. Sign in with OAuth from your AI app, or send an API key as a Bearer header.
- The account and its numbers, messages, conversations and the AI in each one, templates, contacts and labels, scheduled messages, broadcasts and AI agents.

Common pitfalls

Pitfalls
- Free-text and media only work inside the 24-hour window; otherwise send an approved template.
- A key from the legacy Whatsable API doesn't work with API v1.
- Keep the key in a secrets store or a git-ignored .env file. Never hard-code it, commit it, or send it to frontend code.
- A 201 means Whatsable recorded the message. Read "status" in the body: "sent" or "failed".
- Send an Idempotency-Key header with each send. Reuse it only to retry a send that got no answer; after a "failed" send with "retryable": true, retry later with a new key.
- First-time WhatsApp connection (Meta embedded signup) is browser-only in the Whatsable console.

Ready to automate WhatsApp with your AI agent?

Connect the Whatsable MCP server or build on Whatsable API v1 and ship WhatsApp automation from your editor.

14-day Pro trial, no card needed · 6-minute setup · Cancel anytime

Start Free Trial
Chat