SuperAPI AI 工具集

service-itsm-teams-itdesk-configure

办公与效率

查看项目

更新于 10-15 21:44

技能介绍

用途:完成 Teams ITSM Go 页面中“Set Up Salesforce IT Desk”清单组的履行方/坐席侧配置,让 IT 坐席可在 Teams 中协作处理工单。所有操作通过 headless-360 派发。前置条件:需先运行 service-itsm-teams-configure,确保 service-cloud-itsm-teams-integration Go 功能已启用。

主要能力与用法:

  1. 开启 Salesforce IT Desk:通过 PATCH /services/data/v67.0/setup/org/preferences/OrgHasITSMFulfillerTeams,body 为 {"desiredState": true},预期返回 200 与 isPreferenceEnabled: true。
  2. 安装 Teams 应用:无 API 可自动安装,需人工在 Teams 管理中心/AppSource 点击添加。提供市场链接 https://marketplace.microsoft.com/en-us/product/teams-app/WA200009869?tab=Overview 与帮助文档 https://help.salesforce.com/s/articleView?id=service.it_srvce_msteams_cnfig_fulfilerhub_app.htm&type=5,并提示 Microsoft 账号邮箱须与 Salesforce Username 一致,否则静默登录失败。完成后须等待用户确认再继续。
  3. 管理用户访问:先询问具体用户,可分页查询(每页最多 10 条,注意系统/集成账号)。查询并分配 TeamsForITSrvcsUser 与 MicrosoftGraphAccess 两个权限集,通过 PermissionSetAssignment 逐条分配。
  4. 登录前置:上述两个权限集 PermissionsApiEnabled 为 false,会导致登录“server not reachable”。需解析或创建带 API Enabled 的权限集(常见 Teams_Employee_ApiAccess),创建 body 为 {"Name":"Teams_Employee_ApiAccess","Label":"Teams Employee API Access","PermissionsApiEnabled": true},并分配给用户。之后让用户完全关闭并重开 Teams 应用,并确认 CORS Allowed Origins 含 https://teams.cloud.microsoft 与 https://cdn.scs.static.lightning.force.com。
  5. 设置 Swarming 协作工具:委派给 service-itsm-swarming-configure,由其启用 service-cloud-swarming 并写入 SWARM_COLLABORATION_TOOL 为 Teams。

限制:每次只执行一步,逐步确认,不可并行批量调用;dispatch 需带完整 /services/data/vXX.0/ 前缀;应用安装为人工操作;权限集分配无批量端点;部分登录诊断项仅能在 Setup UI 操作。