# Gallabox MCP for AI Agents AI Agent Connect > Gallabox MCP lets you connect your WhatsApp Business account to your AI agent to handle customer chats, send templates, and manage your contact database automatically. It moves your messaging into a conversational workspace where your agent can actually do the work instead of you clicking through a dashboard. ## Overview - **Category:** communication-messaging - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_SxHugcMUs5oR0UjJWThKtAk9B3oYkoWlqeKqJhHG/ai-agent-connect - **Tags:** whatsapp-automation, shared-inbox, chatbot, transactional-messaging, customer-engagement, notifications ## Description Connecting your Gallabox account to your AI agent changes how you handle customer communication. Instead of jumping between browser tabs to check your shared inbox, your agent can now see what's happening in real time. You can ask your agent to pull up the history of a specific conversation so it knows exactly what a customer said last week before you reply. It handles the heavy lifting of looking up contact details or identifying which channels are active, letting you focus on high-level strategy. Whether you're sending out bulk notifications or checking on a single support ticket, this Connector gives your agent the tools it needs to act on your behalf. It's a lot easier to manage your WhatsApp presence when your AI client can actually interact with your database. You'll find this Connector in the Vinkius catalog, which makes it simple to get your workspace connected and running without a headache. You get a direct line between your customer's phone and your primary workspace, making every interaction feel more deliberate and less like a chore. This setup removes the friction of manual data entry and allows you to scale your messaging without increasing your workload. ## Tools ### verify_api_connection Check if your Gallabox account is actually linked and ready to go. This ensures your agent has the correct permissions to perform actions. ### get_contact_details Pull specific customer metadata to give your agent more context. This helps the agent recognize a customer's history or status immediately. ### get_chat_details Get the metadata for a specific conversation thread to see its current status. Use this to see if a chat is active or needs attention. ### get_my_profile Pull your own account profile information to verify your identity in the system. This is useful for checking your specific account permissions. ### list_whatsapp_channels See all the active WhatsApp channels you have configured for different purposes. This helps you route messages to the correct destination. ### list_whatsapp_contacts Pull a list of all your current chat contacts into your workspace. This lets you see who you are interacting with at a glance. ### list_active_chats See every ongoing conversation currently happening in your Gallabox inbox. This helps you prioritize which customers need a reply first. ### list_thread_messages Fetch the full history of messages for a specific conversation ID. This gives your agent the context it needs to provide accurate answers. ### list_support_teams See the different support teams set up within your Gallabox account. This helps your agent understand the organizational structure of your support. ### list_message_templates See all the approved WhatsApp templates you can use for messaging. This ensures your agent uses the correct, compliant language for outreach. ### send_whatsapp_template Send a pre-approved rich media template to a customer's phone. This is the best way to send consistent order updates or welcome messages. ### send_whatsapp_text Send a standard text message to a customer via the Gallabox platform. Use this for custom replies that don't fit into a pre-approved template. ## Prompt Examples **Prompt:** ``` Send a WhatsApp message to +1234567890 saying 'Hello from AI!'. ``` **Response:** ``` Done! I've sent that message to **+1234567890**. You'll see it appear in your Gallabox inbox shortly. ``` **Prompt:** ``` List all my approved WhatsApp templates. ``` **Response:** ``` I've pulled your approved templates. Here is what you can send: * **Order Confirmation** * **Welcome Message** * **Appointment Reminder** Which one would you like me to use? ``` **Prompt:** ``` Show the message history for conversation 'conv_987'. ``` **Response:** ``` I've pulled the history for conversation **conv_987**. Here's what's been happening: * Customer asked about **shipping times**. * The bot replied with the **2-4 days** policy. * The customer is still waiting for a tracking number. ``` ## Capabilities ### Send WhatsApp messages Let your agent send standard text or rich media templates to customers instantly. ### View chat history Give your agent the full context of a conversation by fetching previous messages. ### Manage contact data Pull specific customer profiles and verify phone numbers through your agent. ### Monitor active chats See all ongoing conversations in your inbox without leaving your app. ### Trigger message templates Send pre-approved business messages for things like order updates. ## Use Cases ### Support Triage A support lead sees a spike in messages and asks the agent to list active chats to find the oldest ones that need a reply. ### Marketing Follow-ups A manager tells the agent to send a specific template to a list of contacts who haven't replied to a previous campaign. ### Contextual Support A rep asks the agent to show the history for a specific chat ID to understand a customer's past complaints before jumping in. ### Data Verification An ops person asks the agent to pull a contact profile to see if a phone number is already in the system before they send a message. ## Benefits - Faster replies: Use `send_whatsapp_text` to let your agent handle routine questions without you ever touching a keyboard. - Better context: Your agent can use `list_thread_messages` to read past interactions before it tries to help a customer. - Easier lookups: Grab customer info with `get_contact_details` instead of searching through a separate CRM or spreadsheet. - Brand consistency: Use `list_message_templates` to ensure every automated message follows your official company guidelines. - Improved oversight: Keep a pulse on your inbox with `list_active_chats` so you can spot urgent issues the moment they happen. ## How It Works The bottom line is your agent gets a direct line to your WhatsApp Business account. 1. Subscribe on Vinkius and get your API keys from the Gallabox settings. 2. Plug those keys into your Connector client to link your accounts. 3. Start asking your agent to handle messages or pull contact data. ## Frequently Asked Questions **Can I use Gallabox MCP to automate my WhatsApp Business?** Yes, this Connector lets your AI agent send messages, check chat statuses, and manage your contacts directly within the Gallabox platform. **Does Gallabox MCP work with my existing chat history?** It does. Your agent can fetch the full message history for any conversation so it knows exactly what a customer said before it responds. **Can my agent send pre-approved templates?** Yes, it can list your approved templates and send them to customers to ensure your messaging stays consistent with your brand. **Who is the best fit for the Gallabox MCP?** It's great for support teams managing shared inboxes, marketing teams sending notifications, and ops leads who need to pull contact data quickly. **How do I get my agent to see my WhatsApp contacts?** The Connector allows your agent to pull your entire contact database and retrieve specific profiles whenever you ask. **Can I use Gallabox MCP with Claude or Cursor?** Yes, it works with any MCP-compatible client, including Claude, Cursor, and Windsurf, to give your agent access to your Gallabox account. **How do I get an API Key and Secret for Gallabox?** Log in to Gallabox, navigate to Settings > API Keys, and click on 'Generate Key' to retrieve your credentials. **What is a 'Channel ID' and where do I find it?** The Channel ID is the unique identifier for your WhatsApp Business number. You can find it in Settings > Connect > WhatsApp Channel, or by using the 'list_whatsapp_channels' tool. **Can I send interactive buttons via this agent?** Currently, the 'send_whatsapp_template' tool supports pre-approved templates which can include interactive buttons configured in your WhatsApp dashboard. **Are templates required for all messages?** No. You can send standard text messages to customers who have messaged you in the last 24 hours using 'send_whatsapp_text'. Templates are required for business-initiated outreach outside this window.