# Gupshup Messaging MCP for AI Agents AI Agent Connect > Gupshup Messaging lets you connect your AI agent to WhatsApp Business. It handles sending pre-approved templates, free-form text, media like images and videos, and interactive buttons. You can also send reactions to specific messages. It is built for teams who need to automate customer outreach and notifications without leaving their primary workspace. ## Overview - **Category:** talk-to-me - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_zWJUY2HD7eK0izOG5QNTYOdA1x7SNxZUeNTNvfPq/ai-agent-connect - **Tags:** whatsapp-api, conversational-messaging, template-messages, interactive-buttons, omnichannel ## Description Imagine you're managing a high-volume customer support desk or a marketing campaign. Right now, you're probably jumping between your chat app and a separate dashboard to send out updates, share product photos, or acknowledge customer messages. It's a lot of context switching. With this Connector, your AI agent takes over that heavy lifting. You can tell it to send a specific order confirmation or a follow-up text directly from your workspace. It handles the technical side of the Gupshup API so you don't have to worry about messaging protocols. You can even have your agent send out rich media like PDFs or videos to help customers understand a product better. It's about making your communication feel like a natural part of your conversation. You'll find this Connector in the Vinkius catalog, where it sits alongside other tools to give your agent a complete set of capabilities. Instead of copy-pasting links or manually triggering notifications, you just describe the action you want to take. The agent handles the rest, ensuring your customers get timely, accurate info on WhatsApp without you having to juggle multiple tabs. ## Tools ### get_template_info Look up the details of a specific WhatsApp template. This helps you make sure you're using the right one for the right situation. ### send_interactive_message Send a message with up to three buttons. It's a great way to get users to click a specific option instead of typing. ### send_media_message Send images, videos, audio, or documents via a public URL. This lets your agent share rich content like receipts or manuals. ### send_reaction Add an emoji reaction to a specific message. It makes the interaction feel more human and less like a bot. ### send_template_message Send a pre-approved template to a specific number. You just provide the phone number and the variables to fill in the blanks. ### send_text_message Send a standard text message to a user. This is best for quick replies during an active 24-hour conversation window. ## Prompt Examples **Prompt:** ``` Send a template 'order_confirmation' in en_US to 5511999999999 with params ['12345']. ``` **Response:** ``` **Order Confirmation Sent** - **Status:** 200 OK - **Recipient:** 5511999999999 - **Template:** order_confirmation - **Parameters:** ['12345'] ``` **Prompt:** ``` Send an interactive message to 5511999999999 asking 'Did you receive your order?' with buttons 'Yes' and 'No'. ``` **Response:** ``` **Interactive Message Sent** - **Status:** 200 OK - **Recipient:** 5511999999999 - **Question:** Did you receive your order? - **Buttons:** Yes, No ``` **Prompt:** ``` React with a thumbs up emoji to message ID msg_123 for user 5511999999999. ``` **Response:** ``` **Reaction Added** - **Status:** 200 OK - **Message ID:** msg_123 - **Emoji:** 👍 - **User:** 5511999999999 ``` ## Capabilities ### Send pre-approved WhatsApp templates Send official notifications and alerts using your pre-approved business templates. ### Send free-form text messages Send quick, conversational text messages during an active 24-hour session window. ### Share images, videos, and documents Send rich media like photos, audio files, or PDFs via public URLs. ### Create interactive buttons Include up to three quick reply buttons to guide users toward specific actions. ### React to messages with emojis Add emoji reactions to specific customer messages to make interactions feel more human. ### Check template information Retrieve details about specific templates to ensure you use the correct parameters. ## Use Cases ### Order Confirmations A customer buys a product and the agent uses send_template_message to send an instant receipt with the order ID. ### Support Media Sharing A user asks for a manual and the agent uses send_media_message to provide a PDF link to the documentation. ### Survey Polling A marketing lead asks the agent to send an interactive poll using send_interactive_message to gather customer feedback. ### Real-time Alerts A developer sets up a trigger where the agent uses send_text_message to notify a user of a system status change. ## Benefits - Stop manual copy-pasting by using send_template_message to automate notifications directly from your chat. - Improve engagement by using send_interactive_message to give customers clear options to click. - Share rich content faster with send_media_message to send product videos or PDFs instantly. - Humanize your brand by using send_reaction to acknowledge customer messages with emojis. - Save time on research by using get_template_info to quickly see what details a template requires. - Maintain conversation flow with send_text_message for quick, free-form replies during active sessions. ## How It Works The bottom line is you get a direct line to WhatsApp Business from your AI agent without touching a separate dashboard. 1. Connect your Gupshup API key to the Connector in your client settings. 2. Open your AI client like Claude, Cursor, or Windsurf. 3. Ask your agent to send a message, share a file, or react to a chat. ## Frequently Asked Questions **Can I use Gupshup Messaging to send images to customers?** Yes, you can. The Connector lets your agent send images, videos, and documents as rich media messages. Just provide a public URL, and the agent handles the rest. **Does this work for standard text messages too?** It works for free-form text messages within the 24-hour window of an active conversation. For messages outside that window, you'll need to use a pre-approved template. **Can my AI agent send buttons in WhatsApp?** Yes. You can use the interactive message tool to send up to three buttons. This is great for giving customers clear choices like Yes or No. **Do I need to host my files online for this to work?** Yes, for media messages like images or PDFs, you need to provide a public URL. The Connector sends the link to WhatsApp so the user can view it. **How do I know which template parameters to use?** You can ask your agent to check the template info first. It will pull the specific requirements for a template so you don't have to guess. **Can I use this for marketing alerts?** Absolutely. It's a common way to send out notifications, alerts, and marketing messages using pre-approved WhatsApp templates. **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.