К основному содержанию
скилл CX Codex

service-omni-presence-status-deploy — скилл для Claude Code: установка

Скилл service-omni-presence-status-deploy для Claude Code развёртывает статусы доступности Omni-Channel. Запускается при настройке Available-статусов для Case, Incident, Messaging или Voice и стандартного Busy.

Apache-2.0 103 установок ★ 1 183 обновлён 2026-10-23

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add forcedotcom/sf-skills --skill service-omni-presence-status-deploy -a claude-code
Открыть на GitHub

Что делает service-omni-presence-status-deploy

Скилл развёртывает для выбранного объекта статус Available_<X> и добавляет Busy, только если такого статуса ещё нет. Статус Available связывается с каналом объекта: например, Available_Case — с Cases, а Available_Voice — с sfdc_phone. Развёртывание проходит одним вызовом Metadata API; существующие статусы Busy и другие скилл не перезаписывает и не удаляет.

Для запуска нужны аутентифицированная целевая организация, лицензия Service Cloud, sf версии 2.139.6 или выше и jq версии 1.6 или выше. В настройках организации должны быть включены Omni-Channel base settings, а ServiceChannel для выбранного объекта уже создан. Для Incident нужна включённая функция Incident Management, для MessagingSession — Enhanced Messaging. Скилл принимает тип объекта Case, Incident, MessagingSession или VoiceCall; без аргумента использует Case. Настраивать PresenceUserConfig, причины отказа и собственные статусы он не умеет.

Какие задачи решает

  • создать Available-статус для выбранного объекта
  • связать статус доступности с нужным ServiceChannel
  • добавить Busy, если его ещё нет
  • развернуть статусы Omni-Channel одним вызовом Metadata API

Примеры запросов агенту

  • Разверни статус Omni-Channel Available для Case в организации my-org.
  • Настрой доступность агентов для MessagingSession в организации my-org.
  • Добавь стандартный Busy и Available для VoiceCall в организации my-org.

Как установить service-omni-presence-status-deploy

1Через Skills CLI (Vercel)

npx skills add forcedotcom/sf-skills --skill service-omni-presence-status-deploy -a claude-code

2Вручную: положить файлы

~/.claude/skills/service-omni-presence-status-deploy/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/service-omni-presence-status-deploy/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о service-omni-presence-status-deploy

Как установить service-omni-presence-status-deploy в Claude Code?

Выполни npx skills add forcedotcom/sf-skills --skill service-omni-presence-status-deploy -a claude-code. Файл скилла появится по пути ~/.claude/skills/service-omni-presence-status-deploy/SKILL.md.

Что делает service-omni-presence-status-deploy?

Он развёртывает связанный с каналом Available-статус для Case, Incident, MessagingSession или VoiceCall. Статус Busy добавляется, только если в организации его ещё нет.

Что нужно для работы service-omni-presence-status-deploy?

Нужны аутентифицированная организация Salesforce, лицензия Service Cloud, sf версии 2.139.6 или выше и jq версии 1.6 или выше. Также требуются включённые Omni-Channel base settings и созданный ServiceChannel; для Incident нужна функция Incident Management, для MessagingSession — Enhanced Messaging.

Исходный текст

SKILL.md · Apache-2.0
---
name: service-omni-presence-status-deploy
description: "Create the standard Available and Busy presence statuses needed for Omni-Channel routing. TRIGGER when users ask to deploy Omni presence statuses, configure agent availability, deploy Omni status metadata, create an Available status for Case, Incident, Messaging, or Voice, or add the standard Busy status. DO NOT TRIGGER for custom status designs, unsupported objects, or PresenceUserConfig capacity."
allowed-tools: Bash Read Write Edit Glob Grep
metadata:
  version: "1.0"
  domains: ["Service"]
  minApiVersion: "66.0"
  relatedSkills:
    - "service-omni-base-settings-configure"
    - "service-omni-channel-setup-coordinate"
    - "service-omni-permission-set-assign"
    - "service-omni-service-channel-configure"
  accessCheck: "OrgPermissions.LightningService"
  cliTools:
    - tool: ["jq"]
      semver: ">=1.6"
    - tool: ["sf"]
      semver: ">=2.139.6"
---

# service-omni-presence-status-deploy

Deploy the sObject-specific `Available_<X>` ServicePresenceStatus bound to that sObject's ServiceChannel, and ensure a universal `Busy` status exists, in one atomic Metadata API deploy. Every Omni agent needs an "available for work" status carrying a channel (so incoming work routes) and an "off-work" status (so they can step away). A presence status binds to exactly one ServiceChannel by DeveloperName, so each routing target needs its own Available status. It pairs with `service-omni-permission-set-assign`, which grants agents access to the statuses this skill deploys, and is invoked once per routing target by `service-omni-channel-setup-coordinate`.

| Target sObject | Available status | Bound channel |
|---|---|---|
| `Case` | `Available_Case` | `Cases` |
| `Incident` | `Available_Incident` | `Incidents` |
| `MessagingSession` | `Available_Messaging` | `sfdc_livemessage` |
| `VoiceCall` | `Available_Voice` | `sfdc_phone` |

**Busy is UI-defined, not metadata-defined.** The Omni "Busy vs Online" option is not expressible via the Metadata API — a `ServicePresenceStatus` carries only `<label>` and `<channels>`, and a status with no channels is treated as busy. The conventional busy DeveloperName is simply `Busy`, and most orgs already have one, so this skill reuses an existing `Busy` and deploys the bundled asset only when none exists. A busy status is not required to receive work — the Available status carrying the channel is what routes it.

## Inputs

```bash
bash scripts/deploy-and-report.sh <org-alias> [Case|Incident|MessagingSession|VoiceCall]
```

- `org-alias` (required).
- `sobject_type` (optional, default `Case`).

## Preconditions and safety

- Target org authenticated via `sf` CLI (My Domain URL), Service Cloud license, `sf` CLI ≥ 2.139.6.
- Omni-Channel base settings enabled (`service-omni-base-settings-configure`) — otherwise the deploy fails with `INVALID_TYPE`.
- The target sObject's ServiceChannel exists (`service-omni-service-channel-configure`) — otherwise the deploy fails with `Value '<channel>' is not valid`. `Incident` requires the Incident Management feature enabled; `MessagingSession` requires Enhanced Messaging.
- The three-way `safe_to_write` production guard applies.

## Run

`deploy-and-report.sh` deploys the `Available_<X>` status (and `Busy` only when the org has none) in one Metadata API call, then maps the per-component `files[].state` to a skill status:

- `reused` — every component `Unchanged`.
- `updated` — any component `Changed`, none `Created`.
- `created` — any component `Created`.

There is no separate detect step — Salesforce's `files[].state` is authoritative. The deploy uses explicit `--metadata` flags (never `--source-dir`) so unrelated assets cannot piggyback.

## Behavior

**Reuse over redeploy.** An existing `Busy` is detected and left untouched; only a missing one is deployed. The skill never deletes or overwrites presence statuses it did not deploy — orgs often carry other custom statuses (`Omni_OnBreak`, `availableForMiaw`).

**Schema.** The XML omits `<statusType>` (removed in v66; online/busy is inferred from the presence of `<channels>`), and the skill never SOQL-queries `StatusType` (not queryable on v66 — only Id, DeveloperName, MasterLabel are reliable). `Available_Messaging` binds the standard `sfdc_livemessage` channel that Enhanced Messaging always ships.

## Output contract

A single JSON object with `status` ∈ `created` | `reused` | `updated` | `blocked`, `sobject_type`, a `presence_statuses` array (each with `developer_name`, `label`, `channels`, `state`, and — for `Busy` — `reused_existing`), `deploy_id`, `manual_actions`, and `blocking_issue`.

- `blocked` — deploy failed (missing prereq, schema mismatch, or org error); `manual_actions` names the prerequisite skill to run and `blocking_issue` is an operator-friendly translation of the Salesforce error.
- `deploy_id` is populated on every run (Salesforce issues one even for no-op deploys).

## Limitations

- Deploys only the `Available_<X>` + `Busy` pair — custom statuses require forking the `assets/servicePresenceStatuses/*.xml`.
- Only `Case`, `Incident`, `MessagingSession`, `VoiceCall` — extend by adding a dispatcher branch and a matching asset.
- Does not configure `PresenceUserConfig` capacity or decline reasons, and never deletes existing statuses.

## References

| File | When to read |
|---|---|
| `assets/package.xml` | Load when preparing the explicit Metadata API deployment for the selected Available status and the optional Busy status |
| `references/api-notes.md` | On unexpected deploy behavior — the v66 XML schema (no `statusType`), channel-binding rules, and MessagingSession-specific notes |

© forcedotcom · Apache-2.0 · forcedotcom/sf-skills

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
mastering-animate-presence raphael-salaja Скилл mastering-animate-presence проверяет код Motion и Framer Motion на ошибки в AnimatePresence и exit-анимациях. Пригодится при ревью модалок и списков. CX Codex +1 323установок github-presence jonathimer Скилл github-presence для Claude Code, Codex, Cursor, Copilot, Gemini CLI и OpenCode оптимизирует README, профиль и видимость репозиториев на GitHub. Запускается по фразам «GitHub README», «GitHub профиль», «awesome lists». CX Codex +1 ★ 88звёзд репо omni-tunnels cheaper-inference Скилл omni-tunnels создаёт защищённые туннели (ngrok, Cloudflare Tunnel или собственные) и раскрывает OmniRoute в интернет или подключает удалённых агентов и CI-пайплайны. CX Codex +1 1 300установок omni-proxies cheaper-inference Скилл omni-proxies настраивает HTTP, HTTPS и SOCKS-прокси для запросов к апстрим-провайдерам в OmniRoute: правила по провайдеру или глобально, проверка соединения и ротация. CX Codex +1 1 300установок api-status-communication Samuel Berthe Скилл api-status-communication помогает спроектировать публичную статус-страницу API и правила публикации инцидентов. Пригодится при настройке оповещений об авариях, соглашений SLA и регламента технических работ. CX Codex +1 10 400установок google-agents-cli-deploy официальный Google Скилл google-agents-cli-deploy инструктирует агента по деплою ИИ-агентов в Google Cloud через утилиту agents-cli. Помогает настроить запуск в Agent Runtime, Cloud Run или GKE с учётом CI/CD и секретов. CX Codex +1 587 400установок

Из того же набора232

Весь набор →
service-omni-skills-based-routing-configure Скилл service-omni-skills-based-routing-configure для Claude Code связывает Omni Skill с активными пользователями агентов. Запускается при настройке маршрутизации Omni по навыкам. CX Codex +1 106установок service-omni-permission-set-assign Скилл service-omni-permission-set-assign для Claude Code назначает агентам наборы разрешений Omni. Запускается по просьбе выдать доступ к Omni-Channel или исправить назначения для виджета Omni. CX Codex +1 104установок service-omni-supervisor-config-deploy Скилл service-omni-supervisor-config-deploy для Claude Code разворачивает конфигурацию классического Omni-Channel Supervisor в Salesforce. Запускается по просьбе настроить Omni Supervisor или Supervisor Command Center. CX Codex +1 104установок service-omni-sidebar-configure Скилл service-omni-sidebar-configure для Claude Code включает и проверяет боковую панель Omni-Channel в консольных приложениях Lightning. Активирует закреплённую область оператора через метаданные CustomApplication. CX Codex +1 103установок service-omni-base-settings-configure Скилл service-omni-base-settings-configure для Claude Code и других ассистентов настраивает базовые параметры Omni-Channel в Salesforce через Metadata API. Включает пять главных флагов маршрутизации перед созданием очередей. CX Codex +1 103установок service-omni-supervisor-surface-deploy Скилл service-omni-supervisor-surface-deploy для Claude Code заполняет интерфейс Omni-Channel Supervisor в Salesforce стандартными кнопками и вкладками через Data API. Запускается при настройке панели супервизора. CX Codex +1 102установок service-omni-supervisor-users-create Скилл service-omni-supervisor-users-create для Claude Code создаёт учётные записи супервайзеров Omni-Channel в Salesforce. Запускается по запросу создать или подготовить таких пользователей. CX Codex +1 102установок service-omni-supervisor-permset-assign Скилл service-omni-supervisor-permset-assign для Claude Code, автоматизирующий назначение ContactCenterSupervisor пользователям в Salesforce. Запускает проверку и выдачу прав супервайзера в CI или окружении разработки. CX Codex +1 102установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой