# Gupshup Messaging MCP > Gupshup Messaging MCP connects your AI agent directly to WhatsApp Business APIs. You can automate customer communications by sending free-form text, pre-approved template messages, and rich media assets like images or documents. It also lets you send interactive buttons and react to incoming messages with emojis, all without leaving your chat client. ## Overview - **Category:** talk-to-me - **Price:** Free - **Tags:** whatsapp-api, conversational-messaging, template-messages, interactive-buttons, omnichannel ## Description Your AI agent manages complex communication workflows on WhatsApp. Instead of manually drafting multiple message types—like a quick text follow-up, an order status update using a template, or attaching troubleshooting documentation—you just tell your agent what needs to happen. It handles the nuances: sending a basic free-form text when needed, but automatically switching to a structured template for formal notifications. You can also enrich the conversation by including interactive buttons, asking users questions directly inside WhatsApp. Because this MCP connects messaging actions with data retrieval and generation capabilities through the Vinkius catalog, your agent doesn't just talk; it executes full business processes on the platform you actually use. ## Tools ### get_template_info Retrieves details about a specific WhatsApp template before you send it. ### send_template_message Sends an official WhatsApp template, filling in necessary parameters like order numbers or names. ### send_text_message Writes a simple, conversational text message within the 24-hour chat window. ### send_interactive_message Sends a message that includes up to three clickable buttons for the user's response. ### send_media_message Sends content such as an image, video, document, or audio file using a public link. ### send_reaction Adds a single emoji reaction to a specific message in the chat history. ## Prompt Examples **Prompt:** ``` Send a template 'order_confirmation' in en_US to 5511999999999 with params ['12345']. ``` **Response:** ``` Template message sent successfully! Status: 200 OK. ``` **Prompt:** ``` Send an interactive message to 5511999999999 asking 'Did you receive your order?' with buttons 'Yes' and 'No'. ``` **Response:** ``` Interactive message sent successfully! Status: 200 OK. ``` **Prompt:** ``` React with a thumbs up emoji to message ID msg_123 for user 5511999999999. ``` **Response:** ``` Reaction sent successfully! Status: 200 OK. ``` ## Capabilities ### Send structured templates The agent sends official WhatsApp template messages for automated alerts and notifications. ### Handle live text conversation Your AI client writes quick, free-form text responses within the standard 24-hour chat window. ### Share various media types The agent sends images, videos, audio files, or documents using public URLs. ### Create interactive user choices You send message buttons with up to three predefined options to guide the user's next move. ### Acknowledge messages visually The agent reacts to specific incoming messages by adding an emoji reaction, keeping the conversation lively and acknowledged. ## Use Cases ### Handling post-purchase follow-up A marketing lead needs to check in on users who haven't opened their welcome email. They ask the agent to send an 'Order Confirmation' template using `send_template_message` to a list of emails, ensuring every message has the right order ID and name filled in automatically. ### Live support issue triage A customer is sending photos of damage. The support agent uses `send_media_message` to immediately share a link to the 'Damage Reporting Guide' PDF, while simultaneously using `send_reaction` to acknowledge the photo they just sent. ### Gathering quick user feedback A team wants to know if users received their service update. They ask the agent to send an interactive message using `send_interactive_message`, presenting choices like 'Yes, I got it' or 'No, need help,' and analyzing the responses. ### Automating appointment reminders The scheduling team uses a natural language prompt to trigger an automated WhatsApp message. The agent calls `send_template_message` with the user's name and date, confirming their upcoming appointment without human intervention. ## Benefits - Stop relying on basic text messages. Use the `send_template_message` tool to send formal, structured alerts for things like shipping confirmation or password resets. The user gets a professional look every time. - Keep conversations natural by using `send_text_message`. When you're in that 24-hour window with a customer, your agent sends quick replies that feel like a person wrote them, not a bot. - Improve engagement immediately by utilizing the `send_interactive_message` tool. Instead of just asking 'Yes/No,' you can give users clickable buttons right inside WhatsApp, making actions simple. - Handle support requests efficiently. You can use `send_media_message` to instantly share troubleshooting guides or product manuals with a single command. No more linking out to an external site. - Maintain momentum in conversations by using the `send_reaction` tool. It lets your agent acknowledge a customer's message—even if it’s just a photo—with a simple thumbs up emoji. ## How It Works The bottom line is that once connected, you treat WhatsApp communication like any other API call—you just talk to your AI client. 1. Subscribe to this MCP and provide your unique Gupshup API Key. 2. Connect your preferred AI client (like Cursor or Claude) to Vinkius using the credentials. 3. Instruct your agent in natural language: 'Send an order confirmation template for user X' or 'Reply with a photo of the document'. ## Frequently Asked Questions **How do I use Gupshup Messaging MCP for order confirmations?** You use `send_template_message` by providing the template name, recipient number, and filling in parameters like the order ID and confirmation date. This ensures a consistent, branded message every time. **Can I send images with Gupshup Messaging MCP?** Yes, you use `send_media_message`. You just need to provide a public URL pointing directly to the image, video, or document file for your agent to include it. **Does Gupshup Messaging MCP support interactive polls?** It does. Use `send_interactive_message` to send a prompt that includes up to three clickable buttons, allowing users to make immediate choices directly within the WhatsApp chat. **What is the difference between `send_text_message` and `send_template_message`?** `send_text_message` writes quick, natural conversation replies in the 24-hour window. `send_template_message`, however, sends pre-approved, highly structured alerts for formal business use. **How do I make my agent acknowledge a user's message?** You call the `send_reaction` tool and specify which message ID and what emoji you want to react with. This gives immediate, visible acknowledgment in the chat thread. **How do I get my Gupshup API Key?** Log in to your Gupshup Console, navigate to Apps > Your App > Settings, and copy your API Key. **Can I send free text messages?** Yes, but only within the 24-hour session window after the user messages you first. **Do I need to pre-approve templates?** Yes, template messages must be approved by Meta before they can be sent via the send_template_message tool.