WhatsApp Business Integration

The WhatsApp Business integration provides access to send WhatsApp messages and templates through the Integrate MCP server.

Installation

The WhatsApp Business integration is included with the SDK:

import { whatsappIntegration } from "integrate-sdk/server";

Setup

1. Create a WhatsApp Business OAuth App

1. Go to Meta for Developers
2. Create a new OAuth application
3. Configure your redirect URI
4. Note your Client ID and Client Secret

2. Configure the Integration on Your Server

Add the WhatsApp Business integration to your server configuration. The integration automatically reads WHATSAPP_CLIENT_ID and WHATSAPP_CLIENT_SECRET from your environment variables:

import { createMCPServer, whatsappIntegration } from "integrate-sdk/server";

export const { client: serverClient } = createMCPServer({
  apiKey: process.env.INTEGRATE_API_KEY,
  integrations: [
    whatsappIntegration({
    }),
  ],
});

You can override the environment variables by passing explicit values:

whatsappIntegration({
  clientId: process.env.CUSTOM_WHATSAPP_ID,
  clientSecret: process.env.CUSTOM_WHATSAPP_SECRET,
});

3. Client-Side Usage

The default client automatically includes all integrations. You can use it directly:

import { client } from "integrate-sdk";

await client.authorize("whatsapp");
const result = await client.whatsapp.sendMessage({
  phone_number_id: "value",
});

console.log(result);

If you're using a custom client, add the integration to the integrations array:

import { createMCPClient, whatsappIntegration } from "integrate-sdk";

const customClient = createMCPClient({
  integrations: [whatsappIntegration()],
});

Configuration Options

Tools

whatsapp_send_message

Send a plain text message

whatsapp_reply_message

Reply to a specific message (quoted reply)

whatsapp_send_template

Send a pre-approved template message

whatsapp_send_media

Send an image, video, document, or audio file by URL

whatsapp_send_reaction

React to a message with an emoji

whatsapp_send_location

Send a location pin

whatsapp_send_contact

Send one or more vCard-style contact cards

whatsapp_send_interactive_buttons

Send a message with up to 3 quick-reply buttons

whatsapp_send_interactive_list

Send a message with a scrollable list of options

whatsapp_mark_read

Mark a received message as read (shows blue ticks to sender)

whatsapp_get_media_url

Get the download URL and metadata for a received media object

whatsapp_delete_media

Delete an uploaded media object from Meta's servers

whatsapp_list_templates

List all message templates for a WhatsApp Business Account

whatsapp_get_template

Get a specific template by name

whatsapp_create_template

Create a new message template (submitted for Meta review)

whatsapp_delete_template

Delete a template by name (all language variants)

whatsapp_get_phone_numbers

List all phone numbers registered to a WABA

whatsapp_get_phone_number

Get full details for a specific phone number

whatsapp_get_profile

Get the public business profile for a phone number

whatsapp_update_profile

Update the business profile (pass only the fields you want to change)

whatsapp_get_message_status

Get status of a sent message by message ID

whatsapp_create_qr_code

Create a QR code that opens a chat with a prefilled message

whatsapp_update_qr_code

Update qr code

whatsapp_list_qr_codes

List all QR codes for a phone number

whatsapp_get_qr_code

Get qr code

whatsapp_delete_qr_code

Delete qr code

Notes

• Category: Communication
• Authentication mode: OAuth