# How to connect Whatsapp to Muse ```json { "title": "How to connect Whatsapp to Muse", "toolkit": "Whatsapp", "toolkit_slug": "whatsapp", "framework": "Muse", "framework_slug": "muse", "url": "https://composio.dev/toolkits/whatsapp/framework/muse", "markdown_url": "https://composio.dev/toolkits/whatsapp/framework/muse.md", "updated_at": "2026-10-04T16:47:29.026Z" } ``` ## Introduction Muse is Meta's AI assistant. It can connect to outside tools through custom connectors, which use the Model Context Protocol (MCP). This guide explains how to connect Whatsapp to Muse using Composio Connect, which handles OAuth, token refresh, and reliability so you do not have to. You add Composio as a custom connector once, then ask Muse to work with Whatsapp in plain language. ## Also integrate Whatsapp with - [Claude Code](https://composio.dev/toolkits/whatsapp/framework/claude-code) - [Cursor](https://composio.dev/toolkits/whatsapp/framework/cursor) - [ChatGPT](https://composio.dev/toolkits/whatsapp/framework/chatgpt) - [Claude Cowork](https://composio.dev/toolkits/whatsapp/framework/claude-cowork) - [Antigravity](https://composio.dev/toolkits/whatsapp/framework/antigravity) - [OpenAI Agents SDK](https://composio.dev/toolkits/whatsapp/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/whatsapp/framework/claude-agents-sdk) - [Grok Bot](https://composio.dev/toolkits/whatsapp/framework/grok-bot) - [Codex](https://composio.dev/toolkits/whatsapp/framework/codex) - [Kimi Code](https://composio.dev/toolkits/whatsapp/framework/kimi) - [Grok Build](https://composio.dev/toolkits/whatsapp/framework/grok-build) - [VS Code](https://composio.dev/toolkits/whatsapp/framework/vscode) - [OpenCode](https://composio.dev/toolkits/whatsapp/framework/opencode) - [OpenClaw](https://composio.dev/toolkits/whatsapp/framework/openclaw) - [Hermes](https://composio.dev/toolkits/whatsapp/framework/hermes-agent) - [Atomic Agent](https://composio.dev/toolkits/whatsapp/framework/atomic-agent) - [Pi](https://composio.dev/toolkits/whatsapp/framework/pi-agent) - [DeepSeek Harness](https://composio.dev/toolkits/whatsapp/framework/deepseek) - [CLI](https://composio.dev/toolkits/whatsapp/framework/cli) - [Google ADK](https://composio.dev/toolkits/whatsapp/framework/google-adk) - [LangChain](https://composio.dev/toolkits/whatsapp/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/whatsapp/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/whatsapp/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/whatsapp/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/whatsapp/framework/crew-ai) - [Pydantic AI](https://composio.dev/toolkits/whatsapp/framework/pydantic-ai) - [AutoGen](https://composio.dev/toolkits/whatsapp/framework/autogen) ## TL;DR - Cross-app workflows across 1,500+ apps from a single plugin layer. - On-demand tool loading so Muse only loads the tools needed for the current task. - Programmatic tool calling through a remote workbench for complex, multi-step workflows. - Multi-account support so users can connect and switch between multiple accounts for the same app. - Shared account access so teams or agents can work through common business accounts and service connections. - Managed authentication with OAuth handling, credential storage, and token refresh managed by Composio. - Safer credential handling so app credentials stay outside the model context and tool responses. - User-level account isolation so actions run against the correct connected account instead of mixing user access. ## Connect Whatsapp to Muse ### Connecting Whatsapp to Muse You add Composio to Muse once as a custom connector, then connect Whatsapp from the chat. ## What is the Whatsapp MCP server, and what's possible with it? The WhatsApp MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your WhatsApp account. It provides structured and secure access to your WhatsApp Business account settings, profiles, templates, flows, and phone configuration, so your agent can manage business details, register phone numbers, maintain templates, update flows, and review account settings on your behalf. - Business profile management: Have your agent update your business description, contact information, and other WhatsApp Business profile settings. - Phone number administration: Direct your agent to register or deregister a WhatsApp Business phone number and set its two-step verification PIN. - Message template management: Let the agent browse the template library and create or update templates for your WhatsApp Business account. - Flow and commerce configuration: Instruct your agent to review Flow assets, update Flow configurations, and check commerce settings for your business phone number. - Account oversight and access: Have your agent review owned or shared business accounts, inspect compliance and encryption details, manage assigned user access, and subscribe your application to account notifications. ## Supported Tools | Tool slug | Name | Description | |---|---|---| | `WHATSAPP_CREATE_MESSAGE_TEMPLATE` | Create message template | Create a new message template for the WhatsApp Business Account. Templates must be approved by WhatsApp before they can be used. Templates are required for marketing messages and messages sent outside the 24-hour window. | | `WHATSAPP_DELETE_MESSAGE_TEMPLATE` | Delete message template | Delete a message template from the WhatsApp Business Account by name. This permanently removes the template and it cannot be recovered. When you delete a template by name, all templates with that name across all languages will be deleted. Names of deleted templates cannot be reused for 30 days. Important: Only delete templates that are no longer needed, as this operation is irreversible. | | `WHATSAPP_GET_BUSINESS_PROFILE` | Get business profile | Get the business profile information for a WhatsApp Business phone number. This includes business details like description, address, website, and contact info. | | `WHATSAPP_GET_MEDIA_INFO` | Get media info | Get metadata and download URL for uploaded WhatsApp media. Returns media ID, download URL (valid for 5 minutes), MIME type, SHA256 hash, and file size. The download URL can be used to retrieve the actual media file. | | `WHATSAPP_GET_MESSAGE_TEMPLATES` | Get message templates | Get all message templates for the WhatsApp Business Account. Templates are required for sending messages outside the 24-hour window and for marketing/utility messages. | | `WHATSAPP_GET_PHONE_NUMBER` | Get phone number | Retrieve detailed information about a specific WhatsApp Business phone number. Returns phone number details including verification status, quality rating, display number, verified business name, throughput limits, and webhook configuration. Use this to check phone number status, settings, and capabilities. To get available phone number IDs, first call WHATSAPP_GET_PHONE_NUMBERS. | | `WHATSAPP_GET_PHONE_NUMBERS` | Get phone numbers | Retrieve all phone numbers registered to your WhatsApp Business Account. Returns phone number IDs, display numbers, verification status, quality ratings, and messaging throughput limits. Use the phone number ID from the response to send WhatsApp messages via other API actions. | | `WHATSAPP_GET_TEMPLATE_STATUS` | Get template status | Get the status and details of a specific message template. This is useful for checking if a template has been approved, rejected, or is still pending review. | | `WHATSAPP_SEND_CONTACTS` | Send contacts | Send contacts WhatsApp number. Note: The message will be delivered to the recipient only if they have initiated a conversation first. | | `WHATSAPP_SEND_INTERACTIVE_BUTTONS` | Send interactive buttons | Send an interactive button message with up to 3 reply buttons to a WhatsApp user. Interactive button messages allow recipients to quickly respond by tapping predefined buttons. Perfect for yes/no questions, multiple choice selections, quick actions, or call-to-action scenarios. IMPORTANT REQUIREMENTS: - The recipient must be a registered WhatsApp user - The recipient must have messaged your business first within the last 24 hours (WhatsApp's customer service window) - You can include 1-3 buttons per message - Each button can have a title (max 20 chars) and unique ID (max 256 chars) Use cases: Customer service menus, appointment confirmations, feedback collection, product selections. | | `WHATSAPP_SEND_INTERACTIVE_LIST` | Send interactive list | Send an interactive list message to a WhatsApp number. List messages display a menu of options organized into sections. Users tap a button to view the list and select one option. Perfect for product catalogs, service menus, or guided workflows. Supports up to 10 sections with up to 10 items per section (100 total options). Note: Recipients must have messaged you first within the last 24 hours to receive this message. | | `WHATSAPP_SEND_LOCATION` | Send location | Send a location message with coordinates, name, and address to a WhatsApp user. This action allows you to share location information through WhatsApp Business API. The location message includes latitude/longitude coordinates, a location name, and address. Important: The recipient must have an active WhatsApp account. Additionally, you can only send free-form messages (like location messages) within the 24-hour customer service window after the recipient has initiated contact with your business. Outside this window, you must use approved message templates. Common error codes: - 133010: Recipient's phone number doesn't have a WhatsApp account - 131026: Message undeliverable (recipient may have blocked your business number) - 131047: Re-engagement message (outside 24-hour window, need to use template) | | `WHATSAPP_SEND_MEDIA` | Send media | Send a media message to a WhatsApp number. Note: The media will be delivered to the recipient only if they have texted first. | | `WHATSAPP_SEND_MEDIA_BY_ID` | Send media by | Send media using a media ID from previously uploaded media. This is more efficient than sending media by URL as the media is already on WhatsApp servers. Use upload_media action first to get the media ID. Note: The media will be delivered to the recipient only if they have texted first. | | `WHATSAPP_SEND_MESSAGE` | Send message | Send a text message to a WhatsApp user. Important: The recipient phone number must be registered on WhatsApp and must have initiated a conversation with your business within the last 24 hours, OR you must use a template message (see WHATSAPP_SEND_TEMPLATE_MESSAGE) for the first message outside the 24-hour window. For test accounts, recipient numbers must be added to the test recipient list in Meta Business Suite before sending messages. | | `WHATSAPP_SEND_TEMPLATE_MESSAGE` | Send template message | Send a template message to a WhatsApp number. | | `WHATSAPP_UPLOAD_MEDIA` | Upload media | Upload media files (images, videos, audio, documents, stickers) to WhatsApp servers. The uploaded media gets a media ID that can be used in send_media or other messaging actions. Supported formats: - Images: JPEG, PNG (max 5MB) - Videos: MP4, 3GPP (max 16MB) - Audio: AAC, M4A, AMR, MP3, OGG (max 16MB) - Documents: PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX (max 100MB) - Stickers: WebP (max 500KB, 512x512 pixels) | ## Supported Triggers | Trigger slug | Name | Description | |---|---|---| | `WHATSAPP_MESSAGE_STATUS_UPDATED_TRIGGER` | Message Status Updated | Triggers when a WhatsApp message status changes. IMPORTANT LIMITATION: WhatsApp Cloud API does not provide a native polling endpoint for message status. Status updates are ONLY delivered via webhooks in real-time. This trigger cannot directly poll the WhatsApp API for status updates. This trigger will return empty results as WhatsApp does not support this operation. To track message status updates, you must: 1. Set up a webhook endpoint to receive status notifications from WhatsApp 2. Store the webhook data in your own database 3. Use a different mechanism to query your stored webhook data For more information, see: - https://developers.facebook.com/docs/whatsapp/cloud-api/webhooks | ## Troubleshooting ### 1. Why doesn't Muse show a button to add my API key? Muse shows the button only when you ask it to open the secure credentials store. - Start a new chat. - Send the message from step 1 exactly as written. - If Muse asks for the key in the chat, do not paste it. Ask Muse to open the secure credentials store. ### 2. Why does the Composio connection fail after I add my API key? The key or the connector settings are not correct. - Copy the full key from the Composio dashboard. It starts with ck_. - Make sure the URL is https://connect.composio.dev/mcp and the header is x-consumer-api-key. - Remove the Composio connector in Muse settings, then do steps 1 to 3 again. ### 3. Why doesn't Muse use the Composio tools for Whatsapp? Muse may not pick the Composio connector for the request. - Ask Muse to list its Composio tools. - Name Composio and Whatsapp in your request, for example: Use Composio to connect to Whatsapp. - If it still does not work, start a new chat and try again. ### 4. Why does Muse ask me to connect Whatsapp again? Your Whatsapp connection expired or was removed. - Open the link Muse gives you and sign in to Whatsapp again. - Check that the Whatsapp connection shows as ACTIVE in the Composio dashboard. ### 5. What do I do if I pasted my API key into the chat? Treat the key as exposed. - Create a new API key in the Composio dashboard and delete the old one. - Add the new key in Muse's secure credentials store, not in the chat. ## Creating MCP Server - Stand-alone vs Composio SDK Once connected, Muse can access the Whatsapp MCP server through Composio to run the actions you authorize, using plain language in the chat. ## Complete Code None listed. ## Conclusion ### Way Forward Now that Whatsapp is connected, extend your setup by connecting the other apps you already use every day, so Muse can run true cross-app workflows end to end. - Connect Calendar to turn threads into scheduled meetings automatically. - Connect Slack or Teams to post summaries, approvals, and alerts where your team works. - Connect Notion, Linear, Jira, or Asana to convert requests into tickets, tasks, and docs. - Connect Drive, Dropbox, or OneDrive to fetch, file, and share attachments without manual steps. Start with one workflow you do repeatedly, then keep adding apps as you find new handoffs. With everything behind a single connection, Muse can coordinate multiple tools safely and reliably in one conversation. ## How to build Whatsapp MCP Agent with another framework - [Claude Code](https://composio.dev/toolkits/whatsapp/framework/claude-code) - [Cursor](https://composio.dev/toolkits/whatsapp/framework/cursor) - [ChatGPT](https://composio.dev/toolkits/whatsapp/framework/chatgpt) - [Claude Cowork](https://composio.dev/toolkits/whatsapp/framework/claude-cowork) - [Antigravity](https://composio.dev/toolkits/whatsapp/framework/antigravity) - [OpenAI Agents SDK](https://composio.dev/toolkits/whatsapp/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/whatsapp/framework/claude-agents-sdk) - [Grok Bot](https://composio.dev/toolkits/whatsapp/framework/grok-bot) - [Codex](https://composio.dev/toolkits/whatsapp/framework/codex) - [Kimi Code](https://composio.dev/toolkits/whatsapp/framework/kimi) - [Grok Build](https://composio.dev/toolkits/whatsapp/framework/grok-build) - [VS Code](https://composio.dev/toolkits/whatsapp/framework/vscode) - [OpenCode](https://composio.dev/toolkits/whatsapp/framework/opencode) - [OpenClaw](https://composio.dev/toolkits/whatsapp/framework/openclaw) - [Hermes](https://composio.dev/toolkits/whatsapp/framework/hermes-agent) - [Atomic Agent](https://composio.dev/toolkits/whatsapp/framework/atomic-agent) - [Pi](https://composio.dev/toolkits/whatsapp/framework/pi-agent) - [DeepSeek Harness](https://composio.dev/toolkits/whatsapp/framework/deepseek) - [CLI](https://composio.dev/toolkits/whatsapp/framework/cli) - [Google ADK](https://composio.dev/toolkits/whatsapp/framework/google-adk) - [LangChain](https://composio.dev/toolkits/whatsapp/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/whatsapp/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/whatsapp/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/whatsapp/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/whatsapp/framework/crew-ai) - [Pydantic AI](https://composio.dev/toolkits/whatsapp/framework/pydantic-ai) - [AutoGen](https://composio.dev/toolkits/whatsapp/framework/autogen) ## Related Toolkits - [Gmail](https://composio.dev/toolkits/gmail) - Gmail is Google's email service with powerful spam protection, search, and G Suite integration. It keeps your inbox organized and makes communication fast and reliable. - [Outlook](https://composio.dev/toolkits/outlook) - Outlook is Microsoft's email and calendaring platform for unified communications and scheduling. It helps users stay organized with powerful email, contacts, and calendar management. - [Slack](https://composio.dev/toolkits/slack) - Slack is a channel-based messaging platform for teams and organizations. It helps people collaborate in real time, share files, and connect all their tools in one place. - [Gong](https://composio.dev/toolkits/gong) - Gong is a platform for video meetings, call recording, and team collaboration. It helps teams capture conversations, analyze calls, and turn insights into action. - [Microsoft teams](https://composio.dev/toolkits/microsoft_teams) - Microsoft Teams is a collaboration platform that combines chat, meetings, and file sharing within Microsoft 365. It keeps distributed teams connected and productive through seamless virtual communication. - [Slackbot](https://composio.dev/toolkits/slackbot) - Slackbot is a conversational automation tool for Slack that handles reminders, notifications, and automated responses. It boosts team productivity by streamlining onboarding, answering FAQs, and managing timely alerts—all right inside Slack. - [2chat](https://composio.dev/toolkits/_2chat) - 2chat is an API platform for WhatsApp and multichannel text messaging. It streamlines chat automation, group management, and real-time messaging for developers. - [Agent mail](https://composio.dev/toolkits/agent_mail) - Agent mail provides AI agents with dedicated email inboxes for sending, receiving, and managing emails. It empowers agents to communicate autonomously with people, services, and other agents—no human intervention needed. - [Android Texter](https://composio.dev/toolkits/android_texter) - Android Texter is an API service that connects Android phones to SMS, MMS, contacts, and device data. Use it to automate mobile messaging without building your own phone-to-API bridge. - [Basecamp](https://composio.dev/toolkits/basecamp) - Basecamp is a project management and team collaboration tool by 37signals. It helps teams organize tasks, share files, and communicate efficiently in one place. - [Blooio](https://composio.dev/toolkits/blooio) - Blooio is a stable v2 API platform for messaging, chats, contacts, groups, phone numbers, and account analytics. It gives teams a clean way to build reliable communication workflows without stitching together fragile custom APIs. - [Callback24](https://composio.dev/toolkits/callback24) - Callback24 is a telephony API for managing phone calls, users, services, and routing groups. It centralizes call control and routing to automate voice workflows and operations. - [CallOnTheGo](https://composio.dev/toolkits/callonthego) - CallOnTheGo is a telephony API for managing phone numbers, caller IDs, suppression lists, audio assets, contact lists, and Voice AI campaigns. It provides programmatic control over calling infrastructure and campaign automation for scalable voice outreach. - [CardClan](https://composio.dev/toolkits/cardclan) - CardClan is a digital card platform for creating and sending personalized team cards. Use it to celebrate moments, share card links, and manage card workflows without extra coordination. - [Chatwork](https://composio.dev/toolkits/chatwork) - Chatwork is a team communication platform with group chats, file sharing, and task management. It helps businesses boost collaboration and streamline productivity. - [Clickmeeting](https://composio.dev/toolkits/clickmeeting) - ClickMeeting is a cloud-based platform for running online meetings and webinars. It helps businesses and individuals host, manage, and engage virtual audiences with ease. - [Confluence](https://composio.dev/toolkits/confluence) - Confluence is Atlassian's team collaboration and knowledge management platform. It helps your team organize, share, and update documents and project content in one secure workspace. - [Daily](https://composio.dev/toolkits/daily) - Daily is a WebRTC video and audio API platform for building rooms, meetings, recordings, live streams, transcriptions, and telephony. It gives developers reliable real-time media infrastructure without managing complex conferencing stacks. - [Dailybot](https://composio.dev/toolkits/dailybot) - DailyBot streamlines team collaboration with chat-based standups, reminders, and polls. It keeps work flowing smoothly in your favorite messaging platforms. - [Dialmycalls](https://composio.dev/toolkits/dialmycalls) - Dialmycalls is a mass notification service for sending voice and text messages to contacts. It helps teams and organizations quickly broadcast urgent alerts and updates. ## Frequently Asked Questions ### Does Muse support MCP? Yes. Muse supports custom connectors that use the Model Context Protocol (MCP). Composio connects as one custom connector over remote streamable HTTP at https://connect.composio.dev/mcp, and gives Muse access to Whatsapp and 1,500+ other apps. ### Where do I get the API key for the Composio connector? Copy it from the Composio dashboard. It starts with ck_. Enter it only in Muse's secure credentials store, never in the chat. ### Can I connect more than one Whatsapp account to Muse? Yes. Composio supports multiple connected accounts for the same app. Give each Whatsapp connection a name, such as work or personal, and tell Muse which one to use. ### How safe is my Whatsapp data with Composio? Tokens, keys, and configuration are encrypted at rest and in transit. Your Composio API key stays in Muse's secure credentials store, not in the chat or the model context. Composio is SOC 2 Type 2 compliant. --- [See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)