service-omni-channel-inventory-analyze

service-omni-channel-inventory-analyze

读取组织完整的 Omni-Channel 设置首页清单，不进行任何更改。受支持的无头操作会整合语音、电子邮件、实时聊天和消息渠道系列，并返回其派生的路由类型和路由目标。在更改陌生组织的设置之前，或用户询问已配置哪些 Omni 渠道及路由时，请使用此分析器。

输入

bash scripts/analyze.sh <org-alias> [--type Voice|Email|Chat|SMS|Facebook|WhatsApp|InApp]

• org-alias 为必填项，且必须已通过 Salesforce CLI 完成身份验证。
• --type 为可选项，且不区分大小写。此参数用于筛选返回的清单，不会更改源数据。

前提条件与安全

• 目标组织已通过 sf CLI 完成身份验证。
• API v66.0 或更高版本。
• 运行用户必须拥有 查看设置和配置 与 自定义应用程序 权限。
• 此技能为只读。共享的无头分发器使用 HTTP POST 信封，但调用的 getChannelInstances 控制器操作不会修改组织。
• 使用 sf api request rest；切勿提取或打印访问令牌。

运行

使用目标组织和可选的渠道类型调用 scripts/analyze.sh。该脚本会将经过批准的 OmniChannelInstancesController.getChannelInstances 信封 POST 到共享的无头分发器，验证内部响应，可选地进行筛选，并返回稳定的摘要以及匹配的渠道实例。

当平台提供以下源字段时，清单会包含这些字段：

字段	含义
id, label	渠道标识和显示标签
omniChannelInstanceType	语音、电子邮件、聊天、SMS、Facebook、WhatsApp 或 InApp
routingType	队列、流或其他
routingRequirementId, routingRequirementLabel	队列、流或其他路由目标
channelUrl, routingRequirementUrl	平台合成的设置导航链接
icon, messages	显示元数据和平台提供的通知

输出约定

脚本会输出一个 JSON 对象：

• skill：service-omni-channel-inventory-analyze
• status：analyzed 或 blocked
• filter：规范的渠道类型，或 null
• summary.total_configured：筛选前平台返回的实例数
• summary.returned：instances 中的实例数
• summary.by_channel_type：返回清单中各渠道类型的数量
• summary.by_routing_type：返回清单中 Queue、Flow 和 Other 的数量
• instances：规范化的渠道实例对象
• blocking_issue：可采取行动的失败原因，或 null

status: analyzed 且 instances 数组为空，是有效的清单结果。身份验证、授权、端点或响应格式错误会返回 status: blocked 并以非零状态码退出；切勿将这些情况误解为组织为空。

边界

• 不要用独立的 SOQL 查询替代此操作。没有任何单一的公共对象 API 能重现平台跨渠道系列聚合、路由类型派生和设置 URL 生成的功能。
• 不要推断缺失的路由字段。平台未提供值时，保留 null。
• 不要将返回的设置 URL 用作变更端点。
• 如需更改配置，只有在向用户展示清单后，才能交接给相应的叶子技能。

后续请求	技能
协调完整的 Omni 设置	service-omni-channel-setup-coordinate
创建或重用 Service Channel	service-omni-service-channel-configure
创建或更新队列路由配置	service-omni-queue-routing-config-deploy
部署 QueueBased 或 SkillsBased 路由流	service-omni-routing-flow-deploy

参考资料

文件	阅读时机
references/api-notes.md	了解受支持的端点、权限边界、响应字段，以及无头操作为何是规范方式