WhatsApp Business API MCP Server
2025.04.03
1
JavaScriptWhatsApp Business API客户沟通业务管理交流协作
WhatsApp Business API MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，用于与 WhatsApp Business API 进行交互。它提供了发送消息、管理消息模板、上传和管理媒体文件、更新业务资料信息、管理电话号码以及配置 webhooks 等功能。适用于企业通过 WhatsApp 进行客户沟通和业务管理的场景。
View on GitHub
Overview
基本能力
产品定位
WhatsApp Business API MCP Server 是一个用于与 WhatsApp Business API 交互的 MCP 服务，旨在帮助企业通过 WhatsApp 进行高效的客户沟通和业务管理。
核心功能
- 消息发送：支持发送文本、模板、媒体、交互式消息等多种类型的消息。
- 消息模板管理：创建和管理消息模板。
- 媒体管理：上传、获取和删除媒体文件。
- 业务资料管理：获取和更新业务资料信息。
- 电话号码管理：获取电话号码详情、请求验证码和验证电话号码。
- Webhooks 配置：订阅和删除 webhook 订阅。
适用场景
- 企业客户服务：通过 WhatsApp 发送通知、营销消息或客户支持消息。
- 自动化消息：使用模板消息自动化客户沟通流程。
- 媒体共享：通过 WhatsApp 共享图片、视频或文档。
- 业务资料更新：动态更新企业资料信息。
工具列表
- 消息工具：
sendTextMessage,sendTemplateMessage,sendImageMessage,sendDocumentMessage,sendVideoMessage,sendLocationMessage,sendContactMessage,sendInteractiveMessage,markMessageAsRead。 - 媒体工具：
uploadMedia,getMediaUrl,deleteMedia。 - 模板工具：
getMessageTemplates,createMessageTemplate。 - 业务资料工具：
getBusinessProfile,updateBusinessProfile。 - 电话号码工具：
getPhoneNumbers,getPhoneNumberById,requestVerificationCode,verifyCode。 - Webhooks 工具：
getWebhookInfo,subscribeWebhook,deleteWebhookSubscription。
常见问题解答
- 依赖问题：确保安装 Node.js 16 或更高版本。
- 配置问题：确保正确配置
.env文件中的 WhatsApp Business API 凭证。
使用教程
使用依赖
- 安装 Node.js 16 或更高版本：
bash sudo apt-get install -y nodejs
安装教程
- 使用 npm 安装：
bash npm install whatsapp-business-mcp-server - 或使用 npx 直接运行：
bash npx whatsapp-business-mcp-server
调试方式
- 启动服务器：
bash npm start - 开发模式：
bash npm run dev - 使用 MCP Inspector：
bash npm run inspect