Whatsapp MCP Server

一個全面的WhatsApp商業API交互服務器，支持消息發送、模板管理、媒體上傳、業務資料更新等功能。

通信工具客戶支持 #消息服務 #商業API #模板管理 #媒體上傳 .JavaScript

評分 : 2.5分

下載量 : 12

更新時間 : 2025-04-28

什麼是WhatsApp Business API MCP Server?

這是一箇中間件服務器，簡化了與WhatsApp Business API的交互過程。它提供標準化的接口來處理消息發送、媒體管理、業務資料更新等常見操作，讓開發者無需直接處理複雜的API細節。

如何使用WhatsApp Business API MCP Server?

只需安裝Node.js包，配置您的WhatsApp API憑證，然後就可以通過簡單的命令或API調用來管理WhatsApp業務通訊。

適用場景

適用於企業客戶服務、營銷通知、訂單狀態更新等需要與客戶通過WhatsApp進行溝通的業務場景。特別適合需要批量處理消息或自動化回覆的情況。

主要功能

消息發送支持發送文本、模板、圖片、視頻、文檔、位置等多種類型的消息，並能標記消息為已讀。

媒體管理可以上傳、獲取和刪除媒體文件，方便管理WhatsApp消息中的多媒體內容。

模板管理創建和獲取消息模板，用於標準化業務通訊內容。

業務資料管理查看和更新您的WhatsApp業務資料信息，包括地址、描述和聯繫方式等。

電話號碼管理管理您的WhatsApp業務電話號碼，包括獲取號碼信息和驗證號碼。

Webhook配置設置和管理Webhook，接收WhatsApp事件的即時通知。

優勢與侷限性

優勢

簡化了複雜的WhatsApp Business API交互過程

提供統一的接口處理多種消息類型

支持模板管理，便於標準化業務通訊

易於集成到現有系統中

侷限性

需要WhatsApp Business API的官方授權

某些高級功能可能需要額外的WhatsApp權限

依賴於Node.js運行環境

如何使用

安裝

使用npm或npx安裝服務器包

配置

創建.env文件並添加您的WhatsApp API憑證

運行

啟動服務器，開始使用

使用案例

發送訂單確認通知當客戶下單後，自動發送包含訂單詳情的WhatsApp通知

客戶服務自動回覆設置自動回覆常見問題的模板消息

上傳產品圖片將新產品圖片上傳到WhatsApp服務器，用於後續營銷消息

常見問題

我需要什麼才能使用這個服務器?

如何發送圖片消息?

模板消息和普通文本消息有什麼區別?

如何接收客戶的消息回覆?

服務器支持哪些媒體類型?

🚀 WhatsApp商業API MCP服務器

WhatsApp商業API MCP服務器為開發者提供了便捷的方式來集成和管理WhatsApp商業功能。它支持多種消息類型的發送、媒體文件管理、業務資料更新等功能，幫助企業更好地與客戶進行溝通。

🚀 快速開始

要使用WhatsApp商業API MCP服務器，你需要滿足以下先決條件並完成安裝和配置。

先決條件

Node.js 16或更高版本
WhatsApp商業API憑證：
- API令牌
- 手機號碼ID
- 商業賬戶ID

安裝

你可以通過以下兩種方式進行安裝：

npm install whatsapp-business-mcp-server

或者直接運行：

npx whatsapp-business-mcp-server

配置

創建一個.env文件，包含你的WhatsApp商業API憑證：

WHATSAPP_API_TOKEN=your_api_token_here
WHATSAPP_PHONE_NUMBER_ID=your_phone_number_id_here
WHATSAPP_BUSINESS_ACCOUNT_ID=your_business_account_id_here
WHATSAPP_API_VERSION=v18.0

啟動服務器

啟動服務器的命令如下：

npm start

開發模式

若你處於開發階段，可以使用以下命令：

npm run dev

與MCP Inspector一起使用

npm run inspect

✨ 主要特性

發送各種類型的消息（文本、模板、媒體、互動型）
管理消息模板
上傳和管理媒體文件
更新業務資料信息
管理電話號碼
配置Webhooks

💻 使用示例

基礎用法

以下是一些常用功能的使用示例：

消息發送

// 發送文本消息
const { sendTextMessage } = require('whatsapp-business-mcp-server');
sendTextMessage('recipient_phone_number', 'Hello, World!');

// 發送圖片消息
const { sendImageMessage } = require('whatsapp-business-mcp-server');
sendImageMessage('recipient_phone_number', 'image_url');

媒體管理

// 上傳媒體文件
const { uploadMedia } = require('whatsapp-business-mcp-server');
uploadMedia('media_file_path', 'media_type');

// 獲取媒體文件URL
const { getMediaUrl } = require('whatsapp-business-mcp-server');
getMediaUrl('media_id');

高級用法

模板管理

// 創建新的消息模板
const { createMessageTemplate } = require('whatsapp-business-mcp-server');
createMessageTemplate('template_name', 'template_content', 'category');

業務資料更新

// 更新業務資料
const { updateBusinessProfile } = require('whatsapp-business-mcp-server');
updateBusinessProfile({
  description: 'New business description',
  address: 'New business address'
});