核心用法
Jobber skill 提供完整的 GraphQL API 访问能力，用于管理外勤服务业务的各类资源。所有请求通过 https://gateway.maton.ai/jobber/graphql 代理转发，自动处理 OAuth 令牌注入和 API 版本管理。
认证方式：仅需设置 MATON_API_KEY 环境变量，无需直接处理 Jobber OAuth 令牌。Maton 网关负责令牌生命周期管理，支持多连接切换（Maton-Connection 头部指定）。
主要功能模块：
- 客户管理：创建、更新、查询客户信息及联系方式
- 工单管理：创建服务工单、跟踪作业状态、关联客户与物业
- 财务流程：生成报价单（Quote）、创建发票（Invoice）、管理应收款项
- 资产管理：维护物业地址信息、团队成员数据
- 请求处理：处理客户提交的服务请求
技术特性：
- 纯 GraphQL 接口，支持灵活查询字段选择
- Relay 风格游标分页（
first/after参数） - 基于积分的速率限制（10,000 点桶容量，500点/秒恢复）
- Webhook 实时事件通知（含 HMAC-SHA256 签名验证）
显著优点
1. 零 OAuth 复杂度：Maton 托管连接层，用户仅需单一 API 密钥
2. 企业级数据覆盖：完整支持外勤服务业务闭环（客户→报价→工单→发票）
3. GraphQL 灵活性：精确获取所需字段，避免 REST 过度获取
4. 多租户支持：通过 Maton-Connection 头部实现多账户切换
5. 自动版本管理：网关注入最新 API 版本头（2025-04-16），向后兼容 12-18 个月
潜在局限
- GraphQL 学习曲线：需理解查询语法、变量传递、嵌套字段成本
- 积分制速率限制：复杂嵌套查询可能快速消耗额度，需优化查询结构
- 无 REST 回退：纯 GraphQL 设计，不支持传统 REST 接口
- Maton 平台依赖：认证与连接管理完全依赖 Maton 服务可用性
适合人群
- 外勤服务企业管理软件开发者
- 需要集成调度、开票、客户关系管理的自动化工作流构建者
- 熟悉 GraphQL 的中高级开发者
- 希望避免 OAuth 实现复杂度的团队
常规风险
- 令牌集中管理：Maton 网关持有 Jobber OAuth 令牌，存在单点信任风险
- 数据隐私流经第三方：业务数据经 Maton 网关中转，需评估合规性
- 积分耗尽导致中断：高频操作或复杂查询可能触发 429 限流
- 环境变量泄露：
MATON_API_KEY泄露将导致账户级访问权限暴露