AIReplyRecommendationsSettings Metadata in SFDX

Architectural Overview#

Einstein Reply Recommendations analyzes past chat and messaging transcripts to suggest relevant Quick Text responses to Service Cloud agents in real time. The AIReplyRecommendationsSettings metadata type (AIReplyRecommendations.settings-meta.xml) governs the org-level feature switch for this capability.

By including AIReplyRecommendationsSettings in your SFDX repository, you ensure that Service Cloud sandboxes and scratch orgs have the feature enabled before deploying downstream Lightning Record Pages or Quick Text folders that depend on the Einstein Replies component.

SFDX Directory & File Suffix#

Key Metadata Fields#

Declarative XML & package.xml Examples#

Sample AIReplyRecommendations.settings-meta.xml#

<?xml version="1.0" encoding="UTF-8"?>
<AIReplyRecommendationsSettings xmlns="http://soap.sforce.com/2006/04/metadata">
    <enableReplyRecommendations>true</enableReplyRecommendations>
</AIReplyRecommendationsSettings>

Sample package.xml Manifest#

<?xml version="1.0" encoding="UTF-8"?>
<Package xmlns="http://soap.sforce.com/2006/04/metadata">
    <types>
        <members>AIReplyRecommendations</members>
        <name>Settings</name>
    </types>
    <version>68.0</version>
</Package>

SFDX CLI Retrieval & Deployment#

Retrieve and deploy AIReplyRecommendationsSettings via the Salesforce CLI:

# Retrieve Einstein Reply Recommendations settings
sf project retrieve start --metadata "Settings:AIReplyRecommendations"

# Deploy the settings to enable Einstein Reply Recommendations
sf project deploy start --metadata "Settings:AIReplyRecommendations"

Senior Architect Best Practices & Gotchas#

• Quick Text Folder Sharing: Recommended replies are stored as standard QuickText records. After enabling AIReplyRecommendationsSettings, ensure your support agents have read access to the published Quick Text folder and the Einstein Reply Recommendations system permission via a PermissionSet.
• Transcript Volume Prerequisite: Predictive reply models require at least 1,000 closed chat/messaging transcripts with 4+ turns to train in a new org; for orgs with lower transcript history, consider generative Einstein Service Replies instead.

Frequently asked questions

What does AIReplyRecommendationsSettings control in Salesforce?

It controls the org-wide enablement and operational toggles for Einstein Reply Recommendations, which suggests real-time responses to Service Cloud support agents.

Where is AIReplyRecommendationsSettings stored in SFDX?

It is stored at force-app/main/default/settings/AIReplyRecommendations.settings-meta.xml and referenced in package.xml under Settings with member AIReplyRecommendations.

Does enabling AIReplyRecommendationsSettings immediately show replies to agents?

No, enabling the setting activates the feature in Setup, after which you must build or activate the reply model, publish Quick Text responses, and assign permission sets.

How do I retrieve AIReplyRecommendationsSettings using Salesforce CLI?

Run sf project retrieve start --metadata Settings:AIReplyRecommendations to retrieve the settings file into your project.