Titan Mind Whatsapp MCP

Titanmind WhatsApp MCP

WhatsApp营销和消息工具MCP（模型控制协议）服务使用 泰坦精神.自动处理自由格式的消息（24小时窗口）和模板工作流

概述

此服务使用Titanmind提供所有WhatsApp营销和消息功能。包括模板创建和注册等功能，包括所有组件的标题、正文、CTA。.，模板批量广播到电话号码。在活跃的对话中阅读和发送消息。

此MCP使用Titanmind。使用此MCP需要Titanmind帐户。 Titanmind通过提供强大的功能来增强WhatsApp的通信，例如 会话管理、日程安排、代理会话、内容生成等。

特性

会话管理

获取最近的对话

• 检索过去24小时内发送或接收的所有消息对话
• 返回最近活动的对话数据

获取对话消息

• 从特定对话中获取所有消息
• 要求： conversation_id （字母数字对话标识符）

发送WhatsApp消息

• 向现有的WhatsApp对话发送消息
• 要求： conversation_id 和 message 内容

模板管理

创建消息模板

• 注册新的WhatsApp消息模板以供审批
• 配置模板名称（单个单词，只允许使用下划线）
• 设置语言（默认：“en”）和类别（营销、实用程序、认证）
• 结构消息组件包括：

- 身体 （必填）：正文内容 - 页眉 （可选）：文本、视频、图像或文档格式 - 页脚 （可选）：页脚文本 - 按钮 （可选）：QUICK_REPLY、URL或PHONE_NUMBER操作

获取模板

• 检索所有已创建的具有审批状态的模板
• 可选按模板名称筛选

发送批量消息

• 使用批准的模板向多个电话号码发送消息
• 要求： template_id 以及联系人列表
• 联系方式：国家代码字母（例如“IN”）、国家代码（例如“91”）和电话号码

安装

先决条件

• Python 3.10或更高版本
• 来自的API密钥和业务代码 泰坦精神

使用MCP客户端

在任何MCP客户端（如Claude或Cursor）中，可以通过以下方式添加Titanmind whatsapp MCP配置：

使用 Titanmind WhatsApp MCP Python包

1.安装pipx以全局安装python包

# terminal

# Install pipx first
brew install pipx  # on macOS
# or
sudo apt install pipx  # on Ubuntu/Debian

# Then install Titanmind WhatsApp MCP Python package 
pipx install titanmind-whatsapp-mcp

# Make sure '/[HOME_DIR_OR_USER_PRFILE]/.local/bin' is on your PATH environment variable. Use pipx ensurepath to set it.
pipx ensurepath 
 

2.在MCP客户端的MCP Configs Json文件中设置MCP Config 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 .
# Or
uv pip install -e .

3.设置身份验证密钥

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

原理

TitanMind的WhatsApp消息系统根据时间和对话状态在两种不同的消息模式下运行：

免费消息（24小时窗口）

• 可用时：只有在用户在过去24小时内发送了消息后
• 内容自由：未经事先批准，任何内容都是允许的
• 用例：持续对话和即时响应

模板消息（24小时窗口外）

• 需要时：用于新对话或24小时窗口已过
• 内容结构：仅限预先批准的结构化消息模板
• 用例：初步外联和重新参与活动

消息传递工作流流程

1. 检查消息窗口状态

- 验证接收者的电话号码是否在自由格式的消息窗口内 - 在以下情况下，接收者有资格进行自由形式的消息传递： - 与他们的电话号码的对话已存在，并且 - 接收者在过去24小时内发送了一条消息

1. 选择消息传递方式

- 自由形式：如果在24小时窗口内，则直接发送 - 模板：如果在窗口外，请注册并使用批准的模板

1. 模板审批流程 （如果需要）

- 提交WhatsApp审批模板 - 等待批准确认 - 模板可用于批量消息传递

1. 发送消息

- 使用适当的方法执行消息传递 - 监控交付状态

1. 验证交付

- 检查对话以确认收件人已成功收到消息 - 跟踪消息状态和参与度

使用说明

• 所有工具均与Titanmind的WhatsApp频道消息功能集成
• 模板在用于批量消息传递之前需要获得批准
• 如需更多帮助，请通过以下方式联系我们 https://www.titanmind.so/

许可证

MIT许可证-请参阅许可证文件