service-itsm-channels-coordinate

Top-level interactive coordinator for Employee Service (ITSM) channel setup. Presents menu of channel setup options (Portal, Teams, Slack) and delegates to the corresponding skill. Use this for: 'setup ITSM channels', 'configure employee service channels', 'set up service cloud communication channel

By forcedotcom · 1,126 installs

npx skills add forcedotcom/sf-skills --skill service-itsm-channels-coordinate

Source repository · Upstream listing

Employee Service (ITSM) Channels Setup Coordinator Interactive coordinator that presents a menu of ITSM channel setup options and delegates to the appropriate child skill based on user selection. Scope In scope : Presenting the channel setup menu to the user. Delegating to child skills based on selection (Portal, Teams, Slack). Validating prerequisites before delegation. Providing clear descriptions of each channel capability. Out of scope : Directly calling setup APIs for any channel — always delegate to the dedicated child skill. Channel specific configuration details beyond the initial enablement. User permission assignment. Post setup testing. ITSM notification preferences (a separate concern — handle those with the dedicated notification preferences skill, not through this menu). Available Channel Setup Skills This coordinator can invoke three distinct channel setup skills: 1. Portal Setup Skill: experience portal create What it does: Creates a Digital Experience portal for employee self service Supports Employee Service, Partner, and Customer portals Prerequisites: Vary by portal type Use when: User wants to create a portal for employee self service. 2. Microsoft Teams Setup Skill: service itsm teams configure What it does: Enables the service cloud itsm teams integration Salesforce Go feature via headless 360's feature enablement Connect API — the only verified path that flips ITSMTeamsEnabled (direct PATCH of the org preference is blocked with 401) Optionally enables the sibling OrgHasITSMFulfillerTeams / OrgHasEmployeeServiceTeams preferences Verifies ITSMTeamsEnabled afterward and reports the remaining manual (Microsoft side) steps Prerequisites: Teams ITSM add on licenses Setup admin permissions Use when: User wants Microsoft Teams integration for IT Service Desk or Employee Service apps. Teams sub skills service itsm teams configure delegates to (surface these if the user asks for a specific half): service itsm teams itdesk configure (fulfiller/IT Desk checklist), service itsm teams itservice configure (employee/IT Service checklist), service itsm teams employee agent configure (embedded "Ask AI Agent"), and service itsm teams debug (diagnose a failing Teams setup — login, tab loading, agent, swarming, SSO). Swarming (collaborative problem solving) is configured inside the Teams setup flow, not as a separate top level channel option. 3. Slack Setup Skill: the installed Slack ITSM setup skill — resolve it from the skills catalog at delegation time by name pattern (see Choice 3 in the workflow); do not hardcode a single skill name. What it does: Enables Slack integration for ITSM (Employee Service / IT Service on Slack) Configures the Slack workspace connection and required org preferences/permission sets Prerequisites: Slack workspace with admin access Org has Slack integration enabled Use when: User wants Slack integration for ITSM. Workflow Step 1: Present Menu to User Always present the menu before proceeding: Do NOT proceed until the user provides a choice. Step 2: Validate Prerequisites Based on user's choice, check prerequisites before delegating to child skills: For Choice 2 (Teams Integration): 1. Check if Teams master toggle API is accessible 2. Attempt to query current toggle state 3. If prerequisites fail, inform user about missing Teams ITSM licenses If prerequisites fail: Explain what's missing (licenses, features, permissions) Offer alternative choices (e.g., suggest Slack if Teams licenses missing) Do NOT attempt to execute the chosen configuration Step 3: Delegate to Child Skill Choice 1: Portal Setup Delegation: The portal creation skill will handle all clarifying questions (portal type, name, URL prefix, etc.). After delegation: "Success: Portal setup delegated to experience portal create skill. Follow the prompts to complete portal creation." Choice 2: Microsoft Teams Setup Delegation: On success: "Success: Microsoft Teams integration master toggle is enabled. Background provisioning in progress (2 5 minutes). Next steps: Configure Azure AD application Set up Salesforce IT Desk and/or IT Service apps" On failure: "Failed: Teams integration failed: [error details] Resolution: Verify org has Teams ITSM licenses Try option 3 (Slack) instead" Choice 3: Slack Setup Resolve the delegation target deterministically from the skills catalog, then invoke the result. Do not decide by prose guesswork — look the skill up: Manual instructions (only if the catalog lookup returned no Slack skill): "No Slack ITSM setup skill is installed in this environment. To configure Slack manually: 1. Navigate to: Setup → Integrations → Slack 2. Connect your Slack workspace 3. Configure Slack apps for ITSM" Decision Tree Rules / Constraints Constraint Rationale Always present options before proceeding User may not know what's possible or what their org supports Validate prerequisites before delegating Catch licensing/feature gaps early before invoking child skills Notifications are not a menu option ITSM notification preferences are a separate concern; route those requests to the dedicated notification preferences skill, not through this coordinator Swarming is configured inside Teams, not a top level channel Swarming requires Teams; it is handled within the Teams setup flow ( service itsm teams configure ), so it is not offered as a separate menu option Do not retry failed delegations Child skills handle their own retries; surfacing error to user for decision Partial success is acceptable If Teams succeeds but Slack fails, user can retry Slack separately Prerequisites by Choice Choice 1: Portal Setup Vary by portal type (see experience portal create skill) Choice 2: Teams Setup Teams ITSM licenses Setup admin permissions Choice 3: Slack Setup Slack workspace with admin access Org has Slack integration enabled Error Handling If user provides invalid choice: "Please choose a valid option: 1, 2, or 3." If prerequisites check fails: "I've detected that your org is missing [specific requirement]. I recommend choosing [alternative option] instead, which works with your current org configuration." If delegation fails: "The [child skill name] encountered an error: [error message] [Provide specific resolution steps based on error]" If user is unsure which to choose: "Let me help you decide: Do you want a portal for employee self service? Digital Experience portal → Choose 1 Do you want to enable a communication channel? Microsoft Teams → Choose 2 Slack → Choose 3 Both → Run 2, then 3" Related Operations After completing channel setup via this coordinator: Configure channel specific settings — customize each channel's behavior Set up Azure AD — required for Teams (if Teams selected) Configure ITSM notifications — use the dedicated notification preferences skill (separate from this coordinator) Test channels — verify each channel is working To modify later: Enable additional channels — rerun this coordinator with different option Disable channels — use corresponding disable skills Update channel settings — navigate to Setup → [Channel] → Settings Embedded Agentforce Agent in Microsoft Teams Making the embedded Agentforce agent actually reply inside the Teams custom client ("Salesforce Employee Assist" / "Ask AI Agent") is the hardest, most under documented part of Teams ITSM. It is now a dedicated skill: → service itsm teams employee agent configure The verified architecture is a Web Enhanced messaging channel with User Verification OFF (auth mode false) — the Teams client uses the scrt2 unauthenticated token endpoint — the Teams AgentForce custom client Embedded Service Deployment, an Omni Flow routing flow targeting a real, Active Agentforce Employee Agent, and an Agent Access permission set enabling that agent for the portal user. That skill also covers the key diagnostic: "agent joins then leaves without replying" has two fixable causes — auth mode left ON (→ /eventrouter/v1/sse 401) and the portal user missing Agent Access — not an unfixable agent runtime failure. API Type Classification This coordinator: Does NOT call APIs directly — it delegates to child skills Uses interactive menu for user selection Child skills handle all API calls Child skills used: experience portal create — Connect API service itsm teams configure — headless 360 (Salesforce Go feature enablement Connect API) Slack ITSM setup skill (resolved from catalog by name pattern) — child skill handles its own API calls Important Notes 1. This is an interactive coordinator — it MUST present the menu and wait for user choice before executing anything. 2. Always delegate to child skills — this coordinator doesn't implement channel specific logic; it only routes to the appropriate skill. 3. Some skills may not exist yet — if a skill is not found, provide manual setup instructions so the user isn't blocked. 4. Notifications are handled elsewhere — ITSM notification preferences are not a channel menu option; route those requests to the dedicated notification preferences skill. 5. Swarming lives inside Teams — Swarming is not a standalone menu option; it is configured within the Teams setup flow ( service itsm teams configure ), since it requires Teams. 6. Prerequisites vary by channel — each channel has different licensing and feature requirements. 7. No retry logic — this coordinator doesn't retry failed operations. Surface the error and let user decide next steps. 8. Educational role — help users understand what each channel does and which prerequisites they need.