AI导哈

WhatsApp营销消息服务

基于Titanmind的WhatsApp营销和消息服务，提供模板创建、批量发送和会话管理功能，适用于营销活动和客户沟通。

  • by TitanmindAGI
  • Python
  • 本地部署
  • 19 星标
  • 更新于
在 GitHub 查看 titanmindagi/titanmind-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小时内发送了一条消息
  2. 选择消息传递方式
    • 自由形式：如果在24小时窗口内，则直接发送
    • 模板：如果在窗口外，请注册并使用批准的模板
  3. 模板审批流程 （如果需要）
    • 提交WhatsApp审批模板
    • 等待批准确认
    • 模板可用于批量消息传递
  4. 发送消息
    • 使用适当的方法执行消息传递
    • 监控交付状态
  5. 验证交付
    • 检查对话以确认收件人已成功收到消息
    • 跟踪消息状态和参与度

使用说明

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

许可证

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

相关 MCP