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

service-omni-base-settings-configure — скилл для Claude Code

Скилл service-omni-base-settings-configure для Claude Code и других ассистентов настраивает базовые параметры Omni-Channel в Salesforce через Metadata API. Включает пять главных флагов маршрутизации перед созданием очередей.

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

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

Что делает service-omni-base-settings-configure

Скрипт проверяет состояние Salesforce-организации и выставляет пять булевых флагов OmniChannelSettings в значение true: enableOmniChannel, enableOmniAutoLoginPrompt, enableOmniSecondaryRoutingPriority, enableOmniSkillsRouting и enableOmniStatusCapModel. Без включения главного флага enableOmniChannel дальнейшая настройка очередей, статусов присутствия и маршрутизации невозможна.

Запуск выполняется через scripts/configure-and-report.sh в режиме plan для чтения или run для развёртывания. Деплой происходит целиком из файла OmniChannel.settings-meta.xml, если хотя бы один флаг выключен. После деплоя скрипт повторно запрашивает метаданные и отдаёт JSON-отчёт со статусами configured, reused, action_needed или blocked.

Для работы требуются sf CLI версии от 2.139.6, утилита jq от 1.6, авторизованная организация через My Domain URL и лицензия Service Cloud. Запись заблокируется без возможности обхода, если целевая организация не является песочницей, пробной средой или Developer/Base Edition.

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

  • включить все пять базовых настроек Omni-Channel в Salesforce
  • проверить текущее состояние флагов OmniChannelSettings без деплоя
  • защитить производственные организации от случайной перезаписи метаданных
  • получить JSON-отчёт о расхождениях параметров и ручных действиях

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

  • Проверь базовые настройки Omni-Channel в песочнице dev-sandbox в режиме plan
  • Включи базовые параметры Omni-Channel для организации с алиасом qa-org

Как установить service-omni-base-settings-configure

1Через Skills CLI (Vercel)

npx skills add forcedotcom/sf-skills --skill service-omni-base-settings-configure -a claude-code

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

~/.claude/skills/service-omni-base-settings-configure/SKILL.md

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

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

Вопросы о service-omni-base-settings-configure

Как установить service-omni-base-settings-configure в Claude Code?

Выполните команду npx skills add forcedotcom/sf-skills --skill service-omni-base-settings-configure -a claude-code. Файл спецификации сохранится в ~/.claude/skills/service-omni-base-settings-configure/SKILL.md.

Что делает этот скилл?

Он проверяет и развёртывает настройки OmniChannelSettings через Metadata API Salesforce. Все пять флагов всегда выставляются в true целиком через полный манифест.

Что нужно для работы service-omni-base-settings-configure?

Необходимы установленный sf CLI от 2.139.6, утилита jq от 1.6, доступ OrgPermissions.LightningService, лицензия Service Cloud и авторизованная тестовая организация.

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

SKILL.md · Apache-2.0
---
name: service-omni-base-settings-configure
description: "Use to enable the five Omni-Channel base settings on a Salesforce org via the Metadata API. The canonical writer scripts/configure-and-report.sh detects, deploys, and re-verifies in one call (run mode) or detects only (plan mode); it is idempotent (deploys only when a toggle is false or missing) and guards writes with a sandbox/CDO/trial/DE safe_to_write check. It always surfaces the UI-only login-behavior gap in its report. Triggers: enable Omni-Channel, turn on Omni base settings, configure OmniChannelSettings, deploy Settings:OmniChannel. Do not use to configure downstream Omni entities (queues, presence, permissions — use the entity-specific skill) or to deploy other Settings types (use platform-metadata-deploy)."
allowed-tools: Bash Read Write Edit Glob Grep
metadata:
  version: "1.0"
  domains: ["Service"]
  minApiVersion: "66.0"
  relatedSkills:
    - "platform-metadata-deploy"
    - "service-omni-channel-setup-coordinate"
  accessCheck: "OrgPermissions.LightningService"
  cliTools:
    - tool: ["jq"]
      semver: ">=1.6"
    - tool: ["sf"]
      semver: ">=2.139.6"
---

# service-omni-base-settings-configure

Enable the five `OmniChannelSettings` booleans (`enableOmniChannel`, `enableOmniAutoLoginPrompt`, `enableOmniSecondaryRoutingPriority`, `enableOmniSkillsRouting`, `enableOmniStatusCapModel`) via a single Metadata API deploy. Nothing downstream — queues, presence statuses, routing flows — works without `enableOmniChannel=true`, so this must be the first write in an Omni setup sequence. The skill probes first and deploys only when a toggle is false or missing.

## Inputs

```bash
bash scripts/configure-and-report.sh run  <org-alias>   # detect; deploy if needed; re-verify
bash scripts/configure-and-report.sh plan <org-alias>   # read-only: detect only, never deploys
```

`org-alias` is the only input. All five toggles are always set to `true` — the skill takes no per-toggle overrides; a caller who wants a subset should use `platform-metadata-deploy` with their own `OmniChannel.settings-meta.xml`.

## Preconditions and safety

- Target org authenticated via `sf` CLI (My Domain URL, not `.lightning.force.com`), Service Cloud license present, `sf` CLI ≥ 2.139.6.
- **Production guardrail:** the writer computes `safe_to_write` as `IsSandbox` OR `TrialExpirationDate != null` OR `OrganizationType` in {Developer Edition, Base Edition}, and blocks with no override when it is false. This permits CDOs (`IsSandbox=false` with a non-null `TrialExpirationDate`); do not weaken it to a bare `IsSandbox` check.

## Run

`configure-and-report.sh` is the canonical entry point:

- **run** — probe; if all five are already enabled, emit `reused` (no deploy); otherwise run the `safe_to_write` guard, deploy the explicit `assets/force-app/main/default/settings/OmniChannel.settings-meta.xml` source file with all five `true` (a `SucceededPartial` is treated as failure), re-probe, and emit `configured` iff all five are now true, else `blocked`. The explicit source path bypasses source-tracking no-op decisions when the org value has drifted.
- **plan** — probe only; emit `reused` if all enabled, else `action_needed`. Never deploys.

The probe retrieves `Settings:OmniChannel` and takes 1–2 minutes (Metadata retrieve is slow); this is expected. The deploy runs from `assets/` (a valid DX project) and names the settings file with `--source-dir`; its template is never mutated at runtime, so the skill stays reproducible and does not report "No local changes to deploy" solely because local source tracking is clean.

## Behavior

**Whole-document writes.** `Settings` is a whole-document metadata type — the Metadata API does not accept partial updates, so the skill always deploys the full file rather than PATCHing individual toggles.

**Login-behavior gap.** The Omni login-behavior radio (Setup → Omni-Channel Settings → "Define login behavior when an agent opens a new window/tab") has no public API on v66. The report always surfaces its click-path — even on a no-op `reused` run — so a "nothing to do" result never hides the one manual action. `enableOmniAutoLoginPrompt` still deploys cleanly (other Omni features may depend on it internally) but does not drive that radio.

**Fail-closed verify.** After a deploy the skill re-probes and requires all five toggles true; a deploy that reports success but does not stick (an uncommon org-level restriction) blocks rather than reporting success.

## Output contract

`configure-and-report.sh` emits a single JSON object with `status` ∈ `configured` | `reused` | `action_needed` | `blocked`, a top-level `all_enabled` boolean the coordinator reads to gate downstream skills, full `before`/`after` toggle objects, `deploy_id`, `safe_to_write`, `manual_actions`, and `blocking_issue`.

- `configured` — a toggle was false, the deploy ran, and the re-probe shows all true (run mode).
- `reused` — all five were already true; no deploy.
- `action_needed` — plan mode saw a disabled toggle; nothing deployed.
- `blocked` — `safe_to_write=false`, the deploy failed or was `SucceededPartial`, or the re-probe still shows a false toggle.

`manual_actions` always includes the login-behavior gap entry on non-blocked reports; `deploy_id` is `null` for `reused`/`action_needed`; `blocking_issue` names the failure only when `status: blocked`.

## Limitations

- Configures only `OmniChannelSettings`, always with all five toggles true — other `Settings` types belong to `platform-metadata-deploy`.
- Cannot turn the login-behavior radio (no public API on v66) — it only surfaces the click-path.

## References

| File | When to read |
|---|---|
| `references/api-notes.md` | Before a deploy — the five toggles' semantics, dependencies, and the login-behavior caveat |

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

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

Все скиллы по теме «Облака: AWS, Azure, GCP» →
omni-settings cheaper-inference Скилл omni-settings читает и обновляет глобальные настройки OmniRoute: системные промпты, бюджет размышлений, IP-фильтры и правила полезной нагрузки. CX Codex +1 1 300установок salesforce membrane Работает с записями Salesforce через Membrane CLI: ищет данные, создаёт и меняет записи, запускает запросы. Управляет CRM из чата с агентом. CX Codex +1 1 300установок crm-hygiene-check официальный anthropics Скилл crm-hygiene-check проверяет сделки в Salesforce или HubSpot на пустые поля, устаревшие даты и несоответствие стадии — выдаёт чек-лист правок. CX Codex +1 397установок posthog-inbound-leads PostHog Скилл posthog-inbound-leads разбирает входящие лиды из Salesforce, сверяет данные с Vitally и помогает выбрать дальнейший шаг. Затем готовит ответное письмо и проверяет ссылки в нём. CX Codex +1 210установок salesforce-automation davepoon Скилл salesforce-automation для Claude Code автоматизирует работу с Salesforce через Composio. Создаёт и ищет лиды, контакты, аккаунты и сделки, выполняет SOQL-запросы. CX Codex +1 128установок cleanup-properties tomgranot Скилл cleanup-properties находит и архивирует неиспользуемые пользовательские поля в сделках, контактах и компаниях HubSpot. Защищает от переполнения свойств CRM. CX Codex +1 ★ 81звёзд репо

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

Весь набор →
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-presence-status-deploy Скилл service-omni-presence-status-deploy для Claude Code развёртывает статусы доступности Omni-Channel. Запускается при настройке Available-статусов для Case, Incident, Messaging или Voice и стандартного Busy. 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установок service-omni-presence-user-config-deploy Скилл service-omni-presence-user-config-deploy для Claude Code разворачивает конфигурацию присутствия Omni для агентов. Он включает отказ от работы с причиной и таймер ACW, затем назначает конфигурацию пользователям. CX Codex +1 102установок

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

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