--- slug: gif-whatsapp-tool-pro name: gif-whatsapp-tool-pro version: 1.0.0 displayName: WhatsApp表情专业版 summary: 企业级 WhatsApp GIF 管理工具，支持批量发送、定时任务、GIF 库管理、多账号与营销分析，适合团队协作与营销场景. license: Proprietary edition: pro description: "企业级 WhatsApp GIF 管理工具，支持批量发送、定时任务、GIF 库管理、多账号与营销分析。Use when 需要项目管理、任务规划、进度跟踪、团队协作时使用。不适用于实际人员绩效评估。Use when 需要项目管理、任务规划、进度跟踪、团队协作时使用。不适用于实际人员绩效评估。减少重复劳动，提升工作效率。触发关键词：API设计、自动化、搜索、转换、项目管理、品牌" when 需要项目管理、任务规划、进度跟踪、团队协作时使用。不适用于实际人员绩效评估. tags: - WhatsApp - GIF - 营销工具 - 批量发送 - 企业通讯 - 搜索 - 检索 - 工具 - gif - python tools: - read - exec - glob - grep homepage: "" # 定价元数据 category: "Knowledge" --- # WhatsApp 表情专业版 ## 概述 WhatsApp 表情专业版是面向企业用户和营销团队的进阶 GIF 管理工具。在免费版基础搜索发送能力之上，新增批量群发、定时任务、GIF 库管理、多账号支持与效果分析等高级功能，助力企业通过 WhatsApp 进行高效的客户沟通与营销推广。与免费版完全兼容，已有工作流可无缝升级. ## 核心能力 ### 功能对比 | 能力 | 免费版 | PRO 版 | |---|---|-----| | GIF 搜索 | 单次 5 个结果 | 单次 20 个结果 | | 格式转换 | GIF 转 MP4 | GIF 转 MP4 + 水印 | | 发送方式 | 单人单发 | 批量群发 | | 自定义字幕 | 否 | 是 | | 定时发送 | 否 | Cron 调度 | | GIF 库管理 | 否 | 标签分类管理 | | 多账号 | 否 | 支持多账号 | | 效果分析 | 否 | 发送统计报告 | | 品牌水印 | 否 | 自定义水印 | | API 接口 | 否 | REST API | | 优先支持 | 社区 | 优先响应 | **输入**: 用户提供功能对比所需的指令和必要参数. **处理**: 解析功能对比的输入参数,完成核心逻辑,返回结构化响应. **输出**: 返回功能对比的响应数据,包含状态码、结果和日志. ### PRO 版独有功能 #### 1. 批量群发引擎 ```bash python （请参考skill目录中的脚本文件） \ --gif-library ./gifs/celebration.mp4 \ --contacts contacts.csv \ --message "节日快乐" \ --delay 5 ``` 支持从 CSV 导入联系人列表，批量发送相同或不同的 GIF，自动控制发送频率避免限制. #### 2. 定时任务调度 ```bash # 定时发送节日祝福 python （请参考skill目录中的脚本文件） \ --gif ./gifs/newyear.mp4 \ --contacts customer_list.csv \ --cron="0 0 1 1 *" \ --message "新年快乐！感谢您一年的支持" ``` #### 3. GIF 库管理 ```bash # 添加 GIF 到收藏库 python （请参考skill目录中的脚本文件） add ./gifs/thanks.mp4 \ --tags="感谢,客户关怀" \ --category="客户服务" # ... # 搜索库中的 GIF python （请参考skill目录中的脚本文件） search --tag="感谢" --category="客户服务" # ... # 查看库统计 python （请参考skill目录中的脚本文件） stats ``` #### 4. 品牌水印 ```bash # 为 GIF 添加品牌水印 python （请参考skill目录中的脚本文件） \ --input ./gifs/original.mp4 \ --output ./gifs/branded.mp4 \ --logo ./assets/logo.png \ --position bottom-right \ --opacity 0.8 ``` **输入**: 用户提供PRO 版独有功能所需的指令和必要参数. **处理**: 解析PRO 版独有功能的输入参数,完成核心逻辑,返回结构化响应. **输出**: 返回PRO 版独有功能的响应数据,包含状态码、结果和日志. - 执行此能力时使用`input_params`参数,支持创建/查询/导出操作 ### 核心功能执行 用`input_params`参数进行配置. **输入**: 用户提供核心功能执行所需的指令和必要参数. **处理**: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应. **输出**: 返回核心功能执行的响应数据,包含状态码、结果和日志. - 执行此能力时使用`input_params`参数,支持创建/查询/导出操作 **能力覆盖范围**：本skill的核心能力覆盖以下场景关键词：企业级、WhatsApp、管理工具、支持批量发送、多账号与营销分析、适合团队协作与营、销场景、Use、when、需要项目管理、任务规划、进度跟踪、团队协作时使用、不适用于实际人员、绩效评估、适用于独立开发者、企业团队和自动化、工作流场景等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持. ## 使用场景 ### 场景一：企业节日营销活动 营销团队需要在节日期间向所有客户发送祝福 GIF. ```bash # 准备客户联系人列表 cat > customers.csv < test_contacts.csv # ... # 执行测试发送 python （请参考skill目录中的脚本文件） \ --gif ./gifs/welcome.mp4 \ --contacts test_contacts.csv \ --message "测试发送" \ --delay 5 ``` **响应解析**: 完成完成后,查看输出响应确认任务状态。成功时输出包含解析摘要和响应数据;失败时根据错误信息排查问题,查阅错误解析章节获取恢复步骤. ## 示例 ### 企业级配置文件 ```yaml # config.yaml - PRO 版企业配置 whatsapp: default_account: main accounts: main: name: 主账号 phone: "+8613800000000" service: name: 客服账号 phone: "+8613800001111" # ... sending: batch_size: 100 delay_between_sends: 10 max_daily_sends: 500 retry_on_failure: true retry_count: 3 # ... gif_library: storage: ./gif_library categories: - 客户服务 - 节日祝福 - 产品推广 - 日常沟通 auto_tag: true # ... watermark: enabled: true logo: ./assets/logo.png position: bottom-right opacity: 0.8 # ... analytics: enabled: true storage: ./analytics report_frequency: weekly ``` ### 参数说明 | 参数 | 类型 | 默认值 | 范围 | 说明 | |:-----|:-----|:-----|:-----|:-----| | `--gif` | 字符串 | 无 | 路径 | GIF/MP4 文件路径 | | `--contacts` | 字符串 | 无 | CSV 路径 | 联系人列表 | | `--message` | 字符串 | 空格 | 文本 | 自定义消息 | | `--delay` | 整数 | 5 | 1-60 | 发送间隔秒数 | | `--cron` | 字符串 | 无 | Cron 表达式 | 定时任务 | | `--watermark` | 布尔 | true | true/false | 启用水印 | | `--export` | 字符串 | json | json/csv | 报告格式 | | `--account` | 字符串 | main | 账号名 | 指定发送账号 | | `--split` | 整数 | 100 | 1-100 | 账号分流百分比 | ## 最佳实践 ### 批量发送优化 ```python # batch_config.py - 批量发送配置 from batch_send import BatchSendConfig # ... config = BatchSendConfig( batch_size=50, delay_between_sends=10, max_daily_sends=200, retry_on_failure=True, retry_count=3, watermark_enabled=True, custom_message=True, track_delivery=True ) # ... # 执行批量发送 results = config.execute( gif_path="./gifs/promotion.mp4", contacts="customers.csv" ) ``` ### GIF 库分类管理 ```bash # 按场景分类管理 GIF python （请参考skill目录中的脚本文件） organize \ --auto-classify \ --tags-from-filename # ... # 创建标签体系 python （请参考skill目录中的脚本文件） tags add \ --tag="高优先级" \ --description="重要客户使用" # ... # 智能推荐 python （请参考skill目录中的脚本文件） recommend \ --context="客户感谢" \ --limit 5 ``` ### 营销效果分析 ```bash # 生成发送效果报告 python （请参考skill目录中的脚本文件） \ --period="2026-01" \ --output=monthly_report.md # ... # 查看发送统计 python （请参考skill目录中的脚本文件） stats \ --metric=delivery_rate \ --period=weekly # ... # 导出详细数据 python （请参考skill目录中的脚本文件） export \ --format=csv \ --output=detailed_stats.csv ``` ## 常见问题 ### 已知限制 ```bash # 增加发送间隔 python （请参考skill目录中的脚本文件） --delay 30 contacts.csv # ... # 减少每日发送量 python （请参考skill目录中的脚本文件） --max-daily=100 contacts.csv # ... # 使用多账号分流 python （请参考skill目录中的脚本文件） --split 50 --account=all contacts.csv ``` ### GIF 水印添加失败 ```bash # 检查水印图片格式 file ./assets/logo.png # ... # 确保图片为 PNG 透明背景 python （请参考skill目录中的脚本文件） --validate-logo ./assets/logo.png # ... # 调整水印参数 python （请参考skill目录中的脚本文件） \ --input input.mp4 \ --output output.mp4 \ --logo logo.png \ --opacity 0.5 ``` ### 定时任务不执行 ```bash # 检查任务列表 python （请参考skill目录中的脚本文件） --list # ... # 查看任务日志 cat ./logs/scheduled_send.log # ... # 手动触发测试 python （请参考skill目录中的脚本文件） --run-now --task-id=task_001 ``` ## 依赖说明 ### 运行环境 - **Agent 平台**：支持 SKILL.md 的任意 AI Agent（Claude Code / Cursor / Codex / Gemini CLI 等） - **操作系统**：Windows / macOS / Linux - **网络环境**：需可访问 Tenor、Giphy 和 WhatsApp 服务 - **推荐配置**：4 核 CPU、8GB 内存、20GB 磁盘空间（GIF 库存储） ### 第三方依赖 | 依赖项 | 类型 | 是否必需 | 获取方式 | |---:|---:|---:|---:| | gifgrep | CLI 工具 | 是 | 参考官方文档安装 | | ffmpeg | 多媒体处理 | 是 | `brew install ffmpeg` 或 `apt install ffmpeg` | | curl | 文件下载 | 是 | 系统自带 | | pandas | 数据处理 | 否（推荐） | `pip install pandas` | | schedule | 定时任务 | 否（推荐） | `pip install schedule` | | pillow | 图片处理 | 否（推荐） | `pip install pillow` | | WhatsApp message 工具 | 发送服务 | 是 | 平台内置 | | LLM API | API | 是 | 由 Agent 内置 LLM 提供 | ### API Key 配置 - PRO 版核心功能无需额外 API Key - 如需启用高级分析，配置数据库连接： ```bash export DB_HOST=localhost export DB_PORT=5432 export DB_NAME=whatsapp_analytics export DB_USER=admin export DB_PASSWORD=your_password ``` ### 可用性分类 - **分类**：MD+EXEC（纯 Markdown 指令，部分功能需要 exec 命令行执行能力） - **说明**：基于 Markdown 的 AI Skill，通过自然语言指令驱动 Agent 执行任务 - **适用人群**：企业营销团队、客服团队、社交媒体运营人员 - **兼容性**：与免费版完全兼容，配置可无缝迁移 - **支持方式**：优先响应技术工单 ## 错误处理 | 错误场景 | 原因 | 处理方式 | |:---:|:---:|:---:| | 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 | | 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 | | 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案 | ## 输出格式 ```json { "success": true, "data": { "result": "WhatsApp表情专业版处理结果", "execution_time": "0.5s", "metadata": { "version": "1.0", "processor": "gif whatsapp pro" } }, "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"], "error": null } ```