Prerequisites
- Admin access to a Salesforce org with an Experience Cloud Help Center site
- The IrisAgent Salesforce package (first install: see the Salesforce data source guide)
- Access to the IrisAgent dashboard
1. Install or upgrade the package
The Case Deflector requires IrisAgent Sidebar v1.3.0 or later. Log in to the target org and install v1.5.0 over your current version:- Production or Developer org: Production installation link
- Sandbox org: Sandbox installation link
2. Grant Guest User access
Anonymous visitors run as the site’s Guest User, which needs access to the Apex proxy.- In Setup, go to Digital Experiences → All Sites.
- Click Workspaces next to your Help Center site, then Administration → Pages → Go to Force.com.
- Click Public Access Settings to open the Guest User profile.
- Under Enabled Apex Class Access, click Edit, add
IrisAgentAPIClient(oririsagentsf.IrisAgentAPIClientfor the namespaced package) and click Save.
https://frontend-api-server-v2.api.irisagent.com is active under Setup → Remote Site Settings.
3. Add the deflector to the Contact Support page
- In Setup, go to Digital Experiences → All Sites and click Builder for your Help Center site (for example, Default Help Center).
- Open the Contact Support page.
- Remove the Contact Support Form component.
- Drag IrisAgent Case Deflector from the Components panel into its place.
-
Optionally adjust its properties:
- Click Publish.
How visitors use it
- The visitor types in Subject and Description.
- After
minCharCountcharacters and adebounceMspause, the deflector shows AI Guidance (an answer with source links) and Related Articles. - The visitor clicks:
- Yes, this helped: the deflector closes and no case is created.
- No, I still need help: they go to
contactPageName, which shows the standard Contact Support Form.
Verify
- Open the published Help Center in a private window (as a Guest User) and go to Contact Support.
- Type at least 15 characters across Subject and Description.
- Confirm AI guidance and related articles appear.
- In DevTools Network, confirm the browser makes no direct calls to
frontend-api-server-v2.api.irisagent.com. Traffic should go through/services/data/....
Troubleshooting
Deflector does not appear: make sure you published (not just saved) in Experience Builder and the package is version 1.3.0 or later. No results or API errors: confirm the Remote Site Setting is active and the Guest User profile has Apex Class Access toIrisAgentAPIClient.
Need help? Email us.