Whatsapp MCP Server

🚀 WhatsApp ビジネス API MCP サーバー

WhatsApp ビジネス API を使用したメッセージ送信や管理を行うためのサーバーです。

🚀 クイックスタート

このサーバーを使用することで、WhatsApp ビジネス API を通じて様々なメッセージを送信し、メディアやテンプレートを管理することができます。

✨ 主な機能

• 様々なタイプのメッセージ（テキスト、テンプレート、メディア、インタラクティブ型）を送信する
• メッセージテンプレートを管理する
• メディアファイルをアップロードし、管理する
• ビジネスプロファイル情報を更新する
• 電話番号を管理する
• Webhook を設定する

📦 インストール

以下のコマンドを使用してインストールします。

npm install whatsapp-business-mcp-server

または、直接実行することもできます。

npx whatsapp-business-mcp-server

💻 使用例

基本的な使用法

サーバーの起動

npm start

開発モード

npm run dev

MCP Inspector との連携

npm run inspect

高度な使用法

このサーバーには、様々な機能を提供するツールが用意されています。

メッセージ送信

• sendTextMessage - テキストメッセージを送信する
• sendTemplateMessage - テンプレートメッセージを送信する
• sendImageMessage - 画像を送信する
• sendDocumentMessage - ドキュメントを送信する
• sendVideoMessage - 動画を送信する
• sendLocationMessage - 位置情報を送信する
• sendContactMessage - 連絡先情報を送信する
• sendInteractiveMessage - インタラクティブ型メッセージを送信する
• markMessageAsRead - メッセージを既読にする

メディア管理

• uploadMedia - メディアファイルを WhatsApp サーバーにアップロードする
• getMediaUrl - メディアファイルの URL を取得する
• deleteMedia - メディアファイルを削除する

テンプレート管理

• getMessageTemplates - すべてのメッセージテンプレートを取得する
• createMessageTemplate - 新しいメッセージテンプレートを作成する

ビジネスプロファイル

• getBusinessProfile - ビジネスプロファイル情報を取得する
• updateBusinessProfile - ビジネスプロファイルを更新する

電話番号管理

• getPhoneNumbers - すべての電話番号を取得する
• getPhoneNumberById - 特定の電話番号の詳細情報を取得する
• requestVerificationCode - 検証コードを要求する
• verifyCode - 電話番号を検証する

Webhook 設定

• getWebhookInfo - Webhook の情報を取得する
• subscribeWebhook - Webhook 通知を購読する
• deleteWebhookSubscription - Webhook の購読を削除する

📚 ドキュメント

利用可能なリソース

• whatsapp://templates - すべてのテンプレートを一覧表示する
• whatsapp://templates/{category} - カテゴリ別にテンプレートを一覧表示する
• whatsapp://template/{name} - 特定のテンプレートの詳細情報を取得する
• whatsapp://business-profile - ビジネスプロファイルを表示する
• whatsapp://phone-numbers - すべての電話番号を一覧表示する
• whatsapp://phone-number/{id} - 特定の電話番号の詳細情報を取得する
• whatsapp://docs - API ドキュメント

🔧 技術詳細

前提条件

• Node.js 16 以上のバージョン
• WhatsApp ビジネス API の認証情報：
  • API トークン
  • 電話番号 ID
  • ビジネスアカウント ID

設定

.env ファイルを作成し、以下の情報を記述します。

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

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。