# WA Smart Business MCP MCP

> WA Smart Business provides automation for WhatsApp marketing and customer engagement. Use this MCP to manage contacts, list active groups, send messages via templates, and track support agents directly from your AI client.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** whatsapp-automation, bulk-messaging, customer-engagement, contact-management, chat-automation, messaging-api

## Description

Need to run your entire customer communication loop through WhatsApp? This connector lets you handle everything from initial contact setup to bulk messaging campaigns using natural conversation. Forget manually checking dashboards or copy-pasting phone numbers; your agent manages the whole process for you.

You can list all existing contacts, check group memberships, and pull up pre-approved message templates before sending out messages. Need to scale beyond simple chat? Because this MCP lets you link WhatsApp operations with other systems—like a CRM or billing tool—you'll find its value multiplies. This is where Vinkius shines; the ability to chain together multiple different service types into one automated workflow means your AI agent can build complete, multi-step campaigns that span platforms and execute them all through one single connection.

## Tools

### create_contact
Adds a brand new contact record into the WA Smart Business system.

### get_contact
Pulls specific details for one existing customer contact.

### list_agents
Lists all support agents currently configured in the platform.

### list_contacts
Retrieves a complete list of contacts managed by WA Smart Business.

### list_groups
Lists all active WhatsApp groups monitored by the system.

### list_templates
Checks for and lists all message templates that are pre-approved for use.

### send_message
Sends a direct WhatsApp text message or template to a specified recipient.

## Prompt Examples

**Prompt:** 
```
Add a new lead named 'Carlos Oliveira' with phone '+5511987654321' to our WA Smart Business contacts, and send him a welcome message saying our team will contact him shortly.
```

**Response:** 
```
I have created the contact for 'Carlos Oliveira' successfully. I also sent the welcome message to '+5511987654321'. The delivery status confirms the message was dispatched.
```

**Prompt:** 
```
Retrieve all pre-approved WhatsApp message templates we can use for the upcoming holiday promotion.
```

**Response:** 
```
I found 4 approved templates in your account, including 'holiday_sale_announce', 'black_friday_vip', 'abandoned_cart_reminder', and 'shipping_update'. Would you like to use one of these to broadcast to a specific group?
```

**Prompt:** 
```
List all active WhatsApp support groups we currently manage through the platform.
```

**Response:** 
```
You are currently managing 3 WhatsApp groups: 'VIP Support Channel', 'Beta Testers Community', and 'LatAm Partners'. Would you like me to fetch the contact list for any of these?
```

## Capabilities

### Find user data
Retrieves specific customer details or lists every contact managed in the system.

### Manage groups
Lists active WhatsApp support groups and identifies configured support agents within your organization.

### Prepare messages
Queries all available message templates that have been pre-approved by WA Smart Business.

### Create records
Adds a brand new customer or lead contact to the WhatsApp database.

### Send outbound messages
Sends text message notifications or pre-set templates to specific recipients, and confirms delivery status.

## Use Cases

### Onboarding a New Client
A sales rep gets a new lead's phone number. They ask their agent to first run `create_contact` with the details, and then immediately use `send_message` to send a personalized 'Welcome aboard!' message.

### Running a Campaign Update
The marketing team needs to notify all members of a specific group. They ask their agent to run `list_groups` first, select the target group, check available templates with `list_templates`, and then use `send_message` for bulk delivery.

### Auditing Support Channels
The support lead wants to know their current operational footprint. They ask the agent to run `list_groups` and also check who is available by calling `list_agents`. This confirms all channels are covered.

### Retrieving Specific User Info
A support team member needs details on a tricky customer. Instead of searching the CRM, they ask their agent to use `get_contact` with the user's ID and get immediate profile metadata.

## Benefits

- Never manually update contact records again. Use `create_contact` to add new leads immediately when they are identified by your agent.
- Instantly see what you're working with: run `list_contacts` or `list_groups` to pull a comprehensive snapshot of everyone and every channel without leaving your workflow.
- Outreach is standardized. Use `list_templates` first, then execute `send_message`, guaranteeing that every message follows approved compliance guidelines.
- Track support coverage easily. The `list_agents` tool helps you see who's covering which groups before a major service announcement.
- Manage communication flow end-to-end. By connecting this MCP with other tools, your agent can build complex workflows—like listing contacts and then sending messages in one shot.

## How It Works

The bottom line is that your AI client handles the complex API calls, so you just talk to it like normal.

1. First, subscribe to this MCP on Vinkius and input your WA Smart Business API Key from your dashboard.
2. Next, tell your agent what you need. For example, 'Find all contacts in the 'VIP Support Channel' group.'
3. Your agent executes the necessary calls—like listing groups or retrieving contact details—and gives you a clean summary of the results.

## Frequently Asked Questions

**How do I know if a contact exists before sending a message with send_message?**
You should run `get_contact` first. This confirms the individual's profile details are current and active in the system, preventing failed sends and giving you confidence in your outreach.

**Can I see all my WhatsApp groups using list_groups?**
Yes, `list_groups` pulls a complete list of every active support channel monitored by WA Smart Business. This is useful for auditing coverage and planning announcements.

**What's the best way to add new leads using create_contact?**
Simply provide the lead's full name, phone number, and any initial notes when asking your agent to run `create_contact`. The system handles adding them to the main contact list.

**Does list_templates show me all possible messages?**
No, `list_templates` only shows you templates that have been officially pre-approved by WA Smart Business. This guarantees compliance for any message sent later via `send_message`.

**How do I use `get_contact` to retrieve a specific customer's full metadata and profile details?**
The `get_contact` tool pulls deep, detailed information for one contact. You can pull more than just the name and number; you get rich metadata that helps your agent understand their complete history with the business.

**What does running `list_agents` show me about my support team structure?**
`list_agents` pulls a roster of every configured support agent. This lets you map out who is on your team, which is crucial when designing automated workflows that need to route messages correctly.

**Does `send_message` enforce rate limits if I try sending bulk messages?**
Yes, the system enforces standard WhatsApp business messaging rules. If you attempt a high volume of messages too quickly, your agent will receive an error detailing the limit and when you can send again.

**How do I use `list_contacts` to ensure I pull every contact from my entire database?**
`list_contacts` provides a paginated list of all your stored contacts. If you need thousands, remember that the tool works in batches, so your agent can call it repeatedly until no more pages are returned.

**Can I list all my WhatsApp contacts using my AI agent?**
Yes! Use the `list_contacts` tool. It will return a comprehensive list of all customers and contacts registered in your portal.

**How do I send a WhatsApp message through this integration?**
Simply use the `send_message` action by providing the recipient's phone number and your message body or template data.