Titanmind Whatsapp MCP

🚀 Titanmind WhatsApp MCP

Titanmindを使用したWhatsAppマーケティングおよびメッセージングツールのMCP（Model Control Protocol）サービスです。自由形式のメッセージ（24時間以内）とテンプレートワークフローを自動的に処理します。

📋 概要

このサービスは、Titanmindを使用してWhatsAppのマーケティングおよびメッセージング機能をすべて提供します。ヘッダー、本文、CTAなどのすべてのコンポーネントを含むテンプレートの作成と登録、電話番号への一括テンプレート配信、アクティブな会話でのメッセージの読み取りと送信などの機能があります。

このMCPはTitanmindを利用しています。このMCPを使用するには、Titanmindアカウントが必要です。

Titanmindは、会話管理、スケジューリング、エージェント型会話、コンテンツ生成などの強力な機能を提供することで、WhatsAppのコミュニケーションを強化します。

✨ 主な機能

会話管理

最近の会話を取得

• 過去24時間以内に送信または受信されたメッセージのあるすべての会話を取得します。
• 最近のアクティビティを含む会話データを返します。

会話メッセージを取得

• 特定の会話からすべてのメッセージを取得します。
• 必要なパラメータ: conversation_id（英数字の会話識別子）

WhatsAppメッセージを送信

• 既存のWhatsApp会話にメッセージを送信します。
• 必要なパラメータ: conversation_id と message 内容

テンプレート管理

メッセージテンプレートを作成

• 承認用に新しいWhatsAppメッセージテンプレートを登録します。
• テンプレート名を設定します（単語、アンダースコアのみ許可）。
• 言語（デフォルト: "en"）とカテゴリ（MARKETING、UTILITY、AUTHENTICATION）を設定します。
• メッセージコンポーネントを構成します。
  • BODY（必須）: メインのテキスト内容
  • HEADER（オプション）: TEXT、VIDEO、IMAGE、またはDOCUMENT形式
  • FOOTER（オプション）: フッターテキスト
  • BUTTONS（オプション）: QUICK_REPLY、URL、またはPHONE_NUMBERアクション

テンプレートを取得

• 承認ステータスを含むすべての作成されたテンプレートを取得します。
• テンプレート名でのオプションのフィルタリングが可能です。

一括メッセージを送信

• 承認されたテンプレートを使用して、複数の電話番号にメッセージを送信します。
• 必要なパラメータ: template_id と連絡先のリスト
• 連絡先の形式: 国コードアルファ（例: "IN"）、国コード（例: "91"）、および電話番号

📦 インストール

前提条件

• Python 3.10以上
• TitanmindからのAPIキーとビジネスコード

MCPクライアントでの使用

ClaudeやCursorなどの任意のMCPクライアントで、Titanmind whatsapp MCPの設定を以下の方法で追加できます。

Titanmind WhatsApp MCP Pythonパッケージを使用する

1. Pythonパッケージをグローバルにインストールするためにpipxをインストールします。

# ターミナル

# まずpipxをインストール
brew install pipx  # macOSの場合
# または
sudo apt install pipx  # Ubuntu/Debianの場合

# 次にTitanmind WhatsApp MCP Pythonパッケージをインストール
pipx install titanmind-whatsapp-mcp

# '/[HOME_DIR_OR_USER_PRFILE]/.local/bin' がPATH環境変数に含まれていることを確認。pipx ensurepathで設定する。
pipx ensurepath 

2. MCPクライアントのMCP設定JSONファイルにMCP設定Pythonパッケージスクリプトを設定します。

{
  "mcpServers": {
    "TitanMindMCP": {
      "command": "/[HOME_DIR_OR_USER_PRFILE]/.local/bin/titan-mind-mcp",
      "args": [
      ],
      "env": {
        "api-key": "XXXXXXXXXXXXXXXXXXXXXXXX",
        "bus-code": "XXXXXX"
      }
    }
  }
}

リモートTitanmind MCPサーバー設定を使用する

1. システムにnpxがインストールされていることを確認します。
2. 次に、MCP設定を追加します。

{
  "mcpServers": {
    "TitanMindMCP": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.titanmind.so/whatsapp/mcp/",
        "--header",
        "api-key:XXXXXXXXXXXXXXXXXXXXXXX",
        "--header",
        "bus-code:XXXXXX"
      ]
    }
  }
}

ローカルPythonプロジェクト設定を使用する

1. まず、「プロジェクトのセットアップ」セクションに記載されている手順を使用してプロジェクトをセットアップします。
2. 次に、MCP設定を追加します。

{
  "mcpServers": {
    "TitanMindMCP": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/[PATH_TO_THE_PROJECT]",
        "python",
        "main.py"
      ],
      "env": {
        "api-key": "XXXXXXXXXXXXXXXXXXXX",
        "bus-code": "XXXXXX"
      }
    }
  }
}

カスタム目的または開発用の手動インストール

PyPIからパッケージをインストールして使用する

pip install titanmind-whatsapp-mcp

または uv を使用します。

uv pip install titanmind-whatsapp-mcp

開発用にプロジェクトをセットアップする

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

git clone https://github.com/TitanmindAGI/titanmind-whatsapp-mcp
cd titanmind-whatsapp-mcp

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

pip install -e .
# または
uv pip install -e .

3. 認証キーを設定します。

export api-key="your-titanmind-api-key"
export bus-code="your-titanmind-business-code"

🔧 動作原理

TitanMindのWhatsAppメッセージングシステムは、タイミングと会話ステータスに基づいて2つの異なるメッセージングモードで動作します。

自由形式メッセージング（24時間以内）

• 利用可能な場合: ユーザーが過去24時間以内にメッセージを送信した後のみ
• コンテンツの自由度: 事前承認なしで任意のコンテンツが許可されます。
• 使用例: 進行中の会話と即時応答

テンプレートメッセージング（24時間を超えた場合）

• 必要な場合: 新しい会話または24時間の期間が経過した場合
• コンテンツの構造: 事前承認された構造化されたメッセージテンプレートのみ
• 使用例: 最初のアウトリーチと再エンゲージメントキャンペーン

📨 メッセージングワークフロープロセス

1. メッセージングウィンドウのステータスを確認する
   • 受信者の電話番号が自由形式メッセージングウィンドウ内にあるかどうかを確認します。
   • 受信者が自由形式メッセージングの対象となる条件は、以下の場合です。
     • その電話番号との会話がすでに存在し、かつ
     • 受信者が過去24時間以内にメッセージを送信した場合
2. メッセージング方法を選択する
   • 自由形式: 24時間以内の場合は直接送信します。
   • テンプレート: 期間を超えた場合は、承認されたテンプレートを登録して使用します。
3. テンプレート承認プロセス（必要な場合）
   • テンプレートをWhatsAppに承認申請します。
   • 承認確認を待ちます。
   • テンプレートが一括メッセージングに使用可能になります。
4. メッセージを送信する
   • 適切な方法を使用してメッセージ配信を実行します。
   • 配信ステータスを監視します。
5. 配信を確認する
   • 会話を確認して、受信者がメッセージを正常に受信したことを確認します。
   • メッセージのステータスとエンゲージメントを追跡します。

💡 使用上の注意

• すべてのツールはTitanmindのWhatsAppチャネルメッセージング機能と統合されています。
• テンプレートは一括メッセージングに使用する前に承認が必要です。
• 詳細なヘルプについては、https://www.titanmind.so/ を通じてお問い合わせください。

📄 ライセンス

MITライセンス - LICENSEファイルを参照してください。