# WSLA (WhatsApp) MCP

> WSLA (WhatsApp) MCP connects your AI agent directly to the WhatsApp Business Platform using Meta Cloud API. Send instant text messages, trigger pre-approved business notifications, and even let your agent react to incoming customer media. Use this when you need reliable, scalable communication automation for support or marketing efforts.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** whatsapp-api, conversational-ai, business-messaging, customer-engagement, notifications

## Description

This connection lets your AI client handle customer conversations directly inside WhatsApp. You can send standard text replies during active support windows, but you also have access to pre-approved templates for things like appointment reminders or shipping alerts. If a user sends a picture, your agent doesn't just see it; it gets the technical details of that media so your workflow can understand what it is. Want your bot to feel more natural? You can even program reactions using emojis when a customer message comes in. Setting this up means you get reliable, scaled messaging powered by Meta’s infrastructure, accessible through Vinkius's MCP catalog and ready for any AI agent.

## Tools

### send_whatsapp_reaction
This sends an emoji reaction to any received WhatsApp message, acknowledging customer input instantly.

### get_whatsapp_media_details
It pulls structured data about incoming media, letting the agent know if a file is an image, video, or document.

### list_whatsapp_templates
The tool searches and retrieves all pre-approved message templates available for your WhatsApp business account.

### send_whatsapp_template
It sends a structured, predefined message using one of the approved message templates.

### send_whatsapp_text
This sends an immediate, freeform text message to a specific WhatsApp number.

## Prompt Examples

**Prompt:** 
```
Send a WhatsApp message 'Welcome to our service!' to +1234567890.
```

**Response:** 
```
Message sent successfully! I've triggered the welcome notification to the recipient via WhatsApp Cloud API.
```

**Prompt:** 
```
List all approved templates for my business account.
```

**Response:** 
```
I've retrieved your templates. You have 10 approved message templates, including 'shipping_update', 'appointment_reminder', and 'welcome_pack'.
```

## Capabilities

### Send text replies
The agent can send immediate, freeform text messages to a customer within the active support window.

### Send notification templates
It allows sending proactive, structured updates using message templates for things like order status or billing alerts.

### React to messages
Your agent can automatically send an emoji reaction to a customer's incoming message, making the conversation feel more human.

### List available templates
The system retrieves and lists all pre-approved message templates associated with your business account for review.

### Analyze media content
When a customer sends images or files, the agent gets structured details about the media type and contents.

## Use Cases

### Handling Post-Purchase Follow-up
A customer buys a product and needs tracking. Instead of waiting for manual emails, the agent triggers `send_whatsapp_template` with the package ID, proactively notifying the customer the moment the shipment leaves the warehouse.

### Triage Incoming Support Media
A user messages support and sends a screenshot of an error. Your agent uses `get_whatsapp_media_details` to confirm it's a PNG file, analyzes the content type, and then replies with troubleshooting steps using `send_whatsapp_text`.

### Automating Appointment Confirmation
A booking system needs confirmation. The agent calls `list_whatsapp_templates` to verify the correct template name, then executes `send_whatsapp_template` at the exact time needed, confirming the appointment details.

### Improving Chat Feel
A support bot is responding to a user's lengthy query. To make the exchange feel less transactional, the agent uses `send_whatsapp_reaction` immediately after receiving the message, showing it read and acknowledged the input.

## Benefits

- Send immediate replies: Your agent handles common customer queries using the `send_whatsapp_text` tool, keeping response time low during active support hours.
- Proactive alerts: Use `send_whatsapp_template` to send pre-approved updates for shipping or appointments, ensuring customers get critical information reliably without manual intervention.
- Natural engagement: By triggering a reaction with `send_whatsapp_reaction`, your agent's responses feel less robotic and more helpful when responding to customer messages.
- Smarter context: When the user sends media, `get_whatsapp_media_details` pulls the necessary data. Your workflow can then react intelligently based on whether it’s a photo or an invoice.
- Visibility into options: The `list_whatsapp_templates` tool lets you programmatically verify which official message types are available before trying to send them.

## How It Works

The bottom line is that you plug in your credentials once, and your AI client handles all the complex API calls for messaging on your behalf.

1. First, subscribe to this MCP and provide your Meta System User Access Token and WhatsApp Phone Number ID.
2. Next, connect this MCP to your preferred AI client (Claude, Cursor, etc.) within Vinkius's ecosystem.
3. Finally, prompt your agent to perform a communication action—for example, 'Send the shipping update template to user X.' — and the workflow executes the message.

## Frequently Asked Questions

**Can I use WSLA (WhatsApp) MCP for general chat support?**
Yes. You can send immediate responses using `send_whatsapp_text` when a customer is actively chatting with your service, which handles the conversational flow.

**How do I handle media files with WSLA (WhatsApp) MCP?**
You use the `get_whatsapp_media_details` tool. This allows your agent to get structured information about any image or file sent by a customer, letting it react intelligently.

**Is there a limit on how many templates I can send with WSLA (WhatsApp) MCP?**
The limits are managed by the WhatsApp Business Platform itself. You first use `list_whatsapp_templates` to see what you've pre-approved, and then your agent sends them via `send_whatsapp_template`.

**Does WSLA (WhatsApp) MCP work with multiple languages?**
The core messaging capabilities handle text in various supported languages. However, ensure the templates you manage through `list_whatsapp_templates` are fully translated and approved by Meta.

**What if I need to send an ad-hoc message outside of a conversation?**
You can use `send_whatsapp_template` for proactive, notification-style messages. For anything non-templated, you must wait until the user initiates contact first.