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

service-omni-queue-members-assign — скилл для Claude Code

Скилл service-omni-queue-members-assign для Claude Code привязывает агентов к очередям Salesforce через Data API. Наполняет очереди Case и Voice участниками для распределения нагрузки в Omni-Channel.

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

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

Что делает service-omni-queue-members-assign

Скилл добавляет пользователей в очередь Salesforce через отдельные POST-запросы к объекту GroupMember. Скрипт verify-and-bind.sh сначала проверяет текущий состав через SOQL и создаёт записи только для отсутствующих участников, поэтому повторный запуск безопасен. Доступны два режима: автоподбор сгенерированных пользователей agent{1..N} или явный список логинов и User ID через CSV.

Существующие привязки инструмент не удаляет и не перезаписывает. Очереди и самих пользователей он тоже не создаёт: они должны быть подготовлены заранее. Защита safe_to_write блокирует запуск на production-оргах без возможности обхода, исключая случайный сброс реальной маршрутизации.

Для работы требуются Service Cloud, полномочия PermissionsModifyAllData, sf CLI версии 2.139.6 или выше, python3 от 3.8 и jq от 1.6. Результат выполнения возвращается в формате JSON со статусом bound, reused, partial или blocked.

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

  • добавить сгенерированных тест-агентов в очередь CaseQueue
  • привязать реальных операторов к очереди Voice по списку User ID
  • наполнить очереди участниками перед проверкой Omni-Channel
  • выявить отсутствующих участников очереди без удаления существующих

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

  • Добавь трех сгенерированных агентов в CaseQueue в myorg
  • Привяжи пользователей [email protected] и 005XX000001abcd к очереди VoiceQueue
  • Проверь состав очереди CaseQueue и добавь недостающих операторов

Как установить service-omni-queue-members-assign

1Через Skills CLI (Vercel)

npx skills add forcedotcom/sf-skills --skill service-omni-queue-members-assign -a claude-code

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

~/.claude/skills/service-omni-queue-members-assign/SKILL.md

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

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

Вопросы о service-omni-queue-members-assign

Как установить service-omni-queue-members-assign в Claude Code?

Выполните команду npx skills add forcedotcom/sf-skills --skill service-omni-queue-members-assign -a claude-code.

Что делает service-omni-queue-members-assign?

Создаёт записи GroupMember через Data API, связывая пользователей с очередью Salesforce для работы Omni-Channel.

Что нужно для работы service-omni-queue-members-assign?

Понадобятся sf CLI от 2.139.6, jq от 1.6, python3 от 3.8, лицензия Service Cloud и право PermissionsModifyAllData в целевой непроизводственной среде.

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

SKILL.md · Apache-2.0
---
name: service-omni-queue-members-assign
description: "Use to bind agent users into a Salesforce Queue via GroupMember Data API POSTs, with SOQL-based idempotency (safe re-run — only inserts missing bindings). Binds either the generated demo agents (agent{1..N}.<suffix>@example.com) or an explicit list of real agents passed as usernames/User Ids. Triggers: add agents to a Case/Voice queue, assign agent users to a queue, populate queue membership for Omni routing. Do not use to create the queue (service-omni-queue-deploy), to create the agent users (service-omni-agent-users-create), or to assign permission sets (service-omni-permission-set-assign)."
allowed-tools: Bash Read Write Edit Glob Grep
metadata:
  version: "1.0"
  domains: ["Service"]
  minApiVersion: "66.0"
  relatedSkills:
    - "service-omni-agent-users-create"
    - "service-omni-permission-set-assign"
    - "service-omni-queue-deploy"
    - "service-omni-queue-routing-config-deploy"
  accessCheck: "OrgPermissions.LightningService"
  cliTools:
    - tool: ["jq"]
      semver: ">=1.6"
    - tool: ["python3"]
      semver: ">=3.8"
    - tool: ["sf"]
      semver: ">=2.139.6"
---

# service-omni-queue-members-assign

Bind N agent users into a Salesforce Queue via `GroupMember` Data API POSTs. Without queue membership, Omni-Channel routing sees an empty pool for the queue and never assigns work. Detection is SOQL-based (the same detect-then-POST shape as `service-omni-queue-routing-config-deploy`), so only missing memberships are created and the skill is safe to re-run. Agent users come from `service-omni-agent-users-create`, the queue from `service-omni-queue-deploy`, and the users' Omni permissions from `service-omni-permission-set-assign`.

## Inputs

```bash
bash scripts/verify-and-bind.sh <org-alias> [queue-developer-name=CaseQueue] [count=3] [explicit-members-csv]
# demo agents (default):
bash scripts/verify-and-bind.sh myorg CaseQueue 3
# real agents by username/id:
bash scripts/verify-and-bind.sh myorg VoiceQueue "" "[email protected],005XX000001abcd"
```

- `org-alias` (required).
- `queue-developer-name` (optional, default `CaseQueue`).
- `count` (optional, default `3`, range `1..10`) — must match the agent user count; ignored in explicit mode.
- `explicit-members-csv` (optional 4th positional, or `MEMBER_USERNAMES_CSV` / `MEMBER_USER_IDS_CSV`) — each token is a Username or a 15/18-char User Id; the count is derived from the list.

## Preconditions and safety

- Target org authenticated via `sf` CLI (My Domain URL), Service Cloud license, `sf` CLI ≥ 2.139.6.
- The executing user has `PermissionsModifyAllData` (standard on System Administrator).
- The agent users exist (`service-omni-agent-users-create`) and the queue exists (`service-omni-queue-deploy`); a missing user set or queue blocks with a pointer to the right skill (queues cannot be created via the Data API).
- The three-way `safe_to_write` production guard applies — adding users to a production queue mis-routes real customer work, so it blocks with no override.

## Run

`verify-and-bind.sh` runs the whole cycle:

1. Compute `safe_to_write`; derive the 8-char org suffix.
2. Resolve the queue `Group.Id` by DeveloperName + `Type='Queue'`; block if missing.
3. Resolve the member set — generated mode queries `User` for `agent{1..N}.<suffix>@example.com` (block if any expected user is missing); explicit mode resolves each supplied token and requires every one to be an ACTIVE user.
4. Query existing `GroupMember` for the queue; compute the users not yet bound.
5. POST one `GroupMember` per missing user (individual POSTs, no `allOrNone`).
6. Re-query to confirm final membership and emit the report.

## Behavior

**Two member sources, never mixed.** The default generated pattern keeps the user-create → member-assign handoff deterministic; explicit mode is opt-in for real agents and takes over count derivation. In explicit mode, a token that does not resolve to an active user blocks the run — binding a typo'd or inactive user would silently under-populate the queue.

**Idempotency and honesty.** POSTs are individual so one failed binding (e.g. a race with another admin) never rolls back its successful siblings, and the skill re-queries after all POSTs — a 201 only means the write was accepted; a subsequent SOQL confirms the row is visible to the routing engine. The `before` snapshot includes members already present, even non-demo users added out-of-band, so the coordinator can see full membership state.

**Non-destructive.** Create-only; it never removes or reassigns existing members.

## Output contract

A single JSON object with `status` ∈ `bound` | `reused` | `partial` | `blocked`, the resolved `queue`, `org_suffix`, `member_source` (`generated_pattern` | `explicit`), `requested_count`, a `before` snapshot, `bound_this_run`/`bound_count`, `reused_count`, an `after` snapshot, `manual_actions`, and `blocking_issue`.

- `bound` — at least one new member created; final state matches the expected count.
- `reused` — all expected users were already members; nothing POSTed.
- `partial` — some POSTs failed; the re-query shows fewer members than requested (details in `blocking_issue`).
- `blocked` — precondition failed (production org, missing queue, missing users, missing permissions).

`bound_count + reused_count == requested_count` unless `partial`; `blocking_issue` is non-null only for `blocked`/`partial`.

## Limitations

- Generated and explicit modes are mutually exclusive per run.
- Create-only; removing or reassigning members is out of scope.
- Does not create the queue or the users, and does not assign permission sets or presence configs.

## References

| File | When to read |
|---|---|
| `references/api-notes.md` | Before the detect/bind cycle — GroupMember schema, the queue-vs-public-group distinction, why `UserOrGroupId` is polymorphic, and common POST failures |
| `scripts/tests/test_queue_members_contracts.py` | When validating changes — run `python3 scripts/tests/test_queue_members_contracts.py` from this skill directory |

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

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

Все скиллы по теме «Облака: AWS, Azure, GCP» →
salesforce jdrhyne Скилл водит Salesforce CLI вместо вас: SOQL и SOSL, чтение и правка записей, bulk-выгрузка, Apex и метаданные прямо из чата Claude. CX Codex +1 ★ 239звёзд репо Salesforce Apex & Triggers Development официальный github Субагент Salesforce Apex & Triggers Development генерирует надёжный Apex-код и триггеры для Salesforce с учётом лимитов платформы. Субагент проверяет архитектуру проекта, избегает догадок и сразу пишет тесты. CX Codex +1 ★ 41 430звёзд репо salesforce-apex-quality официальный github Скилл salesforce-apex-quality проверяет Apex-код на риски governor limits, проблемы безопасности и пробелы в тестах. Подходит для ревью классов, триггеров и тестовых классов. CX Codex +1 884установок Salesforce Cloud aaronsb MCP-сервер Salesforce Cloud подключает Salesforce к Claude Code, Cursor, Codex и другим агентам через SOQL-запросы и анализ сделок. Агент читает воронку, находит похожие выигранные сделки и генерирует бизнес-кейсы прямо в чате. CX Codex +1 ★ 6звёзд репо 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установок

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

Весь набор →
dx-lifecycle-center Скилл dx-lifecycle-center для Claude Code и других платформ, который управляет соединениями с организациями Salesforce и разворачивает метаданные. Запускается при командах подключения сред или переноса компонентов. CX Codex +1 110установок service-omni-queue-routing-config-deploy Скилл service-omni-queue-routing-config-deploy для Claude Code создаёт или обновляет настройки маршрутизации очередей Omni-Channel в Salesforce. Запускается при настройке очереди для Case или Voice и при развёртывании QueueRoutingConfig. CX Codex +1 108установок platform-metadata-discovery-get Скилл platform-metadata-discovery-get для Claude Code выясняет, какие метаданные уже есть в Salesforce org. Он подключается перед изменением метаданных или написанием кода, который на них ссылается. CX Codex +1 107установок service-omni-service-channel-configure Скилл service-omni-service-channel-configure для Claude Code находит или создаёт ServiceChannel для Case, Incident, MessagingSession или VoiceCall. Запускается при настройке Omni-Channel. CX Codex +1 106установок 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установок

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

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