# WA Smart Business MCP MCP

> WA Smart Business MCP manages your entire WhatsApp communication stack through natural conversation. You can programmatically send high-fidelity media and text, manage contact databases, coordinate support teams, and trigger bulk campaigns without leaving your AI client. It's full marketing automation for growing companies.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** whatsapp-business-api, automated-messaging, team-inbox, customer-service, media-messaging, business-communication

## Description

This connector lets you take manual effort out of managing customer communications entirely. Instead of jumping between tabs or manually copying IDs, your agent talks directly to your WhatsApp Business account. You can list contacts, find detailed profiles, and coordinate entire support teams through simple requests.

The system handles everything from listing template options to sending a promotional image via `send_media`. If you're building automations that cross multiple platforms—for example, triggering a message after a record is created in your CRM—you know the power of **Vinkius**. The platform ensures all credentials pass through a zero-trust proxy; your keys never sit on a disk. You just connect once from Claude, Cursor, or any MCP-compatible client and build complex workflows that span your entire tech stack.

## Tools

### check_wasmart_status
Verifies the current operational connection and status of the WhatsApp Business account.

### create_customer
Adds a new contact to your main customer database within WA Smart Business.

### get_agent
Retrieves detailed information about a specific support agent by name or ID.

### get_customer
Gets the full, current profile details for a single existing customer contact.

### list_agents
Lists all support agents currently registered in your organization's directory.

### list_campaigns
Retrieves a list of pre-designed marketing campaigns available for use.

### list_customers
Provides a full, paginated directory listing of all contacts in your system.

### list_messages
Fetches the history and details of recent communications exchanged with customers.

### list_templates
Shows available communication templates that can be used for outbound messages.

### search_customers
Searches the customer database using keywords or partial information to find specific contacts quickly.

### send_media
Sends images, PDFs, and other media files directly to a specified recipient's WhatsApp number.

### send_message
Transmits an arbitrary text message to a customer contact.

### send_template
Sends a pre-approved, structured template message that requires specific data fills.

## Prompt Examples

**Prompt:** 
```
List all active customers in my WA Smart Business account.
```

**Response:** 
```
I've retrieved your customer directory. You currently have 300 active profiles, including 'Sarah Manager' and 'Mike Client'. Would you like the detailed high-fidelity metadata for any of them?
```

**Prompt:** 
```
Send a WhatsApp image to '+15550123': 'https://example.com/promo.png'.
```

**Response:** 
```
WhatsApp orchestrated! I've successfully sent the high-fidelity promotional image to +15550123. The message is now active in your engagement history. Need help checking the delivery status?
```

**Prompt:** 
```
Check which support agents are currently assigned to 'Mike Client'.
```

**Response:** 
```
Agent architecture orchestrated! Mike Client is currently assigned to 'Agent_789' (John Doe). I've retrieved the high-fidelity assignment metadata and last interaction duration for your review. Shall I reassign this customer?
```

## Capabilities

### Programmatically send media
Send images, PDFs, videos, and standard text messages to specific contacts.

### Search and list customers
Retrieve detailed customer profiles by name or ID, giving you access to full metadata records.

### Manage support agents
View the complete roster of support personnel and get details on who is assigned to a particular client.

### Check account status
Verify that the API connection is active and monitoring messaging volume for scaling checks.

### List available campaigns
See all existing communication templates and marketing campaign types ready to be used.

## Use Cases

### Onboarding New Clients
A sales rep needs to send onboarding materials. They use `list_customers` first to verify the client exists, then they trigger a campaign using `send_template` that includes specific product links and contact details.

### Escalating Support Issues
The support team detects an issue with 'Client X'. They run `get_customer` to verify the account's full history, then use `list_agents` to see who is available and assign a specialist.

### Running Flash Sales
The marketing team needs to announce an urgent sale. They first run `list_campaigns` to select the correct campaign type, then use natural language commands to trigger mass sends via `send_media` across all active contacts.

### API Development
A developer is building an internal dashboard. They need reliable data flow and start by running `check_wasmart_status` to confirm connectivity before writing any code that relies on customer records or message history.

## Benefits

- Coordinate response teams instantly: Use `list_agents` and `get_agent` to see which personnel are assigned to a client, ensuring the right expert handles every query.
- Manage your database with precision: Instead of guessing who you need, use `search_customers` or `get_customer` to pull accurate, detailed metadata on any contact in seconds.
- Run complex campaigns safely: You can list available templates (`list_templates`) and then trigger sends using `send_template`, all while the Vinkius platform keeps a cryptographically signed audit trail of every action.
- Monitor activity without logs: Use `list_messages` to pull conversation history, or run `check_wasmart_status` to verify API connectivity, giving you full visibility into the system's health.
- Build comprehensive workflows: By chaining this messaging MCP with other services (like a CRM), your agent can manage everything from listing customers to sending media in one automated flow.

## How It Works

The bottom line is, you tell your AI client what needs to happen—like 'Send a promo image to John Doe'—and it executes the full process automatically.

1. Subscribe to this MCP in Vinkius.
2. Retrieve your specific API key from the WA Smart Business dashboard settings.
3. Connect the service using any AI agent compatible with the MCP standard.

## Frequently Asked Questions

**How do I send a structured message using `send_template`?**
You must first use `list_templates` to see what formats are available. Then, your agent will prompt you for the specific data fields (like product names or dates) needed to fill the template correctly.

**Can I find a customer's history using `list_messages`?**
Yes, running `list_messages` pulls the full record of past conversations. You can then use this data with your agent for deeper analysis or reporting.

**What if I need to update a customer's phone number? Should I use `create_customer`?**
The MCP focuses on communication, not core profile updates. For verification, you should run `get_customer`. If an update is required, consult your underlying platform documentation.

**How do I check if my API key is working before a big campaign?**
Use the `check_wasmart_status` tool. It verifies connectivity and monitoring volume, giving you confidence that high-volume messaging will work when you need it most.

**How do I find a specific contact's details? Should I use `search_customers` or `get_customer`?**
`search_customers` is for finding potential matches using keywords across the database. Use `get_customer` when you already know the precise ID and need all metadata for that single user.

**How do I use `send_media` to make sure my promotional image or PDF actually gets delivered?**
You pass the direct URL of the media file into the tool. The system validates the content type and ensures it's high-fidelity, which means images, PDFs, and videos get formatted correctly for WhatsApp delivery.

**If I need to see who is on my support team or check agent status, should I use `list_agents`?**
Yes, that's the right call. It pulls your entire directory of active agents and their current assignments. This lets you know exactly who can handle a query before automating an assignment.

**When running a large campaign with thousands of contacts, what should I expect if I hit rate limits while calling `list_customers`?**
The API handles throttling automatically. If you exceed the allowed volume, your agent will pause and return a specific error code. You just wait for the designated interval before resuming the data pull.

**How do I find my WA Smart Business API Key?**
Log in to your account, navigate to **Settings** > **API**, and copy your unique Access Token or API Key from the credentials section.

**Can I send PDFs or Images via AI?**
Yes! The `send_whatsapp_media` tool allows your agent to send high-fidelity files by providing the recipient's number and the media URL.

**How do I list my support agents?**
Use the `list_whatsapp_agents` tool to retrieve your complete high-fidelity directory along with the current assignments for all team members.