feat: add Agentforce Service Agent

.forceignore

@@ -11,7 +11,10 @@ package.xml
 **/flowDefinitions/**
 **/objectTranslations/**
 **/profiles/**
+**/profilePasswordPolicies/**
+**/profileSessionSettings/**
 **/settings/**
+**/sharingRules/**
 
 # Data Cloud metadata
 **/activationPlatforms/**

README.md

@@ -77,7 +77,7 @@ If you need to [update the Salesforce CLI](https://developer.salesforce.com/docs
 1. Deploy the app metadata.
 
     ```bash
-    sf project deploy start
+    sf project deploy start -d force-app
     ```
 
 1. Assign the Coral Cloud permission set to the default user.
@@ -101,7 +101,7 @@ If you need to [update the Salesforce CLI](https://developer.salesforce.com/docs
 1. Install a Data Kit to add Data Cloud components to your org.
 
     ```bash
-    sf package install -p 04tHr000000ku0X -w 10
+    sf package install -p 04tHr000000ku4k -w 10
     ```
 
 1. If your org isn't already open, open it now:

apex-scripts/setup-agent-user.apex

@@ -0,0 +1 @@
+SetupServiceAgentUser.setup();

bin/install-service.sh

@@ -0,0 +1,83 @@
+#!/bin/bash
+SCRIPT_PATH=$( cd "$(dirname "${BASH_SOURCE[0]}")" ; pwd -P )
+cd $SCRIPT_PATH/..
+
+echo ""
+echo "Installing Coral Cloud - Service"
+echo ""
+
+# Ensure that jq is installed
+if ! command -v jq 2>&1 >/dev/null
+then
+    echo "jq could not be found. Please install it from https://jqlang.github.io/jq/"
+    exit 1
+fi
+
+# Get default org alias
+VALUE_REGEX='"value": "([a-zA-Z0-9_\-]+)"'
+DEFAULT_ORG_INFO=$(sf config get target-org --json)
+if [[ $DEFAULT_ORG_INFO =~ $VALUE_REGEX ]]
+then
+    ORG_ALIAS="${BASH_REMATCH[1]}"
+    echo "Using current default org: $ORG_ALIAS"
+    echo "Exporting org alias and subdomain for use in scripts:"
+    ORG_INFO=$(sf org display --json)
+    export SF_CC_PLACEHOLDER_USERNAME=$(echo $ORG_INFO | jq -r '.result | .username')
+    echo "- Username: $SF_CC_PLACEHOLDER_USERNAME"
+    export SF_CC_PLACEHOLDER_DOMAIN=$(echo $ORG_INFO | jq -r '.result | .instanceUrl | sub("https?://"; "") | split(".")[0]')
+    echo "- Domain:   $SF_CC_PLACEHOLDER_DOMAIN"    
+    echo ""
+else
+    echo "Installation failed: could not retrieve default org alias."
+    exit 1
+fi
+
+echo "Pushing Service Agent Setup source..." && \
+sf project deploy start -d cc-service-app/main/setup/classes/SetupServiceAgentUser.cls -d cc-service-app/main/default/permissionSets/Coral_Cloud_Service_Agent.permissionset-meta.xml && \
+echo "" && \
+
+echo "Setting up Service Agent user..." && \
+sf apex run -f apex-scripts/setup-agent-user.apex && \
+echo "" && \
+
+echo "Pushing source..." && \
+export SF_CC_PLACEHOLDER_FLOW_AGENT_ID="DummyForInitialDeploy" && \
+export SF_CC_PLACEHOLDER_FLOW_CHANNEL_ID="DummyForInitialDeploy" && \
+export SF_CC_PLACEHOLDER_FLOW_QUEUE_ID="DummyForInitialDeploy" && \
+sf project deploy start -d cc-service-app && \
+echo "" && \
+
+echo "Redeploying flow metadata with org specific values..." && \
+export SF_CC_PLACEHOLDER_FLOW_AGENT_ID=$(sf data query --query "SELECT Id from BotDefinition WHERE DeveloperName='Coral_Cloud_Agent'" --json | jq -r '.result | .records[0] | .Id') && \
+echo "Agent ID: $SF_CC_PLACEHOLDER_FLOW_AGENT_ID" && \
+export SF_CC_PLACEHOLDER_FLOW_CHANNEL_ID=$(sf data query --query "SELECT Id from ServiceChannel WHERE DeveloperName='sfdc_livemessage'" --json | jq -r '.result | .records[0] | .Id') && \
+echo "Channel ID: $SF_CC_PLACEHOLDER_FLOW_CHANNEL_ID" && \
+export SF_CC_PLACEHOLDER_FLOW_QUEUE_ID=$(sf data query --query "SELECT Id FROM Group WHERE Type = 'Queue' AND Name = 'Messaging Queue'" --json | jq -r '.result | .records[0] | .Id') && \
+echo "Queue ID: $SF_CC_PLACEHOLDER_FLOW_QUEUE_ID" && \
+sf project deploy start -d cc-service-app/main/default/flows/Route_to_Agent.flow-meta.xml cc-service-app/main/default/flows/Route_to_Queue.flow-meta.xml && \
+echo "" && \
+
+echo "Publishing Experience Cloud site..." && \
+sf community publish --name 'coral cloud' && \
+echo "" && \
+
+echo "Deploying guest profile for Experience Cloud site..." && \
+sf project deploy start --metadata-dir=guest-profile-metadata -w 10 && \
+echo "" && \
+
+echo "Opening org..." && \
+sf org open -p /lightning/setup/LiveMessageSetup/home && \
+echo ""
+EXIT_CODE="$?"
+
+# Check exit code
+echo ""
+if [ "$EXIT_CODE" -eq 0 ]; then
+  echo "Installation completed."
+  echo ""
+  echo "Experience Cloud URL: https://${SF_CC_PLACEHOLDER_DOMAIN}.develop.my.site.com/"
+  echo ""
+else
+    echo "Installation failed."
+fi
+exit $EXIT_CODE

bin/install.sh

@@ -3,7 +3,7 @@ SCRIPT_PATH=$( cd "$(dirname "${BASH_SOURCE[0]}")" ; pwd -P )
 cd $SCRIPT_PATH/..
 
 echo ""
-echo "Installing Coral Cloud"
+echo "Installing Coral Cloud - Base"
 echo ""
 
 # Get default org alias
@@ -52,7 +52,7 @@ then
 fi
 
 echo "Pushing source..." && \
-sf project deploy start && \
+sf project deploy start -d force-app && \
 echo "" && \
 
 echo "Assigning permission sets..." && \
@@ -68,7 +68,7 @@ sf apex run -f apex-scripts/setup.apex && \
 echo "" && \
 
 echo "Installing Data Kit..." && \
-sf package install -p 04tHr000000ku0X -w 10 && \
+sf package install -p 04tHr000000ku4k -w 10 && \
 echo "" && \
 
 echo "Opening org..." && \

cc-service-app/main/default/EmbeddedServiceConfig/Agent_Web_Deployment.EmbeddedServiceConfig-meta.xml

@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<EmbeddedServiceConfig xmlns="http://soap.sforce.com/2006/04/metadata">
+    <areGuestUsersAllowed>false</areGuestUsersAllowed>
+    <deploymentFeature>EmbeddedMessaging</deploymentFeature>
+    <deploymentType>Web</deploymentType>
+    <embeddedServiceMessagingChannel>
+        <isEnabled>true</isEnabled>
+        <messagingChannel>Agent_Channel</messagingChannel>
+        <shouldShowDeliveryReceipts>false</shouldShowDeliveryReceipts>
+        <shouldShowEmojiSelection>false</shouldShowEmojiSelection>
+        <shouldShowReadReceipts>false</shouldShowReadReceipts>
+        <shouldShowTypingIndicators>false</shouldShowTypingIndicators>
+        <shouldStartNewLineOnEnter>false</shouldStartNewLineOnEnter>
+    </embeddedServiceMessagingChannel>
+    <isEnabled>true</isEnabled>
+    <isTermsAndConditionsEnabled>false</isTermsAndConditionsEnabled>
+    <isTermsAndConditionsRequired>false</isTermsAndConditionsRequired>
+    <masterLabel>Agent Web Deployment</masterLabel>
+    <shouldHideAuthDialog>false</shouldHideAuthDialog>
+    <site>ESW_Agent_Web_Deployment_17296990144201</site>
+</EmbeddedServiceConfig>

cc-service-app/main/default/bots/Coral_Cloud_Agent/Coral_Cloud_Agent.bot-meta.xml

@@ -0,0 +1,158 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<Bot xmlns="http://soap.sforce.com/2006/04/metadata">
+    <agentType>EinsteinServiceAgent</agentType>
+    <botMlDomain>
+        <label>Coral Cloud Agent</label>
+        <name>Coral_Cloud_Agent</name>
+    </botMlDomain>
+    <botUser>agent-%%SF_CC_PLACEHOLDER_USERNAME%%</botUser>
+    <contextVariables>
+        <contextVariableMappings>
+            <SObjectType>MessagingEndUser</SObjectType>
+            <fieldName>MessagingEndUser.ContactId</fieldName>
+            <messageType>EmbeddedMessaging</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingEndUser</SObjectType>
+            <fieldName>MessagingEndUser.ContactId</fieldName>
+            <messageType>Line</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingEndUser</SObjectType>
+            <fieldName>MessagingEndUser.ContactId</fieldName>
+            <messageType>AppleBusinessChat</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingEndUser</SObjectType>
+            <fieldName>MessagingEndUser.ContactId</fieldName>
+            <messageType>Text</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingEndUser</SObjectType>
+            <fieldName>MessagingEndUser.ContactId</fieldName>
+            <messageType>Facebook</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingEndUser</SObjectType>
+            <fieldName>MessagingEndUser.ContactId</fieldName>
+            <messageType>WhatsApp</messageType>
+        </contextVariableMappings>
+        <dataType>Id</dataType>
+        <developerName>ContactId</developerName>
+        <label>Contact Id</label>
+    </contextVariables>
+    <contextVariables>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.MessagingEndUserId</fieldName>
+            <messageType>Line</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.MessagingEndUserId</fieldName>
+            <messageType>EmbeddedMessaging</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.MessagingEndUserId</fieldName>
+            <messageType>WhatsApp</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.MessagingEndUserId</fieldName>
+            <messageType>Facebook</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.MessagingEndUserId</fieldName>
+            <messageType>Text</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.MessagingEndUserId</fieldName>
+            <messageType>AppleBusinessChat</messageType>
+        </contextVariableMappings>
+        <dataType>Id</dataType>
+        <developerName>EndUserId</developerName>
+        <label>End User Id</label>
+    </contextVariables>
+    <contextVariables>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.EndUserLanguage</fieldName>
+            <messageType>WhatsApp</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.EndUserLanguage</fieldName>
+            <messageType>Facebook</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.EndUserLanguage</fieldName>
+            <messageType>AppleBusinessChat</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.EndUserLanguage</fieldName>
+            <messageType>Line</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.EndUserLanguage</fieldName>
+            <messageType>EmbeddedMessaging</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.EndUserLanguage</fieldName>
+            <messageType>Text</messageType>
+        </contextVariableMappings>
+        <dataType>Text</dataType>
+        <developerName>EndUserLanguage</developerName>
+        <label>End User Language</label>
+    </contextVariables>
+    <contextVariables>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.Id</fieldName>
+            <messageType>Line</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.Id</fieldName>
+            <messageType>AppleBusinessChat</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.Id</fieldName>
+            <messageType>Text</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.Id</fieldName>
+            <messageType>WhatsApp</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.Id</fieldName>
+            <messageType>Facebook</messageType>
+        </contextVariableMappings>
+        <contextVariableMappings>
+            <SObjectType>MessagingSession</SObjectType>
+            <fieldName>MessagingSession.Id</fieldName>
+            <messageType>EmbeddedMessaging</messageType>
+        </contextVariableMappings>
+        <dataType>Id</dataType>
+        <developerName>RoutableId</developerName>
+        <label>Routable Id</label>
+    </contextVariables>
+    <defaultOutboundFlow>Route_to_Queue</defaultOutboundFlow>
+    <description
+    >This is the Coral Cloud Agent that helps customers learn more about Experiences as
+        well as book sessions.</description>
+    <label>Coral Cloud Agent</label>
+    <logPrivateConversationData>false</logPrivateConversationData>
+    <richContentEnabled>true</richContentEnabled>
+    <sessionTimeout>480</sessionTimeout>
+    <type>ExternalCopilot</type>
+</Bot>