核心能力
GoHighLevel API Skill 是一款面向 CRM 自动化的高级集成工具，将 Claude 转化为可直接操控 GHL 平台的自然语言控制中心。该技能覆盖官方 API v2 全部 39 个端点群，支持从基础联系人管理到复杂 SaaS 配置的全栈操作。
核心用法：用户通过自然语言指令完成 CRM 操作——搜索联系人、发送多渠道消息（SMS/邮件/WhatsApp/社交）、预约管理、管道跟进、发票生成、社交内容排期等。内置 ghl-api.py 辅助脚本提供标准命令封装，同时通过 custom_request 开放底层 API 访问，兼顾便捷性与灵活性。
显著优点：
- 端点覆盖极广：39 个 API 群包含 contacts、conversations、calendars、opportunities、invoices、payments、workflows、social-planner、voice-ai 等，基本涵盖中小型企业 CRM 全部场景
- 认证机制现代化：采用 Private Integration（私有集成）替代已废弃的 API Keys，支持精细化 scope 授权，安全性优于传统密钥模式
- 多层级架构支持：区分 Agency（代理）与 Sub-Account（子账户）两种集成层级，前者可跨多 location 管理，后者专注单一客户，适配 SaaS 分销商与终端用户的不同需求
- 交互式设置向导：自动检测环境变量、引导创建 Private Integration、验证连接并拉取测试数据，显著降低冷启动门槛
潜在局限与风险：
- 成本门槛：完整功能需 GHL Agency Pro 计划（$497），SaaS Configurator、Snapshots、完整代理管理 API 等高级功能受限
- 速率限制：单 location 100 请求/10秒突发 + 20万/天，SaaS 端点全局 10 req/s，大规模数据同步需实现分页与重试逻辑
- Token 管理复杂度：Private Integration Token 仅显示一次，90 天轮换机制要求运维关注，OAuth 模式（市场应用）的 access token 24 小时过期需刷新机制
- 权限边界模糊：部分端点（如 AI Agent Studio、Conversation AI、Knowledge Base）文档中未标注 scope，实际可用性需测试验证
适合人群：数字营销机构、SaaS 分销商、销售运营团队、寻求 CRM 自动化的中小企业主，以及需要将 AI 对话能力与现有 GHL 基础设施深度绑定的开发者。
常规风险：API 调用涉及客户 PII 数据（联系人、对话记录、支付信息），需确保 token 存储安全（建议密钥管理服务）；错误操作可能导致数据覆盖（如批量更新联系人）或工作流误触发；Webhook 配置独立需额外关注事件订阅安全。