Whatsapp Bot MCP

🚀 NiagaBot - スマートなWhatsAppビジネス自動化ツール

NiagaBot は、AI Qwen3-Omniを使用したスマートなWhatsAppビジネス自動化ボットです。このボットは、ビジネスコミュニケーションの自動化、ブロードキャスト、メッセージのスケジューリング、自動返信など、様々な機能を提供します！

高度なAIによるスマートなビジネス自動化コンパニオン

✨ 主な機能

🤖 AIによるスマート自動化

• マルチモーダルAI：Qwen3-Omniを使用して、テキスト、画像、音声、ビデオを処理します。
• スマート自動返信：顧客のメッセージに自動的に返信します。
• チャットフロービルダー：カスタマーサービスの会話フローを構築します。

📣 ブロードキャストとマーケティング

• 大量ブロードキャスト：多数の顧客に同時にメッセージを送信します。
• スケジュール済みメッセージ：後で送信するメッセージをスケジュールします。
• 進捗追跡：リアルタイムで送信ステータスを監視します。

👥 グループ管理

• 歓迎/別れのメッセージ：新しいメンバーを自動的に歓迎します。
• スパム対策：グループをクリーンで安全に保ちます。
• グループ同期：複数のグループを簡単に管理します。

📊 分析とレポート

• 総合ダッシュボード：ボットのすべてのアクティビティを監視します。
• 統計と指標：メッセージとブロードキャストのパフォーマンスを分析します。
• データエクスポート：分析データをCSV/JSON形式でエクスポートします。

🔐 エンタープライズ機能

• マルチユーザーサポート：ロールベースのアクセスによるチームコラボレーション。
• REST API：他のシステムとの統合が可能です。
• Webダッシュボード：美しく使いやすいコントロールパネル。
• セキュアな認証：JWTベースのセキュリティ。

アーキテクチャ

WhatsApp Web (ブラウザ自動化)
          ↓
   WhatsApp Bot Core
          ↓
  Qwen3-Omni統合
    ↙              ↘
ローカルモデル    DashScope API

前提条件

• Node.js (v16以上)
• npmまたはyarn
• テスト用のWhatsAppアカウント
• (オプション) クラウドベースのQwen3-Omniアクセス用のDashScope APIキー

📦 インストール

1. リポジトリをクローンします：

git clone <repository-url>
cd whatsapp-bot-mcp

2. 依存関係をインストールします：

npm install

設定

ボットは2つの方法で設定できます：

オプション1: ローカルモデル (リソースを大量に消費)

ローカルでQwen3-Omniを実行するには、以下が必要です：

• ハイエンドGPU (VRAM 32GB以上を推奨)
• 大量のRAM (64GB以上を推奨)
• 必要な依存関係がインストールされた適切なPython環境

このオプションでは、サイズと複雑さのためにこのパッケージに含まれていない追加の依存関係をインストールする必要があります。

オプション2: Alibaba Cloud/DashScope API (ほとんどのユーザーに推奨)

これは、ハイエンドのハードウェアを必要とせずにQwen3-Omniを使用する最も簡単な方法です：

オプションA: DashScope経由 (簡単なバージョン)

1. DashScopeにアカウントを登録します。
2. ダッシュボードからAPIキーを取得します：
   • DashScopeコンソールにアクセスします。
   • "API Keys"セクションに移動します。
   • 新しいAPIキーを作成するか、既存のものを使用します。
3. config.jsonを更新します：

{
  "dashscope": {
    "enabled": true,
    "apiKey": "ここにあなたのAPIキーを入力",
    "model": "qwen3-omni"
  }
}

オプションB: Alibaba Cloud経由 (エンタープライズユーザー向け)

1. Alibaba Cloudにアカウントを登録します。
2. DashScopeまたはModelStudioサービスを有効にします。
3. Alibaba Cloudコンソールを通じてアクセスキーを取得します。
4. 適切なAPIエンドポイントを使用します：

{
  "dashscope": {
    "enabled": true,
    "apiKey": "ここにあなたのアクセスキーを入力",
    "model": "qwen3-omni",
    "apiEndpoint": "https://dashscope.aliyuncs.com/api/v1"
  }
}

APIキーの取得方法:

1. アカウントを登録します:

   • DashScopeの場合: dashscope.aliyuncs.com
   • Alibaba Cloud (グローバル)の場合: Alibaba Cloud

2. APIキーを取得します:

   • DashScopeコンソールにアクセスします。
   • "API Keys"セクションに移動します。
   • 新しいAPIキーを作成するか、既存のものを使用します。
   • 設定で使用するためにAPIキーをコピーします。

3. APIキーの安全な保管 (推奨): 設定ファイルにAPIキーをハードコーディングする代わりに、環境変数を使用します。

   # 環境変数を設定する (Linux/Mac)
   export DASHSCOPE_API_KEY="ここにあなたのAPIキーを入力"
   
   # 環境変数を設定する (Windows)
   set DASHSCOPE_API_KEY="ここにあなたのAPIキーを入力"
   
   # または、プロジェクトディレクトリに.envファイルを作成します
   echo "DASHSCOPE_API_KEY=ここにあなたのAPIキーを入力" > .env
   

   次に、config.jsonで参照します：

   {
     "dashscope": {
       "enabled": true,
       "apiKey": null,
       "model": "qwen3-omni"
     }
   }
   

あるいは、サンプル構成ファイルをコピーして編集することもできます：

cp config.example.json config.json
# 次に、config.jsonをあなたのAPIキーで編集します

無料枠と価格:

• DashScopeは、開始時に無料のクォータを提供します。
• より高い使用要件には従量制の課金が適用されます。
• 現在の料金については、DashScopeの価格ページを確認してください。

セキュリティのベストプラクティス

DashScope APIを使用する際は、以下のセキュリティのベストプラクティスに従ってください：

1. APIキーをバージョン管理システムにコミットしないでください

   • .envとconfig.jsonを.gitignoreファイルに追加します。
   • ハードコードされたキーの代わりに環境変数を使用します。

2. APIキーに環境変数を使用する

   # .envファイルを作成する
   echo "DASHSCOPE_API_KEY=ここにあなたのAPIキーを入力" > .env
   
   # .gitignoreに追加する
   echo ".env" >> .gitignore
   

3. APIキーの権限を制限する

   • 必要最小限の権限でキーを作成します。
   • 異なる環境 (開発、ステージング、本番) で異なるキーを使用します。

4. APIの使用状況を監視する

   • DashScopeコンソールで定期的に使用状況を確認します。
   • 異常なアクティビティや使用量の急増に対してアラートを設定します。

5. 定期的にキーをローテーションする

   • 定期的にAPIキーを変更します。
   • 侵害されたキーはすぐにローテーションします。

💻 使用例

1. ボットを起動します：

npm start

2. WhatsAppモバイルアプリでQRコードをスキャンしてログインします。

3. ボットがメッセージを監視し、Qwen3-Omniを使用して応答を開始します。

動作原理

1. メッセージ監視：ボットはWhatsApp Webで新しいメッセージを継続的にチェックします。
2. メッセージ処理：受信したメッセージ (テキストまたはメディア) はQwen3-Omniによって処理されます。
3. 応答生成：Qwen3-Omniは入力に基づいて適切な応答を生成します。
4. 応答送信：応答はWhatsApp Webを通じて返信されます。

Qwen3-Omniの機能

Qwen3-Omniは、以下を含む高度なマルチモーダル処理を提供します：

• テキスト理解：複数の言語のテキストメッセージを処理し、応答します。
• 画像分析：画像を分析し、視覚的なコンテンツに応答します。
• 音声処理：音声メッセージを文字起こしし、理解します。
• ビデオ理解：視覚と音声の分析を行い、ビデオコンテンツを処理します。
• マルチモーダル推論：複数のモダリティからの情報を組み合わせて包括的な理解を行います。
• リアルタイムインタラクション：テキストと自然な音声の両方で応答をストリーミングします。
• 多言語サポート：119のテキスト言語、19の音声入力言語、10の音声出力言語をサポートします。

サポートされるモダリティ

1. テキスト：自然言語のクエリ、会話、およびドキュメント分析を処理します。
2. 画像：オブジェクト、シーン、テキスト (OCR)、および視覚要素を認識します。
3. 音声：音声認識、音楽分析、音声分類、および音声キャプションを行います。
4. ビデオ：ビデオの説明、シーン分析、および視聴覚理解を行います。

音声オプション

音声生成機能を使用する場合、Qwen3-Omniは複数の音声オプションをサポートします：

• Ethan：明るく元気な男性の声で、感染力があります。
• Chelsie：甘く柔らかい女性の声で、優しさがあります。
• Aiden：暖かくのんびりした男性の声で、少年っぽい魅力があります。

コントリビューション

コントリビューションは大歓迎です！プルリクエストを送信してください。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています - 詳細についてはLICENSEファイルを参照してください。

謝辞

• 通義LabによるQwen3-Omni
• クラウドベースのAIアクセス用のDashScope API
• ブラウザ自動化用のPlaywright/Puppeteer
• ツール統合用のModel Context Protocol

Alibaba Cloud/DashScopeを使用する利点

Qwen3-OmniへのアクセスにAlibaba CloudまたはDashScopeを使用する詳細な利点を参照してください。