communicationoauth2

WhatsApp Business

Customer conversations at scale.

Verdict

This MCP connects your team's WhatsApp Business account to Switchy, letting AI send messages, manage templates, and pull conversation data without leaving a Space. @mention it to draft template messages for customer campaigns, check media uploads, retrieve business profile details, or audit phone numbers tied to your account. Most valuable for support and marketing teams who run WhatsApp campaigns or need quick access to message history and media. Trade-off: OAuth setup requires admin access to your WhatsApp Business Manager, and template creation still needs WhatsApp's approval before you can send.

Common use cases

  • Draft template messages for product launches
  • Retrieve customer media uploads from support chats
  • Audit active phone numbers across business accounts
  • Check template approval status before campaigns
  • Pull business profile details for brand audits

Integration

Vendor
WhatsApp Business
Category
communication
Auth
OAUTH2
Tools
19
Composio slug
whatsapp

Tools

  • 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.

  • Delete message template
    destructive

    Delete a message template from the whatsapp business account. this permanently removes the template and it cannot be recovered. only delete templates that are no longer needed.

  • 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.

  • Get media

    Get information about uploaded media including a temporary download url. the download url is valid for 5 minutes and can be used to retrieve the actual media file. this is useful for downloading media that was sent to your whatsapp number.

  • Get media info

    Get metadata about uploaded media without generating a download url. this is useful for checking file size, type, and hash without downloading the file. use get media if you need the actual download url.

  • 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.

  • Get phone number

    Get details of a specific phone number associated with a whatsapp business account.

  • Get phone numbers

    Get all phone numbers associated with a whatsapp business account (waba).

  • 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.

  • Send contacts

    Send contacts whatsapp number. note: the message will be delivered to the recipient only if they have initiated a conversation first.

  • Send interactive buttons

    Send an interactive button message to a whatsapp number. button messages allow users to quickly respond by tapping up to 3 predefined buttons. perfect for yes/no questions, quick choices, or call-to-action scenarios. note: the message will

  • Send interactive list

    Send an interactive list message to a whatsapp number. list messages allow users to select from up to 10 options in a structured format. great for menus, catalogs, or choices. note: the message will be delivered to the recipient only if the

  • Send location

    Send a location message to a whatsapp number. note: the location will be shared with the recipient only if they have texted first.

  • 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.

  • 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 t

  • Send message

    Send a text message to a whatsapp number. note: the message will reflect on the recipient's phone number only if they have texted first.

  • Send reply

    Send a reply to a specific message in a whatsapp conversation. this creates a contextual reply that shows which message you're responding to. note: the reply will be delivered to the recipient only if they have texted first.

  • Send template message

    Send a template message to a whatsapp number.

  • 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: mp

Setup

Setup guide

  1. 11. In Switchy, open the Space where you want WhatsApp access and click Integrations in the sidebar. 2. Search for WhatsApp Business and click Connect. 3. You'll be redirected to Meta's login page—sign in with the Facebook account that manages your WhatsApp Business account. 4. Grant Switchy permission to read messages, manage templates, and access business profile data (scopes: whatsapp_business_management, whatsapp_business_messaging). 5. Select the WhatsApp Business phone number you want to connect, then authorize. 6. Back in Switchy, confirm the connection shows 'Active' with your phone number displayed. 7. Test it by typing '@WhatsApp Business get business profile' in a Space—AI should return your business name, description, and contact details within seconds.

What teammates see: by default, memories from WhatsApp Business are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Spaces have used this MCP together with a given model.

How Switchy teams use it

Not enough Spaces yet to publish anonymised usage stats (we require ≥ 50 Spaces per week).

Starter prompts

Draft Campaign Template

@WhatsApp Business create a message template for our spring sale with a 20% discount code, category marketing, and include a call-to-action button linking to our shop.
Open in a Space →

Retrieve Customer Media

@WhatsApp Business get media info for the last 5 uploads from customer conversations today, then generate download URLs for any images.
Open in a Space →

Audit Phone Numbers

@WhatsApp Business get all phone numbers associated with our business account and show their display names, verification status, and current messaging tier.
Open in a Space →

Check Template Library

@WhatsApp Business get all message templates and group them by approval status—show me which ones are approved, pending, or rejected.
Open in a Space →

Update Business Profile

@WhatsApp Business get our business profile and compare the description, website, and address against our brand guidelines—flag any mismatches.
Open in a Space →

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@WhatsApp list all message templates for our business account and show which ones are approved

Output

Here are the message templates for your WhatsApp Business account: **Approved Templates:** • order_confirmation (Marketing) - "Hi {{1}}, your order #{{2}} has been confirmed!" • appointment_reminder (Utility) - "Reminder: Your appointment is scheduled for {{1}} at {{2}}" **Pending Review:** • new_product_launch (Marketing) - Submitted 2 days ago **Rejected:** • flash_sale (Marketing) - Reason: Contains promotional language that violates policy You can use approved templates immediately. Pending templates typically take 24-48 hours for WhatsApp review.

Notes

This example shows the MCP's ability to retrieve and organize template status. Remember that templates must be pre-approved by WhatsApp before use—you cannot send marketing messages or messages outside the 24-hour customer service window without an approved template. The approval process is outside Switchy's control and can take 1-2 business days.

Prompt

@WhatsApp create a new appointment reminder template that asks customers to confirm their booking 24 hours in advance

Output

I've submitted a new message template to WhatsApp for approval: **Template Name:** appointment_confirm_24h **Category:** Utility **Language:** English **Content:** "Hi {{1}}, this is a reminder that you have an appointment scheduled for {{2}} at {{3}}. Please reply YES to confirm or CANCEL to reschedule." **Status:** Pending Review **Next Steps:** • WhatsApp typically reviews utility templates within 24 hours • You'll receive a notification once approved or if changes are needed • Cannot use this template until approval is granted • Variables {{1}}, {{2}}, {{3}} will be replaced with customer name, date, and time when sending

Notes

This demonstrates template creation, which is a write action that triggers WhatsApp's approval workflow. The template won't be usable immediately—it enters a review queue. Utility templates (like appointment reminders) typically get faster approval than marketing templates. The MCP requires proper OAuth2 scopes to create templates, and your WhatsApp Business Account must be verified.

Prompt

@WhatsApp check our business profile settings and suggest improvements to increase customer trust

Output

I've retrieved your WhatsApp Business profile. Here's what I found: **Current Profile:** • Business Name: Acme Consulting • Description: (empty) • Address: 123 Main St, Austin, TX • Website: Not set • Email: support@acme.com • Vertical: Professional Services **Recommendations to Increase Trust:** 1. **Add a description** - 78% of customers check this first. Suggest: "Strategic consulting for growing tech companies. Serving Austin since 2019." 2. **Set your website URL** - Builds credibility and provides an easy way for customers to learn more 3. **Add business hours** - Currently not configured; customers don't know when to expect responses 4. **Consider adding a profile photo** - Verified businesses with photos see 40% higher engagement Would you like me to help draft profile updates?

Notes

This example pairs WhatsApp's profile data retrieval with AI reasoning to provide actionable recommendations. The MCP fetches raw profile fields; the AI analyzes completeness and suggests improvements based on best practices. Note that profile changes through the API may require additional verification steps depending on what fields you modify (business name changes, for instance, trigger re-verification).

Use-case deep-dives

Customer support template library

When WhatsApp MCP makes sense for high-volume support teams

A 6-person support team handling 200+ daily inquiries across three time zones needs pre-approved templates for order updates, shipping confirmations, and refund status. The WhatsApp MCP is the right call here because OAuth2 keeps credentials out of individual agent hands, and the template management tools let the team lead audit and retire stale messages without touching the Business API console. The trade-off: templates require WhatsApp approval (usually 24-48 hours), so you can't spin up a new message flow on the fly. If your team sends fewer than 50 messages a day or needs real-time template iteration, the overhead isn't worth it. For teams at scale with stable message patterns, this MCP centralizes template governance and keeps the workspace audit trail clean.

Outbound campaign coordination

Why marketing teams hit the 24-hour window problem

A 3-person growth team running a product launch wants to send WhatsApp announcements to 1,200 opted-in users. The WhatsApp MCP handles template creation and retrieval, but the critical constraint is WhatsApp's 24-hour messaging window: you can only send marketing messages using pre-approved templates, and replies open a 24-hour window for freeform conversation. This MCP works if your campaign is template-driven and you've planned approval lead time. It doesn't work if you're trying to send personalized, one-off messages or react to user behavior in real time. The phone number and business profile tools help the team verify sender identity before launch, but the approval bottleneck means this is a scheduled-campaign play, not a conversational-marketing one. If your launch timeline is under a week, start the template approval process before you integrate.

Media asset handoff workflow

When the media tools solve a specific logistics problem

A 4-person content team sends weekly video tutorials to 300 customers via WhatsApp. The challenge: videos uploaded to WhatsApp expire after 30 days, and the team needs to track which assets are still live before scheduling sends. The WhatsApp MCP's media info and media retrieval tools let the team check file metadata and generate temporary download URLs without leaving Switchy, so they can audit the media library and re-upload expired files in one session. The 5-minute download URL window is tight, so this workflow assumes the team is doing batch checks, not ad-hoc downloads. If your team sends fewer than 10 media messages a month or doesn't need programmatic media audits, the native WhatsApp Business app is simpler. For teams managing a rotating media library at scale, this MCP turns media hygiene into a repeatable task.

Frequently asked

What can the WhatsApp MCP do in Switchy?

The WhatsApp MCP lets your team send templated messages, manage business profiles, and handle media uploads through WhatsApp Business API. It's built for teams running customer support or marketing campaigns that need programmatic access to WhatsApp without writing API code. You can create and delete message templates, retrieve media files, and check phone number details — all from Switchy's AI workspace.

Do I need a WhatsApp Business account to connect this?

Yes. You need an active WhatsApp Business API account (WABA), not just the free WhatsApp Business app. The MCP uses OAuth2, so you'll authenticate through Meta's flow and grant Switchy permission to manage templates, send messages, and access media on your behalf. Individual WhatsApp accounts won't work — this is for verified business accounts only.

Can it send messages to anyone, or only approved contacts?

It can only send templated messages that WhatsApp has pre-approved, and only to users who've opted in to hear from your business. You can't blast arbitrary text to random numbers. Marketing messages require approved templates; customer service replies work within a 24-hour window after the user messages you first. This is WhatsApp's policy, not a Switchy limitation.

Why use this instead of the WhatsApp Business app?

The app is manual and single-user. The MCP gives your whole team programmatic access — create templates in bulk, automate media retrieval, check message status across phone numbers — without logging into Meta Business Suite. If you're running campaigns or support workflows that need automation, the MCP saves hours. If you're just replying to a few customers a day, stick with the app.

Who on my team should connect the WhatsApp MCP?

Whoever owns your WhatsApp Business API account in Meta Business Manager. They need admin access to authenticate and grant Switchy the OAuth scopes. Once connected, any Switchy user with workspace access can invoke the tools — but template approval and phone number setup still happen in Meta's dashboard, not Switchy.

Data last verified 7 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.