Skip to content

@W-19151918: 🚀 Shopper Agent Experience v3.0 ( GA ) - #3259

Merged
avinashkasipathy merged 9 commits into
developfrom
feature-shopper-agent-df-exp
Sep 17, 2025
Merged

@W-19151918: 🚀 Shopper Agent Experience v3.0 ( GA )#3259
avinashkasipathy merged 9 commits into
developfrom
feature-shopper-agent-df-exp

Conversation

@avinashkasipathy

@avinashkasipathy avinashkasipathy commented Sep 5, 2025 •
edited
Loading

Copy link
Copy Markdown

Description

This PR introduces enhancements to the Salesforce Commerce Cloud Shopper Agent Experience, adding comprehensive context support, localization capabilities, and improved user experience features.

✨ Features Included as part off these changes:

  • Localization & Internationalization - adds locale information from user sessions to hidden pre-chat fields sent to Service Cloud
  • Currency Support - adds currency information from user sessions to hidden pre-chat fields sent to Service Cloud
  • Conversational Contextual Experience - implements configuring the conversation starter pills sent from SFRA to MIAW via postMessage communication.

Types of Changes

  • Bug fix (non-breaking change that fixes an issue)
  • New feature (non-breaking change that adds functionality)
  • Documentation update
  • Breaking change (could cause existing functionality to not work as expected)
  • Other changes (non-breaking changes that does not fit any of the above)

Breaking changes include:

  • Removing a public function or component or prop
  • Adding a required argument to a function
  • Changing the data type of a function parameter or return value
  • Adding a new peer dependency to package.json

Changes

  • ShopperAgent Component: Core component that initializes and manages the embedded messaging service
  • Dynamic Script Loading: Lazy-loads the embedded messaging script only when enabled
  • Configuration Management: Environment-based configuration through COMMERCE_AGENT_SETTINGS
  • Pre-chat Data Population: Automatically populates chat fields with shopper context (site, locale, basket, user ID)
  • When enabled, sends search queries to the agent
  • Configurable via COMMERCE_AGENT_SETTINGS environment variable
  • Granular control over agent features:
    • enabled: Master toggle for the entire feature
    • askAgentOnSearch: Enables search integration
  • Full locale support for embedded messaging

How to Test-Drive This PR

  • (step1)

Checklists

General

  • Changes are covered by test cases
  • CHANGELOG.md updated with a short description of changes (not required for documentation updates)

Accessibility Compliance

You must check off all items in one of the follow two lists:

  • There are no changes to UI

or...

Localization

  • Changes include a UI text update in the Retail React App (which requires translation)

@avinashkasipathy
avinashkasipathy requested a review from a team as a code owner September 5, 2025 20:35
@avinashkasipathy avinashkasipathy added the skip changelog Skip the "Changelog Check" GitHub Actions step even if the Changelog.md files are not updated label Sep 5, 2025
@cc-prodsec

cc-prodsec commented Sep 5, 2025 •
edited
Loading

Copy link
Copy Markdown
Collaborator

🎉 Snyk checks have passed. No issues have been found so far.

✅ security/snyk check is complete. No issues have been found. (View Details)

✅ license/snyk check is complete. No issues have been found. (View Details)

shethj
shethj reviewed Sep 5, 2025
View reviewed changes
Comment thread packages/template-retail-react-app/app/components/_app/index.jsx
@SalesforceCommerceCloud SalesforceCommerceCloud deleted a comment from shethj Sep 6, 2025
@avinashkasipathy
avinashkasipathy force-pushed the feature-shopper-agent-df-exp branch from 258369d to 4dc4f7a Compare September 11, 2025 04:17
@shethj

shethj commented Sep 16, 2025

Copy link
Copy Markdown
Contributor

LGTM overall except for the ShopperAgent component props. We can add a migration guide for existing customers to make sure current implementations don't break. 👍

shethj
shethj previously approved these changes Sep 16, 2025
View reviewed changes
@avinashkasipathy
avinashkasipathy force-pushed the feature-shopper-agent-df-exp branch 2 times, most recently from 2ce1d19 to d88e0e6 Compare September 17, 2025 03:04
@avinashkasipathy avinashkasipathy removed the skip changelog Skip the "Changelog Check" GitHub Actions step even if the Changelog.md files are not updated label Sep 17, 2025
@avinashkasipathy
avinashkasipathy force-pushed the feature-shopper-agent-df-exp branch 3 times, most recently from 24fe15f to 92a2d87 Compare September 17, 2025 03:08
shethj
shethj reviewed Sep 17, 2025
View reviewed changes
Comment thread packages/template-retail-react-app/CHANGELOG.md Outdated
@@ -1,3 +1,7 @@
## v9.0.0-dev (Sep 17, 2025)

@shethj shethj Sep 17, 2025

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

v8.1.0-dev is the current dev version.
Continue to use that. We'll switch that dev version to a major version bump if needed when we release PWA Kit. We shouldn't have multiple active -dev versions

@avinashkasipathy
avinashkasipathy force-pushed the feature-shopper-agent-df-exp branch from 92a2d87 to d203b84 Compare September 17, 2025 14:46
@avinashkasipathy
avinashkasipathy merged commit e6c0f3e into develop Sep 17, 2025
42 checks passed
@avinashkasipathy
avinashkasipathy deleted the feature-shopper-agent-df-exp branch September 17, 2025 15:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@syedshehrozhussain syedshehrozhussain syedshehrozhussain approved these changes
@shethj shethj shethj approved these changes

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

6 participants

@avinashkasipathy @cc-prodsec @shethj @syedshehrozhussain @sf-jhalak-maheshwari @sf-avinash-kasipathy