# WhatsApp Business MCP

> WhatsApp Business lets your AI agent send text, images, documents, and interactive messages through the world's most popular chat platform. Connect your customer service workflows directly to WhatsApp to handle conversations automatically.

## Overview
- **Category:** talk-to-me
- **Price:** Free
- **Tags:** business-messaging, customer-engagement, template-messages, rich-media, conversational-ai

## Description

Your agent connects to this MCP and starts managing your entire customer conversation history on WhatsApp. It treats incoming messages like any other interaction, allowing it to reply instantly using free-form text or initiating contact outside of the 24-hour window with Meta-approved templates. You can go beyond simple texting by distributing rich media—think images, video clips, and PDFs—with captions right from your agent. Need the user to make a choice? Send quick-reply buttons that guide them through complex processes. The whole setup is managed via Vinkius, letting you connect this powerful communication layer once, regardless of whether your team uses Cursor, Claude, or any other compatible client. This means your AI doesn't just send messages; it becomes the full operational chat engine for your business.

## Tools

### get_business_profile
Retrieves public information about the connected WhatsApp Business Profile.

### mark_as_read
Changes the status of a specific message by providing its unique ID, marking it as read.

### send_media_message
Transfers any file type—image, video, document, or audio—using its absolute public URL.

### send_quick_reply_buttons
Sends a message block that presents up to three actionable buttons for the user to select from.

### send_contact_card
Sends contact information to a user formatted as a structured card.

### send_location_pin
Sends an interactive map pin showing a physical location based on provided coordinates and recipient number.

### send_emoji_reaction
Responds to a user's specific message by adding a standard emoji reaction.

### send_template_message
Sends an approved, structured message that can initiate or resume a conversation with the recipient.

### send_text_message
Transmits a free-form conversational text reply to a user on WhatsApp.

## Prompt Examples

**Prompt:** 
```
Send a WhatsApp message to +123456789 saying 'Hi, your appointment is confirmed for 3 PM!'.
```

**Response:** 
```
I've sent the message to +123456789 via WhatsApp. The message ID is 'wamid.HBgMMTIzNDU2Nzg5...' and it has been successfully queued for delivery.
```

**Prompt:** 
```
Send the 'welcome_offer' template to +123456789 in en_US.
```

**Response:** 
```
Success! I've initiated contact with +123456789 using the 'welcome_offer' template in English (US). The conversation has been resumed.
```

**Prompt:** 
```
Send a quick reply message to +123456789: 'How would you like to proceed?' with buttons 'Yes', 'No', 'Maybe'.
```

**Response:** 
```
I've dispatched the interactive message block to +123456789. The user will see 'How would you like to proceed?' followed by your 3 custom buttons.
```

## Capabilities

### Send standard text messages
Your agent sends natural conversation replies to a user on WhatsApp.

### Distribute rich media files
You can send images, videos, documents, and audio using publicly accessible URLs.

### Initiate conversations via templates
The agent sends Meta-approved messages to start or resume chat threads when the 24-hour window has closed.

### Guide users with quick buttons
You send interactive message blocks that present up to three custom reply options, directing the user's next action.

### Share physical locations
The agent sends a map pin containing specific coordinates and names for addresses or meeting spots.

### Acknowledge messages with emojis
You can react to a user's message by sending a standard emoji response.

## Use Cases

### The Sales Follow-Up
A sales rep needs to follow up with a lead who downloaded a spec sheet last week. The agent uses `send_template_message` to reopen the chat, and then immediately uses `send_media_message` to send the latest product video, ensuring all context is retained in WhatsApp.

### Support Troubleshooting
A customer reports an issue. The agent first checks the business profile using `get_business_profile`, then uses text messages to gather details, and finally sends a map pin via `send_location_pin` if the problem is site-related.

### Marketing Alert System
A marketing team needs to send an alert about new store hours. Instead of sending plain text, they use `send_quick_reply_buttons` to present options like 'View Directions' or 'Call Now', improving click-through rates.

### Order Confirmation
After an order is placed, the agent sends a formal confirmation card using `send_contact_card`, ensuring all necessary account details are presented clearly and professionally right in the chat window.

## Benefits

- Move beyond basic chat replies. With this MCP, your agent can send documents or videos using `send_media_message`, turning a simple text exchange into a rich, multi-format knowledge transfer.
- Stop guessing what the customer needs next. Use quick-reply buttons via `send_quick_reply_buttons` to guide users through complex account changes or purchase options in just one tap.
- Manage conversations that fall outside standard hours. You can initiate contact anytime using templates via `send_template_message`, keeping your sales pipeline moving 24/7.
- Improve agent efficiency by centralizing actions. Your agent doesn't have to switch tools; it uses the API to pinpoint locations or share a professional contact card with single commands.
- Maintain conversation history and context. You can react to user messages using `send_emoji_reaction`, confirming receipt or acknowledging status without writing a new line of text.

## How It Works

The bottom line is that you get immediate, API-driven control over all outbound and inbound WhatsApp communications through natural language prompts.

1. Subscribe to this MCP and provide your WhatsApp Access Token along with the Phone Number ID.
2. Your AI client uses these credentials to connect, allowing it to read incoming messages and identify conversational context.
3. You prompt your agent via any compatible client to perform an action, such as sending a text message or distributing media.

## Frequently Asked Questions

**How do I get started sending text messages using WhatsApp Business?**
You start by connecting your API credentials to this MCP. Then, you simply prompt your agent to send a message; the client handles formatting and delivery via `send_text_message`.

**Can I send documents or videos using send_media_message?**
Yes, `send_media_message` is designed for this. You just need to provide the recipient number, the media type (image, video, etc.), and a publicly accessible URL for the file.

**Does send_template_message work if I haven't talked to the user in months?**
Absolutely. This tool is specifically built for that purpose. It allows you to use Meta-approved templates to re-establish contact and resume a conversation outside of the 24-hour window.

**What is the difference between sending text and using quick reply buttons?**
Text messages are free-form conversations. Quick reply buttons, handled by `send_quick_reply_buttons`, guide the user's next action by presenting a limited set of choices (up to 3) for immediate selection.

**If I need to confirm an address, what tool should I use?**
Use `send_location_pin`. This sends a dedicated map pin that shows the physical location and coordinates, which is much clearer than just sending text directions.

**Can I send a message to a customer who hasn't messaged me in the last 24 hours?**
Yes, but you must use the `send_template_message` tool. WhatsApp requires Meta-approved templates to initiate contact outside the 24-hour service window. For active conversations within that window, you can use the `send_text_message` tool for free-form replies.

**How many quick-reply buttons can I send at once?**
Using the `send_quick_reply_buttons` tool, you can send up to 3 interactive buttons along with a message block. This is ideal for helping users choose between options like 'Confirm', 'Cancel', or 'Reschedule' with a single tap.

**Can I share images or PDF documents through this server?**
Absolutely. Use the `send_media_message` tool and provide a public URL to your asset. You can specify the type as 'image' or 'document' and even add a custom caption to the message.