forcedotcom/sf-skills / plugins/builder/service-omni/skills/service-omni-channel-inventory-analyze
service-omni-channel-inventory-analyze
VerifiedUse to inventory configured Omni-Channel instances across Voice, Email, Chat, SMS, Facebook, WhatsApp, and In-App, including each channel's Queue, Flow, or Other routing target, without changing the org. TRIGGER when: list Omni channels, inventory Omni routing, inspect channel routing targets, analyze Omni-Channel setup, or find configured service channels. Do not use to create, update, activate, or delete channels or routing configuration.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.8 KB |
| references/api-notes.md | markdown | 2.2 KB |
| scripts/analyze.shexecutable | script | 6.2 KB |
| scripts/tests/_bootstrap.py | script | 2.5 KB |
| scripts/tests/test_inventory_analyze_contracts.pyexecutable | script | 5.6 KB |
references/api-notes.md
View on GitHub# Omni-Channel inventory API notes
## Supported operation
```text
POST /services/data/v66.0/headless/invoke
```
Call it through `sf api request rest --method POST --target-org <alias>` with this invoke envelope:
```json
{
"className": "ui.omnichannel.home.controller.OmniChannelInstancesController",
"action": "getChannelInstances"
}
```
The Project Codey route is logically read-only even though the shared dispatcher transport is POST-only. Salesforce CLI owns authentication, so do not extract the org access token or build an Authorization header. Treat the inner `status_code` as authoritative and read the inventory from `body`.
Project Codey's approved `OmniChannelHome` source-of-record identifies this Aura-backed headless operation as canonical. The owning-team review was approved on 2026-08-20. The operation aggregates providers for Live Chat buttons, Messaging channels, Service channels, and Voice, then derives routing labels and setup URLs. Independent Connect, Tooling, Metadata, or sObject calls do not reproduce that contract.
## Permission boundary
The running user needs both customer-facing permissions:
- View Setup and Configuration
- Customize Application
A permission failure is not evidence that the org has no channel instances. Return `status: blocked` and ask the user to run with an appropriately authorized setup user.
## Response fields
Each channel instance can include:
```text
id
label
channelUrl
omniChannelInstanceType
routingType
icon
routingRequirementId
routingRequirementLabel
routingRequirementUrl
messages
```
Known channel-type labels are `Voice`, `Email`, `Chat`, `SMS`, `Facebook`, `WhatsApp`, and `InApp`. Known routing labels are `Queue`, `Flow`, and `Other`. The script accepts these labels case-insensitively and emits their canonical display spelling.
## Response handling
The supported operation's contract is an array of channel instances. The analyzer also tolerates a raw array or the same array nested under a standard `body`, `result`, `data`, `items`, `records`, `value`, or `channelInstances` envelope so Salesforce CLI response wrapping does not silently turn valid results into failures. Any other shape is blocked as malformed.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |