Service De Channel Settings Configure

Configuring Channel Settings

What this skill does

Configures settings on an already-existing Enhanced MessagingChannel (identified by {CHANNEL_ID}), for any message type. It groups five facets; you only run the ones the caller asks for.

This skill is mixed-surface. Consent (facet 1) is written with the Data API on the live record. Facets 2–5 live only in the channel's metadata and are configured by retrieving the channel's .messagingChannel-meta.xml, editing it, and deploying it back. Verified live on sdb6 (2026-09): every Data/Connect/Tooling read of the facet-2–5 fields fails INVALID_TYPE/"No such column" — they are Metadata-API-only.

Per-type applicability is verified, not assumed (from a live retrieve of real channels of each type). Facets 2 and 3 are genuinely type-agnostic. Facet 4's four timeout fields appear only on MIAW; only isAgentMessageResetInactivityEnabled extends to Apple/Facebook, and SMS/WhatsApp/LINE carry no inactivity fields at all. Facet 5 appears only on MIAW channels that use pre-chat. Scope per-type accordingly — do not deploy a facet a type doesn't support.

When to use (TRIGGER)

Trigger this skill when the user wants to configure or change settings on a channel that already exists, e.g.:

• "set the opt-out keyword / consent type on my WhatsApp channel"
• "add a double opt-in confirmation to this messaging channel"
• "configure the initial / agent-engaged / help auto-response on my Apple channel"
• "add OptIn/OptOut/Help keywords to my Text channel"
• "set the session inactivity timeout / idle action on my MIAW channel"
• "change the auto-responses on channel 0MjXXXXXXXXXXXX"

DO NOT TRIGGER — hand off instead:

• Creating or deploying a new channel from a metadata XML file (MIAW / EmbeddedMessaging) → service-digital-engagement-channel-configure. That skill creates an Embedded Messaging channel from XML; this skill only configures a channel that already exists (it needs a live {CHANNEL_ID}, prefix 0Mj).
• Inserting a brand-new channel of any type → service-de-channel-create.
• Setting routing / queue / SessionHandler → service-de-channel-routing-configure.
• Flipping a channel live → service-de-channel-activate.

Where this fits

Part of the Enhanced-channel headless pipeline: service-de-channel-create → service-de-channel-routing-configure → this skill → service-de-channel-activate. Activation's readiness check requires both routing and consent, so at minimum run facet 1 before activating. The service-de-headless-channel-configure orchestrator sequences the pipeline automatically; invoke this skill directly to configure settings on their own. For the MIAW-specific channel-creation-from-XML flow, see the sibling service-digital-engagement-channel-configure.

Reference File Index

When NOT to use this skill

• The channel isn't Enhanced. These settings apply to PlatformType=Enhanced channels only. Stage 1 confirms this and stops otherwise.
• The channel doesn't exist yet. Run service-de-channel-create first; this skill expects a real MessagingChannel.Id (prefix 0Mj).
• You're configuring consent on an outbound-only channel. Outbound-only channels pass the consent-readiness check automatically — nothing to configure for facet 1.

Inputs (from caller)

• {CHANNEL_ID} — a 15/18-char MessagingChannel.Id (prefix 0Mj). Must already exist and be Enhanced.
• {FACETS} — optional; which facets to configure (consent, auto-responses, keywords, inactivity, parameters). If omitted, infer from the request or ask.
• {CONSENT_TYPE} — optional (facet 1); ImplicitOptIn | ExplicitOptIn | DoubleOptIn.
• {LANGUAGE} — optional; locale for keyword/response records (e.g. en_US). Default en_US.
• {ORG_ALIAS} — optional; sf target-org alias. Default: sf config get target-org.

Facet-specific values (prompts, keyword lists, response text, timeout minutes) are collected interactively per facet, or accepted if pre-supplied.

Output (to caller)

Success:

{"ok": true, "channelId": "0Mj...", "messageType": "WhatsApp",
 "facetsConfigured": ["consent","auto-responses"],
 "consent": {"consentType": "ExplicitOptIn", "languageKeywordId": "3Or...", "activationReady": true},
 "metadataDeploy": {"status": "Succeeded", "facets": ["auto-responses","keywords"]}}

No change needed / precondition / failure:

{"ok": true, "noop": true, "message": "Requested settings already configured"}
{"ok": false, "kind": "not-enhanced", "hint": "settings apply to Enhanced channels only; this channel is PlatformType=<x>"}
{"ok": false, "kind": "facet-not-applicable", "hint": "<facet> is not supported on <messageType> channels"}
{"ok": false, "kind": "channel-patch-failed" | "keyword-record-failed" | "metadata-deploy-failed" | "verify-failed", "message": "..."}

Stage 1: Read the channel and decide facets

Read the channel; confirm it exists and is Enhanced; capture MessageType (drives per-type applicability).

sf data query --target-org '{ORG_ALIAS}' \
  --query "SELECT Id, DeveloperName, PlatformType, MessageType, MessagingPlatformKey, ConsentType, OptInPrompt, DoubleOptInPrompt, IsRequireDoubleOptIn FROM MessagingChannel WHERE Id = '{CHANNEL_ID}'" \
  --json > /tmp/cs-channel.json

• Channel missing → halt: Error: Channel {CHANNEL_ID} not found — check the id, or run service-de-channel-create first.
• PlatformType != 'Enhanced' → emit {ok:false, kind:"not-enhanced", ...} and stop.

Decide which facets to run from {FACETS} or the request. For each requested facet, check per-type applicability (table above / references/channel-settings-facets.md); if a facet doesn't apply to this MessageType, emit {ok:false, kind:"facet-not-applicable", ...} for that facet (or skip it and note it) rather than deploying an unsupported field.

sf CLI is slow, not broken. Calls to this org routinely take 2–4 minutes (heavy CLI startup + slow round-trip). Run each sf command with a generous timeout; a slow return is normal, not a hang.