Skip to content

forcedotcom/sf-skills / plugins/builder/service-engagement/skills/service-digital-engagement-deployment-configure

service-digital-engagement-deployment-configure

Verified

Configures Embedded Messaging Deployments for Messaging for In-App and Web (MIAW). Use when the user needs to create a new embedded messaging deployment from scratch using Connect API with defaults, or update an existing deployment's settings using Metadata API. Produces Connect API request payloads for new deployments and EmbeddedServiceConfig metadata XML for updates. TRIGGER when the user mentions embedded messaging deployment, embedded service deployment, MIAW deployment, messaging widget setup, chat widget configuration, embedded chat deployment, or references a .EmbeddedServiceConfig-meta.xml file. DO NOT TRIGGER when the user is creating a messaging channel (use service-digital-engagement-channel-configure), configuring legacy Live Agent embedded service, or generating the JavaScript code snippet for website embedding.

references/branding_and_tooling.md

View on GitHub
# Branding Configuration via Tooling API

A BrandingSet with default values is **automatically created** when a Web deployment is created via Connect API. **Branding is only applicable for Web deployment types** — API and Mobile deployments do not support branding.

To override specific branding properties (colors, fonts, dimensions, images), use the Tooling API to update individual `BrandingSetProperty` records.

---

## Updating Branding Properties via Tooling API

Query the existing BrandingSet properties, then update specific values:

```bash
sf data query --query "SELECT Id, PropertyName, PropertyValue FROM BrandingSetProperty WHERE BrandingSetId IN (SELECT Id FROM BrandingSet WHERE DeveloperName='<BRANDING_SET_NAME>')" --target-org <org-alias> --tooling-api
```

Update a specific property:

```bash
sf data update record --sobject BrandingSetProperty --where "Id='<PROPERTY_ID>'" --values "PropertyValue='<NEW_VALUE>'" --target-org <org-alias> --tooling-api
```

---

## Available Branding Properties

### Colors (hex format)

| Property Name | Description | Default |
|--------------|-------------|---------|
| `primaryText` | Primary text color | `#2E2E2E` |
| `secondaryText` | Secondary text color | `#5C5C5C` |
| `alert` | Alert/error color | `#D72E2D` |
| `headerBackground` | Chat header background | `#FFFFFF` |
| `headerForeground` | Chat header text/icons | `#2E2E2E` |
| `conversationBodyBackground` | Chat body background | `#FFFFFF` |
| `userMessageBackground` | User message bubble background | `#2E2E2E` |
| `userMessageText` | User message text color | `#FFFFFF` |
| `userMessageLink` | User message link color | `#FFFFFF` |
| `agentMessageBackground` | Agent message bubble background | `#F3F3F3` |
| `agentMessageText` | Agent message text color | `#2E2E2E` |
| `agentMessageLink` | Agent message link color | `#0469C1` |
| `primaryButtonBackground` | Primary button background | `#2E2E2E` |
| `primaryButtonText` | Primary button text color | `#FFFFFF` |
| `inputOutline` | Input field border color | `#C9C9C9` |
| `inputFooterButton` | Input footer button color | `#2E2E2E` |
| `chatButton` | Chat launcher button color | `#2E2E2E` |
| `invitationText` | Chat invitation text color | `#FFFFFF` |
| `invitationDismissalButton` | Invitation dismiss button color | `#AEAEAE` |
| `citationsBackground` | Citations section background | `#FFFFFF` |
| `citationsText` | Citations text color | `#181818` |

### Dimensions (string values)

| Property Name | Description | Default |
|--------------|-------------|---------|
| `height` | Chat window height in pixels | `480` |
| `width` | Chat window width in pixels | `320` |

### Typography

| Property Name | Description | Default |
|--------------|-------------|---------|
| `font` | Font family | `Arial` |
| `baseFontSize` | Base font size | `Medium` |

### Images (URL values — leave empty for no image)

| Property Name | Description |
|--------------|-------------|
| `avatarImage` | Agent avatar image URL |
| `logoImage` | Company logo URL |
| `fabImage` | Floating action button image URL |
| `botImage` | Bot/AI avatar image URL |

---

## BrandingSet Association

The BrandingSet is automatically referenced in the `EmbeddedServiceConfig` XML via the `<branding>` field:

```xml
<branding>My_BrandingSet</branding>
```

This association is set up automatically during Connect API creation — no manual configuration needed.

---

## Constraints

- Image URLs must point to actual image files (not plain domain names) or be left empty
- Color values: hex format only (`#FFFFFF`)
- Dimension values are strings, not integers (`"480"` not `480`)
- `type` must be `es-messaging` for Embedded Messaging branding sets
- `baseFontSize` valid values: `Small`, `Medium`, `Large`
- Font values: `"Arial"`, `"Salesforce Sans"`, `"Georgia"`, `"Comic Sans MS"`, etc.
- Publishing (Connect API) is required after branding changes for them to take effect in the widget
writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deploymentStars: 323kUpdated Claude CodeCodexVerifiedInstall
xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release.Stars: 118kUpdated Claude CodeCodexVerifiedInstall