service-de-headless-channel-configure
Installation
SKILL.md
Headless Channel Setup (type-agnostic)
What this skill does
Takes a channel type (WhatsApp | Line | AppleBusinessChat | Facebook | Text) plus its type-specific inputs and drives it to an activated MessagingChannel. It first gates on the Enhanced Messaging Terms and Conditions, then runs four core steps plus an optional settings step:
- Accept Terms and Conditions — renders the Enhanced Messaging disclaimer and requires the user to certify they have authority to bind their org, mirroring the in-org "Add a Channel" wizard. Blocking — a decline ends the run before any org work. (Stage 0.5, in this skill)
- Insert the channel — invokes
service-de-channel-create, which handles each type's third-party prereq (e.g. WhatsApp'sservice-de-waba-integrate). (skill:service-de-channel-create) - Configure routing — sets
SessionHandlerIdto an Omni-Channel Queue (pick existing or create new). Message-type-agnostic. (skill:service-de-channel-routing-configure) - Configure consent — ensures a valid
ConsentType+ matchingMsgChannelLanguageKeywordrecord (often a no-op: the insert auto-seedsImplicitOptIn). Activation's readiness check needs routing AND consent, so this runs before activation. (skill:service-de-channel-settings-configure) - Activate — PATCHes
MessagingChannelUsage.DeploymentStatustoProvisioning; the save-hook runs synchronously and returns 204 once the channel isIsActive=true. Message-type-agnostic. (skill:service-de-channel-activate) - Configure requested settings — only if the request asked for auto-responses, keywords, or session inactivity. Runs after activation and is non-blocking: a failure is a warning, never a failed run, and every requested setting is reported as configured, not applicable, or failed. (skill:
service-de-channel-settings-configure, Stage 4.5)
Resume-by-default. Each step is idempotent: a re-run detects existing state and skips steps that already succeeded.
Prompt mid-flow. A missing {MESSAGE_TYPE} is asked upfront; routing choices are prompted when step 2 runs.