通过GoHighLevel官方API v2，用自然语言管理CRM全功能：联系人、消息、日程、商机、发票、工作流等30+端点组，零依赖Python 3.6+运行。
说明：
## 核心用法
该技能将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版本头需关注弃用通知
