# Connect WhatsApp Business to your AI agent

> Yes — ClawLink is a hosted WhatsApp Business MCP server. 17 tools your agent can call from chat, with one-click hosted OAuth and nothing to run locally.

Web version: https://claw-link.dev/hub/whatsapp

ClawLink hosts a managed WhatsApp Business MCP server that exposes 17 tools to your AI agent. You connect WhatsApp Business in one click, and your agent can read, create, and update WhatsApp Business data from chat without you building or running a local MCP server.

## Quick facts

- 17 tools callable from chat
- One-click hosted OAuth
- Works with OpenClaw, Hermes, Claude Code, Cursor, Codex, and any MCP client
- No local server or config files

## Overview

The usual path is: build auth, handle token refresh, wire up the tools. With ClawLink you connect WhatsApp Business once and start using the real actions from the agent.

## Setup

WhatsApp Business uses OAuth. You connect it in the browser: click Connect, sign in, approve. ClawLink stores the token and refreshes it on its own. You never touch a key or wire up a redirect URL.

Authentication: hosted OAuth

## What you can do

- **Triage from chat** — Ask in plain English. The agent pulls up the right WhatsApp Business thread, channel, or inbox so you stay in one window.
- **Draft, then send** — The agent writes a message in WhatsApp Business, shows you the draft, and sends once you say go.
- **Context in one place** — Message history, who's involved, and recent activity from WhatsApp Business sit next to the work you're doing.

## WhatsApp Business tools

17 WhatsApp Business tools, ready the moment you connect.

- `whatsapp_create_message_template` — Create a new message template for the WhatsApp Business Account. Templates must be approved by WhatsApp before they can be used. Templates are required for marketing messages and messages sent outside the 24-hour window.
- `whatsapp_get_business_profile` — Get the business profile information for a WhatsApp Business phone number. This includes business details like description, address, website, and contact info.
- `whatsapp_get_media_info` — Get metadata and download URL for uploaded WhatsApp media. Returns media ID, download URL (valid for 5 minutes), MIME type, SHA256 hash, and file size. The download URL can be used to retrieve the actual media file.
- `whatsapp_get_message_templates` — Get all message templates for the WhatsApp Business Account. Templates are required for sending messages outside the 24-hour window and for marketing/utility messages.
- `whatsapp_get_phone_number` — Retrieve detailed information about a specific WhatsApp Business phone number. Returns phone number details including verification status, quality rating, display number, verified business name, throughput limits, and webhook configuration. Use this to check phone number status, settings, and capabilities. To get available phone number IDs, first call WHATSAPP_GET_PHONE_NUMBERS.
- `whatsapp_get_phone_numbers` — Retrieve all phone numbers registered to your WhatsApp Business Account. Returns phone number IDs, display numbers, verification status, quality ratings, and messaging throughput limits. Use the phone number ID from the response to send WhatsApp messages via other API actions.
- `whatsapp_get_template_status` — Get the status and details of a specific message template. This is useful for checking if a template has been approved, rejected, or is still pending review.
- `whatsapp_send_contacts` — Send contacts WhatsApp number. Note: The message will be delivered to the recipient only if they have initiated a conversation first.
- `whatsapp_send_interactive_buttons` — Send an interactive button message with up to 3 reply buttons to a WhatsApp user. Interactive button messages allow recipients to quickly respond by tapping predefined buttons. Perfect for yes/no questions, multiple choice selections, quick actions, or call-to-action scenarios. IMPORTANT REQUIREMENTS: - The recipient must be a registered WhatsApp user - The recipient must have messaged your business first within the last 24 hours (WhatsApp's customer service window) - You can include 1-3 buttons per message - Each button can have a title (max 20 chars) and unique ID (max 256 chars) Use cases: Customer service menus, appointment confirmations, feedback collection, product selections.
- `whatsapp_send_interactive_list` — Send an interactive list message to a WhatsApp number. List messages display a menu of options organized into sections. Users tap a button to view the list and select one option. Perfect for product catalogs, service menus, or guided workflows. Supports up to 10 sections with up to 10 items per section (100 total options). Note: Recipients must have messaged you first within the last 24 hours to receive this message.
- `whatsapp_send_location` — Send a location message with coordinates, name, and address to a WhatsApp user. This action allows you to share location information through WhatsApp Business API. The location message includes latitude/longitude coordinates, a location name, and address. Important: The recipient must have an active WhatsApp account. Additionally, you can only send free-form messages (like location messages) within the 24-hour customer service window after the recipient has initiated contact with your business. Outside this window, you must use approved message templates. Common error codes: - 133010: Recipient's phone number doesn't have a WhatsApp account - 131026: Message undeliverable (recipient may have blocked your business number) - 131047: Re-engagement message (outside 24-hour window, need to use template)
- `whatsapp_send_media` — Send a media message to a WhatsApp number
- `whatsapp_send_media_by_id` — Send media using a media ID from previously uploaded media
- `whatsapp_send_message` — Send a text message to a WhatsApp user
- `whatsapp_send_template_message` — Send a template message to a WhatsApp number
- `whatsapp_upload_media` — Upload media files (images, videos, audio, documents, stickers) to WhatsApp servers

## Example prompts

- **Create message template:** Create it in WhatsApp Business. Confirm the key fields with me before you finish.
- **Get business profile:** Pull the data from WhatsApp Business. Sum it up and flag anything I need to look at.
- **Get media info:** Pull the data from WhatsApp Business. Sum it up and flag anything I need to look at.
- **Get message templates:** Pull the data from WhatsApp Business. Sum it up and flag anything I need to look at.

## ClawLink vs. building it yourself

| | Manual | ClawLink |
|---|---|---|
| Connection | Build it yourself. You register a developer app with WhatsApp Business, set up redirect URLs, handle the consent screen, store and refresh access tokens, and redo the wiring when scopes change. | Hosted hosted OAuth. Connect once in the browser. ClawLink owns the lifecycle. |
| Maintenance | Token refresh, permission debugging, env config, every edge case. All yours. | ClawLink handles the plumbing. You focus on the workflow. |
| Time to first call | Days to weeks. Auth, storage, tool wiring, testing. Then the agent can act. | About two minutes from sign-up to the agent calling WhatsApp Business. |

## FAQ

### How do I connect WhatsApp Business to my AI agent?

Install ClawLink, open the dashboard, click Connect next to WhatsApp Business, and finish the hosted OAuth flow. Your agent can call WhatsApp Business from the next message. Two minutes, total.

### Is there a WhatsApp Business MCP server I can use?

Yes. ClawLink exposes WhatsApp Business as 17 tools your agent calls through a hosted MCP-compatible runtime. You don't run a local server or edit a config file. The tools are there the moment you connect.

### Do I need WhatsApp Business API credentials?

No separate API key. You sign in to WhatsApp Business through the normal OAuth flow and ClawLink handles the token after that.

### How much does it cost?

Your first integration is free, plus a 7-day trial of the full catalog. Paid plans unlock the rest of the library.

### Can I set this up from the terminal instead of the dashboard?

Yes. Run npx -y @useclawlink/cli login, then npx -y @useclawlink/cli connect whatsapp. The first opens a browser to sign in to ClawLink. The second opens a browser to authorize WhatsApp Business. No API keys to create. Works with OpenClaw, Hermes, Claude Code, Cursor, Codex, and any agent that runs shell commands.
