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ファイルを参照してください