# 1msg.io MCP for AI Agents AI Agent Connect > 1msg.io lets your AI agent send official WhatsApp messages, manage business templates, and monitor your connection status. It connects your AI to the official WhatsApp Business API so you can handle customer support and marketing broadcasts without breaking Meta's rules. ## Overview - **Category:** communication-messaging - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_L3RJgZBHbNZiY9pMriS52ap8T5E45cPrp8cLXBRT/ai-agent-connect - **Tags:** whatsapp-api, business-messaging, customer-engagement, broadcast-messaging, template-management, automation ## Description Imagine your AI agent actually being able to talk to your customers on WhatsApp without you having to copy and paste messages from a web dashboard. This Connector bridges that gap by connecting your agent directly to the official WhatsApp Business API. Instead of just generating text, your agent can actually push out messages, send over PDF invoices, and check if your connection is still live. It handles the heavy lifting of staying compliant with Meta's standards while giving your AI the ability to act on your behalf. You can set up automated support flows or send out marketing broadcasts just by telling your agent what to do in plain English. Because it's hosted on the Vinkius catalog, getting your agent connected to these official channels is straightforward. You're basically giving your AI a phone line that speaks the official language of business messaging. ## Tools ### send_message Send a simple text message to a specific phone number. It's the quickest way to get a reply from a customer. ### send_template Send a pre-approved WhatsApp template. Use this to initiate conversations with customers who haven't messaged you first. ### get_status Check if your WhatsApp channel is currently connected. Use this to troubleshoot why messages might not be sending. ### list_messages Pull up recent incoming and outgoing messages. This helps your agent keep track of the conversation history. ### send_file Send media like PDFs or images to your contacts. This is perfect for sending invoices or product catalogs. ### list_templates See all your approved templates in a list. This helps you pick the right message for the right situation. ## Prompt Examples **Prompt:** ``` Send the shipping confirmation to +15550123. Tell them it's on the way. ``` **Response:** ``` **Action:** Shipping Confirmation Sent | Detail | Status | | --- | --- | | Recipient | +15550123 | | Method | Official Template | | Note | The message was dispatched through the 1msg.io gateway. ``` **Prompt:** ``` Check if our WhatsApp is still online. ``` **Response:** ``` Checking your connection... **Status:** Connected Your 1msg.io channel is active and ready to send messages. ``` **Prompt:** ``` What were the last three things this customer said? ``` **Response:** ``` Here is the recent history for this contact: * "Can I get a refund?" * "My order was damaged." * "I'd like to speak to a human." ``` ## Capabilities ### Send text messages Your agent sends plain text to any WhatsApp number. ### Share media files Send images, PDFs, or videos to your customers. ### Trigger templates Send pre-approved WhatsApp messages to start conversations. ### Check connection status See if your WhatsApp channel is currently online. ### Review message history Look back at past conversations to keep context. ### Manage template lists See all your approved templates in one place. ## Use Cases ### Sending automated invoices A customer asks for a receipt. The agent uses send_file to grab the PDF and send it to their WhatsApp number immediately. ### Initiating customer outreach You need to send a shipping update. The agent identifies the correct template and uses send_template to notify the customer. ### Contextual sales follow-ups A lead hasn't replied in two days. The agent uses list_messages to check the history and then sends a follow-up via send_message. ### Connection health monitoring You aren't sure if the API is down. The agent runs get_status to confirm the channel is connected before trying to send a broadcast. ## Benefits - Stay compliant with Meta standards by using official API channels instead of unofficial workarounds. - Send files like PDF invoices or images using send_file to provide a richer experience for your customers. - Start conversations legally with customers using send_template to trigger pre-approved messages. - Keep your AI in the loop on past conversations by pulling message history with list_messages. - Verify your connection is active in real time with get_status to avoid downtime during peak hours. - Manage your entire messaging library easily by using list_templates to see what's available. ## How It Works The bottom line is you get a direct, official bridge between your AI and your WhatsApp customers. 1. Subscribe to the 1msg.io MCP and grab your JWT token. 2. Paste that token into your configuration to link your account. 3. Tell your agent to send a message or check status to start chatting. ## Frequently Asked Questions **Can 1msg.io help my AI send official WhatsApp messages?** Yes, it connects your AI to the official WhatsApp Business API, allowing for reliable and compliant messaging. **Does the 1msg.io MCP support sending images and PDFs?** Yes, you can send media files like images, videos, and PDFs directly to your customers. **How do I make sure my AI doesn't get my WhatsApp number banned?** By using this Connector, your agent follows official Meta standards for business messaging, which is the safest way to operate. **Can my agent see what customers have said in the past?** Yes, the Connector lets your agent pull recent message logs to maintain conversation context and provide better answers. **Is this for personal WhatsApp accounts or business ones?** This is designed for the official WhatsApp Business API, making it ideal for companies and support teams. **Can I use pre-approved templates with this Connector?** Yes, your agent can list and send your pre-approved WhatsApp templates to initiate conversations. **How do I know if my connection is working?** Your agent can check the live status of your 1msg.io channel at any time to ensure everything is running smoothly. **Why do I need to use templates to send a message?** WhatsApp requires the use of pre-approved templates for any message initiated by the business or sent after 24 hours of the last customer interaction. This prevents spam and ensures high-quality communications. **Can I send PDF documents or images via the agent?** Yes! Use the `send_file` tool and provide the recipient's number and the public URL of the document or image. Your agent will handle the formatting and delivery automatically. **How can I check if my WhatsApp channel is currently online?** Use the `get_status` tool. It returns the current state of your 1msg.io instance (e.g., connected, connecting, or disconnected). This is crucial for monitoring your automation health.