核心用法
Jobber Skill 是面向现场服务企业的全功能业务管理工具，基于托管OAuth与Jobber原生GraphQL API深度集成。核心能力覆盖六大业务域：
客户管理：创建、更新客户档案，维护联系方式与账单地址
工单调度：创建服务工单、分配任务、跟踪执行状态
财务流程：生成报价单、开具发票、追踪应收账款
资产管理：登记服务物业地址，关联客户与服务历史
团队协作：查询团队成员信息，支持多账户连接管理
实时通知：通过Webhook接收客户创建、工单完成、报价批准等事件
所有请求统一指向 https://gateway.maton.ai/jobber/graphql，由Maton网关自动注入OAuth令牌与API版本头（当前2025-04-16），开发者仅需管理单一MATON_API_KEY。
显著优点
- 零OAuth维护成本：托管模式消除令牌刷新、密钥轮换的运维负担
- GraphQL灵活查询：单次请求精准获取嵌套数据，减少往返次数
- 企业级安全：Webhook带HMAC-SHA256签名验证，传输层TLS加密
- 多租户支持：通过
Maton-Connection头切换多个Jobber账户连接 - 智能限流：基于查询复杂度的积分桶算法，非简单请求数限制
潜在局限
- GraphQL学习曲线：需理解Relay分页、EncodedId编码、嵌套查询成本计算
- 版本绑定：网关强制注入API版本，自定义Header会被覆盖
- 无REST降级：纯GraphQL架构，调试工具链依赖GraphiQL
- 环境变量敏感：密钥在shell管道中可能解析异常，需特别注意
适合人群
- 保洁、园艺、维修等现场服务企业的技术团队
- 需要批量同步Jobber数据至内部ERP/BIM系统的集成开发者
- 构建客户门户、工程师移动App的SaaS创业者
常规风险
数据级风险：OAuth令牌由Maton托管，需信任第三方密钥保管；Webhook端点若未验证签名易遭伪造攻击。
运维级风险：查询深度过大会快速消耗10,000积分限额；多连接场景下未指定Maton-Connection头可能路由至错误账户。
合规级风险：客户PII数据跨境传输需确认Jobber数据驻留政策与本地隐私法规（如GDPR、CCPA）的符合性。