implementing-ui-bundle-agentforce-conversation-client

Embeds AgentforceConversationClient React component in Salesforce UI bundle apps with styleTokens validation.

803|289|Updated Nov 7, 2025
One-click install
npx skills add https://github.com/forcedotcom/sf-skills --skill implementing-ui-bundle-agentforce-conversation-client-forcedotcom
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: implementing-ui-bundle-agentforce-conversation-client
Source: https://github.com/forcedotcom/sf-skills/tree/main/skills/implementing-ui-bundle-agentforce-conversation-client
Command: npx skills add https://github.com/forcedotcom/sf-skills --skill implementing-ui-bundle-agentforce-conversation-client-forcedotcom

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you add or update an Agentforce conversation client in a UI bundle app without building a custom chat UI or breaking unsupported styling approaches.

Core Features & Use Cases

  • Correctly embed the official client: Adds or updates the <AgentforceConversationClient /> usage via the canonical package import to implement chat widget functionality safely.
  • Deterministic validation of agentId: Ensures agentId matches the expected Salesforce ID format before applying changes.
  • Theme safely with styleTokens only: Applies all visual customization through the supported styleTokens prop rather than CSS, inline styles, or className.
  • Guides required Salesforce configuration: Calls out cookie and trusted-domain prerequisites so the embedded client can authenticate.

Quick Start

Implement the AgentforceConversationClient in the target file by importing it from @salesforce/ui-bundle-template-feature-react-agentforce-conversation-client and rendering it with your valid agentId, then theme it only via styleTokens.

Frequently Asked Questions about implementing-ui-bundle-agentforce-conversation-client

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I embed an Agentforce chat widget in a Salesforce UI bundle app?

To embed an Agentforce chat widget in a UI bundle app, import the AgentforceConversationClient React component from its canonical package and render it with a validated agentId. This adds chat functionality safely without building a custom UI.

What is the correct way to style an Agentforce chat widget in React?

The correct way to style an Agentforce chat widget is by applying visual customization exclusively through the supported styleTokens prop. You must avoid using custom CSS, inline styles, or className attributes to ensure safe and stable theming.

Do I need to validate the agentId when integrating AgentforceConversationClient?

Yes, you need to validate the agentId when integrating AgentforceConversationClient. The agentId must be deterministically validated to match the expected Salesforce ID format before applying any changes to ensure the client authenticates correctly.

What Salesforce configuration is required to authenticate an embedded Agentforce conversation client?

Authenticating an embedded Agentforce conversation client requires specific Salesforce configuration, including setting up cookie and trusted-domain prerequisites. These configurations must be completed so the embedded client can successfully authenticate with your org.

Can I use custom React components to modify the Agentforce chat UI in a UI bundle?

No, you should not create custom React components to modify the Agentforce chat UI. You must use the official component and apply only supported props to maintain compatibility and avoid breaking unsupported styling approaches.