核心用法
该技能将AI助手转化为GoHighLevel CRM的中央控制台，覆盖39个API v2端点组的核心操作。用户可通过自然语言指令完成联系人管理（搜索、创建、更新、标签）、全渠道消息发送（SMS/邮件/WhatsApp/FB/IG/聊天）、日程预约管理、销售管道跟踪、发票与支付处理、工作流自动化触发等。内置scripts/ghl-api.py辅助脚本提供100+预构建安全命令，支持分页、重试逻辑和输入验证。
部署采用零依赖设计：仅需Python 3.6+标准库（urllib、json、os等），无需pip install。通过两个环境变量HIGHLEVEL_TOKEN（Private Integration令牌）和HIGHLEVEL_LOCATION_ID（子账户位置ID）完成认证。提供交互式设置向导（/highlevel-setup）自动检测环境变量、引导创建Private Integration并测试连接。
显著优点
- 零外部依赖：纯标准库实现，无供应链攻击风险，部署极简
- 安全设计严格：预定义端点路径，禁止任意HTTP请求；所有用户ID经
^[a-zA-Z0-9_-]{1,128}$正则验证，防范路径遍历和注入；仅用urllib.request，无shell命令或外部二进制调用 - 权限最小化：支持按用例精细授权（联系人只读、消息、完整CRM等），可随时调整范围而无需重新生成令牌
- 多层级架构：子账户集成（推荐单客户场景）与机构级集成（多地点管理）灵活切换
- 官方API对齐：完整覆盖GHL API v2，包括实验性功能如Voice AI、AI Agent Studio、Custom Objects等
潜在缺点与局限性
- 认证门槛：需手动创建Private Integration并复制一次性令牌，对非技术用户存在学习曲线
- 速率限制约束：每位置100请求/10秒突发、20万/天上限；SaaS端点全球10 req/sec，大规模数据同步需实现分页和节流
- 功能边界：不包含Webhook接收服务器（需外部配置），Conversation AI等部分端点无明确scope前缀
- 令牌管理：90天无使用自动过期，需主动轮换；OAuth令牌仅限Marketplace应用使用
- $497 Agency Pro计划限制：SaaS配置器、Snapshots、完整机构管理API需付费升级
适合人群
- 数字营销机构运营者需自动化客户CRM操作
- 销售团队寻求AI辅助的线索跟进、预约调度、管道更新
- 技术型创始人构建无代码/低代码GHL集成工作流
- 已有GHL子账户、愿配置Private Integration的中高级用户
常规风险
- 令牌泄露：
HIGHLEVEL_TOKEN为Bearer令牌，若泄露可导致完整API权限被滥用；建议存储于安全环境变量或密钥管理器 - 数据过度暴露：机构级令牌可跨子账户访问，需严格遵循最小权限原则
- 速率限制触发：批量操作未加节流可能导致服务临时拒绝
- API变更：GHL v2 API持续演进，2021-07-28版本头需关注弃用通知