SuperAPI AI 工具集

service-omni-presence-user-config-deploy

办公与效率

查看项目

更新于 10-15 21:43

技能介绍

用途:把 Omni PresenceUserConfig(决定工作如何分配给坐席的“存在状态配置”)连同其引用的 PresenceDeclineReason,作为一个原子 Metadata API 包整体部署。由于拒绝、自动接受、拒绝原因、ACW 字段之间存在跨字段校验(启用拒绝需关闭自动接受,拒绝原因需先启用拒绝,ACW 计时器需与其最大时间配对),只能以整条记录写入,不能逐字段设置。该技能在 service-omni-agent-users-create / service-omni-presence-status-deploy 之后运行,并由 service-omni-channel-setup-coordinate 作为坐席体验步骤调用。

用法:bash scripts/deploy-and-report.sh <org-alias> [config_developer_name] [agent_usernames_csv]。org-alias 必填;config_developer_name 可选,默认 Omni_Demo_Presence_Config;agent_usernames_csv 可选,为逗号分隔的 Username 或 15/18 位 User Id,也可通过 AGENT_USERNAMES_CSV 设置,留空则部署但不分配用户。环境变量覆盖:DECLINE_REASON_LABEL(默认 Training)、DECLINE_REASON_DEVELOPER_NAME、CAPACITY(默认 5,1–100)、ACW_SECONDS(默认 60,10–3600)、PRESENCE_STATUS_ON_DECLINE。

前置条件:目标组织已通过 sf CLI 认证,具备 Service Cloud 许可,sf CLI ≥ 2.139.6;已启用 Omni-Channel 基础设置;PRESENCE_STATUS_ON_DECLINE 必须已存在;适用三方 safe_to_write 生产保护。脚本将两个组件物化到临时 DX 项目并一次部署,元素按严格 XSD 顺序输出,通过 Metadata API 的 files[].state 实现幂等,部署以 --async 运行并轮询至终态。

输出:单个 JSON 对象,含 status(created/updated/reused/blocked)、config、decline_reason、assigned_usernames、deploy_id、manual_actions、blocking_issue。

限制:每次调用仅一个存在状态配置;仅编码 steel thread 的拒绝+ACW 坐席配置,其他字段组合需修改 XML 模板;不设置 ServiceChannel 级别的 ACW 计时器,不部署 ServicePresenceStatus,也不通过权限集授予状态访问。