用途:在 Salesforce 的 Employee Service(ITSM)中启用 Salesforce Go 功能 service-cloud-swarming(Swarming),让服务人员实时拉入合适的协作者与领域专家处理事件。所有操作经 headless-360 派发;每步都是真实、会改变状态的 API 调用,需一次执行一步、确认成功后再继续。
主要能力与用法:步骤1,用 POST /services/data/v67.0/connect/setup/discovery/features/status,body {"featureApiNames": ["service-cloud-swarming"]} 查状态(该接口仅支持 POST,GET 会返回 405)。若已 ENABLED 则跳到验证;若 enableBlockedReasons 非空,先告知用户。步骤2,POST /services/data/v67.0/connect/setup/discovery/feature/service-cloud-swarming/enable,body {}。步骤3,重新查状态,期望 ENABLED。步骤4,只读 GET /services/data/v67.0/setup/org/values/SWARM_COLLABORATION_TOOL 查看协作工具,stringValue 为 None、Slack 或 Teams。步骤5,PATCH 同一 URL,body {"orgValue": "Teams"},再 GET 确认。步骤6,汇报功能状态与组织值。禁用时 POST .../disable,之后重查;可选把组织值重置为 None。
限制:Swarming 需先配置 Teams(service-itsm-teams-configure)。协作工具设置写入的是 SWARM_COLLABORATION_TOOL,valueName 必须是精确的 Java 枚举常量 SCREAMING_SNAKE_CASE(写错成 camelCase 会返回 400)。headless-360 不解析 API 版本,必须带完整 /services/data/vXX.0/ 前缀。swarming-connect-api 与本技能范围无关。