# 360dialog MCP

> 360dialog connects your WhatsApp Business API directly to any AI agent. It lets you manage everything from sending individual messages and uploading media to deploying pre-approved template campaigns at scale. Check contact status, set up webhooks for incoming replies, and track delivery readiness—all through natural conversation.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** whatsapp-api, business-messaging, customer-engagement, template-messages, conversational-ai

## Description

This MCP links your entire messaging infrastructure to your AI client, treating WhatsApp like just another tool in your workflow. You stop jumping between the 360dialog dashboard, your CRM, and your communication platform. Instead, you talk to your agent, and it handles the complexity of sending a message: whether it's a simple text chat, a rich media file, or a pre-approved marketing template.

It’s designed for high-volume communication operations. Need to launch a campaign? Your agent can list all approved templates and verify if your leads are actually on WhatsApp before you send anything. If you're using Vinkius, this MCP makes managing message delivery history and setting up incoming webhooks part of the same conversation with your AI client. This lets customer support teams handle replies instantly while marketing can safely run template campaigns without ever touching an API key.

## Tools

### check_contacts
Verifies if a provided phone number is registered and active on WhatsApp.

### check_360dialog_status
Checks the API connection status to ensure messaging services are working in real time.

### get_media
Retrieves specific details about a media file that has already been uploaded for use in messages.

### get_template
Fetches the detailed structure and components of a single, approved message template.

### list_templates
Lists all currently available and approved WhatsApp message templates in your account.

### send_media_message
Sends a complete message containing an image, video, or document to a contact.

### send_message
Sends a straightforward text-only WhatsApp message to a specified recipient number.

### send_template_message
Deploys a pre-written, approved template message to a contact using the correct language code.

### set_webhook
Configures your external URL so that incoming messages and delivery status updates are automatically logged and received.

### upload_media
Uploads media files to the WhatsApp cloud for subsequent use in sending multiple types of messages.

## Prompt Examples

**Prompt:** 
```
Send a WhatsApp message to +5511999999999 saying 'Your order has been shipped'.
```

**Response:** 
```
Done! I sent the message to +5511999999999 through your 360dialog account. The delivery was queued and the message ID is wa_msg_4821. Would you like to send a follow-up?
```

**Prompt:** 
```
List all my approved WhatsApp message templates.
```

**Response:** 
```
I found 7 approved templates in your account: 'order_confirmation' (en, pt), 'appointment_reminder' (en), 'welcome_message' (en, es, fr), and 4 more. Would you like to inspect the components of any specific template?
```

**Prompt:** 
```
Check if these numbers have WhatsApp: +5511988888888, +5511977777777.
```

**Response:** 
```
Verified! +5511988888888 is a valid WhatsApp account. +5511977777777 is not currently registered on the platform. Would you like me to send a message to the valid number?
```

## Capabilities

### Verify WhatsApp Contacts
Checks if a given phone number is active and registered on the WhatsApp platform before any message attempts.

### Send Text Messages
Sends standard, free-form text messages to specific international phone numbers.

### Run Template Campaigns
Deploys pre-approved marketing or transactional message templates in the correct language for large audiences.

### Manage Media Assets
Uploads images, videos, and documents to the WhatsApp cloud for later reuse across multiple messages.

### List Message Templates
Retrieves a list of all message templates that are currently approved in your 360dialog account.

### Configure Webhooks
Sets the callback URL so your agent receives real-time updates on incoming messages or delivery status changes.

## Use Cases

### Launching a new product update campaign
The marketing manager needs to notify 5,000 customers. Instead of writing individual messages or guessing template availability, they ask their agent: 'List all approved message templates.' The agent uses list_templates and then deploys the correct one for every recipient using send_template_message.

### Handling incoming support requests
A customer sends a complex query. Instead of relying on email, the AI client receives the message via set_webhook. The agent then uses send_message to reply immediately with instructions or links.

### Verifying lead quality before sales outreach
The sales team gets a list of 20 new leads. Before sending the first touch, they ask their agent to check_contacts for every number, instantly flagging any numbers that aren't WhatsApp ready.

## Benefits

- Start campaigns safely. Before sending out templates using send_template_message, your agent can run check_contacts to ensure every lead is actually registered on WhatsApp.
- Handle rich content easily. You don't have to upload media manually; use upload_media once, and then reference the asset ID when calling send_media_message for any recipient.
- Automate communication feedback loops. By using set_webhook, your agent receives real-time data on message delivery status—you know instantly if a message failed or was delivered.
- Maintain compliance with templates. The list_templates and get_template tools let you easily audit which marketing messages are approved and available before deployment.
- Streamline support responses. If an inquiry comes in, your agent can immediately use send_message to provide the reply, all without manual API steps.

## How It Works

The bottom line is you tell your AI client what needs communicating; this MCP handles the API calls and WhatsApp delivery details.

1. Subscribe to this MCP and provide your API Key from 360dialog's client hub.
2. Your AI client connects the credentials, giving it access to manage WhatsApp messaging tools.
3. You instruct your agent using natural language prompts—for example, 'Send a welcome message template to +12345...'—and the MCP executes the action.

## Frequently Asked Questions

**How do I know if the 360dialog MCP can send images?**
Yes, you can. First, use upload_media to put your files in the WhatsApp cloud. Then, call send_media_message, referencing the ID of that uploaded asset.

**What is required to set up webhooks with 360dialog?**
You must use the set_webhook tool and provide a valid callback URL. This tells the system where to send status updates for incoming messages or delivery failures.

**Can I check if a number is valid using the 360dialog MCP?**
Absolutely. Use the check_contacts tool with any phone number; it verifies whether that number is currently registered on WhatsApp before sending anything.

**How do I list all available message templates in this MCP?**
Run the list_templates tool. This gives you a full inventory of every template approved and ready to deploy for marketing or transactional use.

**Does 360dialog handle reply messages automatically?**
Yes, setting up set_webhook allows your agent to receive incoming messages in real time. The agent can then respond using send_message without manual intervention.