SuperAPI AI 工具集

service-omni-queue-routing-config-deploy

部署与运维

查看项目

更新于 10-16 08:47

技能介绍

用途:在 Salesforce 组织上创建或更新 QueueRoutingConfig 记录,该记录定义 Omni-Channel 如何将工作分发给队列坐席,包括路由模型、每个工作项消耗的容量、推送超时和路由优先级。它是 Omni 路由队列的前置条件,service-omni-queue-deploy 会用本技能返回的配置 Id 绑定队列。

主要能力:幂等的 detect → upsert → verify 流程,按 DeveloperName 查询检测,无记录则 POST,字段全部匹配则复用,有差异则 PATCH,写入后重新查询确认。支持 MostAvailable(轮询式)与 LeastActive(负载均衡)两种路由模型;容量可选用 CapacityWeight 或 CapacityPercentage(二者互斥,切换时清除旧字段);支持 OverflowAssigneeId(队列成员均不可用时的兜底坐席,写入前解析为活跃用户 Id)与推送超时。默认命名由路由目标派生,如 Case_Routing_Config、Voice_Routing_Config,避免重复创建。

使用方式:脚本调用格式为 bash scripts/upsert-and-report.sh <org-alias> [routing-model] [developer-name] [master-label] [capacity-weight] [routing-priority] [overflow-assignee] [push-timeout]。参数也可通过环境变量提供,如 QRC_DEVELOPER_NAME、QRC_MASTER_LABEL、QRC_CAPACITY_WEIGHT、QRC_ROUTING_PRIORITY、QRC_CAPACITY_PERCENTAGE、QRC_OVERFLOW_ASSIGNEE、QRC_PUSH_TIMEOUT、QRC_ROUTING_TARGET(Case | VoiceCall | Incident | MessagingSession)。

适用场景:为 Omni 路由队列准备或对齐路由配置,统一命名与字段,处理溢出路由,重复执行以收敛状态。前提包括目标组织已通过 sf CLI 认证、拥有 Service Cloud 许可、sf CLI ≥ 2.139.6、已启用 Omni-Channel 基础设置,并受生产环境写入保护约束。输出为单个 JSON 对象,status 取 created、reused、updated 或 blocked。

限制:不支持基于属性的路由(IsAttributeBased=true 超出范围,需额外属性架构);v66 仅支持 MostAvailable 与 LeastActive;v66 中按渠道的容量加权已弃用;技能不会删除 QueueRoutingConfig,只会 PATCH 对齐。具体定价、部署时长等资料暂未提供。