# Gallabox MCP > Gallabox MCP handles all your WhatsApp Business communication through any AI client. Use this to automate outreach, manage shared inboxes, send templates, and track complete customer conversation history at scale. It lets agents interact with contacts and channels without needing a dashboard. ## Overview - **Category:** communication-messaging - **Price:** Free - **Tags:** whatsapp-automation, shared-inbox, chatbot, transactional-messaging, customer-engagement, notifications ## Description Need to handle high-volume messaging for your business? This MCP connects your WhatsApp Business account directly to any AI agent, giving it deep access to your communication tools. You can use it to manage shared inboxes and deploy bots that act like trained support staff. Instead of logging into a separate platform, your AI client talks directly to Gallabox. It reads the full message history for specific conversations, verifies contact details, and lets you list all approved templates before sending anything out. This capability is critical because it keeps the entire communication flow within your agent's natural conversation, allowing real-time actions on things like listing active chats or checking which support teams are available. Because this MCP lives in Vinkius, your AI client gets instant access to these tools, making complex WhatsApp workflows feel as simple as asking a question. ## Tools ### verify_api_connection Checks if your API credentials are valid and connected correctly. ### get_contact_details Retrieves detailed profile information for a specific contact. ### get_chat_details Fetches metadata about an entire conversation thread. ### get_my_profile Retrieves the account profile information for your current user. ### list_whatsapp_channels Lists all active WhatsApp Business channels configured in your account. ### list_whatsapp_contacts Retrieves a list of contacts available within your chat records. ### list_active_chats Lists all current, ongoing WhatsApp conversations in your shared inbox. ### list_thread_messages Retrieves the complete message history for any given conversation ID. ### list_support_teams Lists all support teams configured within your Gallabox account. ### list_message_templates Shows you every approved message template available for sending out. ### send_whatsapp_template Sends a pre-approved, structured message using one of your saved templates. ### send_whatsapp_text Sends a simple, freeform text message to any contact. ## Prompt Examples **Prompt:** ``` Send a WhatsApp message to '+1234567890' saying 'Hello from AI!'. ``` **Response:** ``` Message sent! I've successfully queued your WhatsApp message to +1234567890 via Gallabox. The message will appear in your open conversations inbox. ``` **Prompt:** ``` List all my approved WhatsApp templates. ``` **Response:** ``` Retrieving templates... I found 5 approved templates, including 'Order Confirmation', 'Welcome Message', and 'Appointment Reminder'. Which one would you like to use? ``` **Prompt:** ``` Show the message history for conversation 'conv_987'. ``` **Response:** ``` Fetching thread... For conversation conv_987, I found 3 recent messages. The customer asked about 'shipping times' and the bot replied with the standard '2-4 days' policy. ``` ## Capabilities ### Monitor and retrieve chat history Get the full context of any conversation by listing active chats or fetching detailed message threads for specific IDs. ### Manage contacts and profiles View your contact database, get individual profile details, or even check if a phone number is valid. ### Automate messaging outreach Send standard text messages to customers, or deploy pre-approved templates for transactional notifications at scale. ### Organize communication assets List all available message templates and identify configured WhatsApp channels by accessing channel IDs. ### Coordinate team support tasks Access details about support teams and verify your own account metadata to assign chats efficiently. ## Use Cases ### A customer asks about an order status update. The Support Agent uses the MCP to list thread messages for the conversation ID. The agent reads the last five exchanges, sees the original order number mentioned, and then sends a simple text message to confirm the tracking link. ### Marketing needs to launch an appointment reminder campaign. The Marketing Manager asks the agent to list message templates. They select 'Appointment Reminder' and use send whatsapp template to execute the outreach instantly across 50 contacts. ### A new chat comes in with unclear contact info. Instead of guessing, the Ops Specialist asks the agent to get contact details. The agent confirms the user's name and company before sending a personalized welcome message via send whatsapp text. ### The team needs to audit all open conversations today. A Support Lead simply uses list active chats, which provides an immediate dashboard view of every conversation thread that is currently ongoing or waiting for attention. ## Benefits - Contextual replies are automatic. Instead of manually digging through logs, asking the agent to list thread messages gives it the full history needed to draft an accurate response. - Streamlined support triage. You can use list active chats or list support teams to immediately know who owns a conversation and if it's already flagged for attention. - Compliance guaranteed. Before sending anything out, you can call list message templates to make sure the outreach uses only approved language and structure. - Data accuracy on demand. Get contact details anytime by using get contact details to verify name or phone number before a critical communication. - Full visibility across channels. List whatsapp channels identifies every unique ID so your agent knows exactly where to route messages, whether it's internal or external. ## How It Works The bottom line is that once connected, your AI agent treats your entire WhatsApp Business account like a set of functions it can call on demand. 1. Subscribe to this MCP through the Vinkius Marketplace. 2. Enter your Gallabox API Key and API Secret into the connection settings. 3. Your AI client now handles all WhatsApp workflows, allowing you to send messages or check histories via natural conversation. ## Frequently Asked Questions **How do I list all active conversations using Gallabox MCP?** Use the list active chats tool. This immediately provides a comprehensive list of currently running conversation threads, letting your agent know exactly what attention is needed. **Can Gallabox MCP send messages if I don't have a template?** Yes. You can use the send whatsapp text tool for simple, freeform messaging to any contact. For structured or branded outreach, you should use send whatsapp template. **What is the difference between list_whatsapp_contacts and get_contact_details?** list whatsapp contacts provides a general directory of names available in your chat history. However, get contact details fetches specific metadata for one person, verifying their current profile information. **Does Gallabox MCP handle support team assignments?** Yes. You can use list support teams to see which groups are available and verify your own account profile with get my profile before assigning a chat for optimal handoff. **Is it safe to let the AI client send messages via Gallabox MCP?** The system is designed around pre-approved templates. The tool list message templates ensures you only deploy compliant messaging, minimizing risk when using send whatsapp template.