Merge 797ff42 into feature/object-relabel

Salesforce-org-Impact-Labs · Jul 21, 2020 · cfbd49b · cfbd49b
2 parents 75a16d5 + 797ff42
commit cfbd49b
Show file tree

Hide file tree

Showing 13 changed files with 118 additions and 1 deletion.
diff --git a/docs/images/Complete_Email_Service.png b/docs/images/Complete_Email_Service.png
diff --git a/docs/images/Confirm_Address_Task.png b/docs/images/Confirm_Address_Task.png
diff --git a/docs/images/Confirm_Message.png b/docs/images/Confirm_Message.png
diff --git a/docs/images/Create_Org_Wide_Email.png b/docs/images/Create_Org_Wide_Email.png
diff --git a/docs/images/Custom_Metadata_Type.png b/docs/images/Custom_Metadata_Type.png
diff --git a/docs/images/My_Tasks.png b/docs/images/My_Tasks.png
diff --git a/docs/images/New_Email_Address.png b/docs/images/New_Email_Address.png
diff --git a/docs/images/New_Email_Service.png b/docs/images/New_Email_Service.png
diff --git a/docs/images/Referral_Recommendations_Setting.png b/docs/images/Referral_Recommendations_Setting.png
diff --git a/docs/images/Validate_Email_Address.png b/docs/images/Validate_Email_Address.png
diff --git a/docs/messaging-setup.md b/docs/messaging-setup.md
@@ -2,3 +2,83 @@
 
 Temporary docs in quip
 <https://salesforce.quip.com/DrwyASzKil86>
+
+# Configuring an Email Service for the Client Recommendations Inbound Email Handler
+
+This may feel like lot to do and it may force you to visit screens with which you aren’t usually familiar, but take heart - this is a one-time task that should take you only about 15 minutes.
+
+## Create the Email Service
+
+Search setup for “Email Services”, then create a New Email Service
+<img alt="New Email Services" src="https://raw.githubusercontent.com/Salesforce-org-Impact-Labs/01HousingandHomelessness/f2b468ebdbab7af8014edfb96ab8c299f129a42e/docs/images/New_Email_Service.png">
+
+* The Service Name can be anything meaningful. Here, we’ve used “Client Referral Email Service”
+* The Apex Class must be **RecommendationsInboundEmailHandler**
+* Be sure to check the box to make the service Active!
+
+### Create a new Email Address
+
+<img alt="New Email Address" src="https://raw.githubusercontent.com/Salesforce-org-Impact-Labs/01HousingandHomelessness/e26879b1ed4e5eac1ea75f8a7470171f25b3c998/docs/images/New_Email_Address.png">
+
+
+* Email Address Name and Email Address: We’ve kept the email name and address consistent with the name of the email service, but that isn’t necessary. You can give it any name that is meaningful to you.
+* Be sure to Activate the address
+* Context User: Choose a user that has System Administrator privileges. This user will be the owner of any record created by the inbound email handler.
+    * We suggest that you create a special User for this purpose, one that would never become Inactive.
+
+## Create the Org Wide Email Address
+
+After the Email Address is created, we need to make it an Org-Wide Email so that we can use this email address as the “Reply-To” email in our messages to the Client.
+<img alt="Complete Email Service" src="https://raw.githubusercontent.com/Salesforce-org-Impact-Labs/01HousingandHomelessness/549b88e7011090585790152d3efcf8c5b7296899/docs/images/Complete_Email_Service.png">
+Get the email address, create an org-wide email for that address. **Hint**: name it something to match your organization!
+
+Search Setup for “Organization-Wide Email Address”
+
+<img alt="Org Wide Email" src="https://raw.githubusercontent.com/Salesforce-org-Impact-Labs/01HousingandHomelessness/0afb930a541025b8ed67dec8d827c510a355034c/docs/images/Create_Org_Wide_Email.png">
+
+1. Choose a meaningful Display Name - perhaps the name of your organization - this will appear as the Sender for messages that are sent by the system.
+2. Copy the Email Address created above, when you were setting up the Email Service - it will be a very long email address.
+3. Choose the profiles that may use this address - be sure you include the Profile of the Context User.
+
+## Confirm the Organization-Wide Email Address
+
+In order for the Organization-Wide email be be activated, that email address must first be validated.
+
+<img alt="Validate Email Address" src="https://raw.githubusercontent.com/Salesforce-org-Impact-Labs/01HousingandHomelessness/3038a4fad16030a64ade1afff849dbd93c0f26c8/docs/images/Validate_Email_Address.png">
+
+Because the “recipient” of this org-wide email is the system itself, we’ve tried to make it easy for you to validate the address.
+
+When the Email Service handler code receives a request to validate the email address, it will create a Task. This Task will be assigned to the Context User that you’ve specified above, when you created the Email Address.
+
+
+1. Log in as the Context User and navigate to the Home tab, where you can view the Tasks that have been assigned to this user.
+2. Open the special Task by clicking on the Subject, “Confirm Organization-Wide Email Address”
+
+<img alt="My Tasks" src="https://raw.githubusercontent.com/Salesforce-org-Impact-Labs/01HousingandHomelessness/29e4326b8c7a0af7460c32b12c69065b1161b7e6/docs/images/My_Tasks.png">
+
+1. The Comments of the task will contain the text of the verification email. In the text will be a link to confirm the Organization-Wide Email Address. Click the link or copy and paste it into a browser to confirm the address.
+
+<img alt="Confirm Address Task" src="https://raw.githubusercontent.com/Salesforce-org-Impact-Labs/01HousingandHomelessness/37a1434f10e3ace13d2b82e7e4c328f6d5c22ae4/docs/images/Confirm_Address_Task.png">
+
+When the link is clicked or entered into a browser, you should see a success message
+
+<img alt="Success Message" src="https://raw.githubusercontent.com/Salesforce-org-Impact-Labs/01HousingandHomelessness/48bb79badf73359649ef86a1101fe5bd176e50d2/docs/images/Confirm_Message.png">
+
+## Configure the Email in the Custom Metadata Type Record
+
+Use the Quick Find capability in setup to search for “Custom Metadata Types”. Once you’re on the “All Custom Metadata Types” page, click the “Manage Records” link for the Referral Recommendations Setting custom metadata type. 
+
+<img alt="Custom Metadata Type" src="https://raw.githubusercontent.com/Salesforce-org-Impact-Labs/01HousingandHomelessness/282de7c81db1fde98e14fda74481067db3501d7f/docs/images/Custom_Metadata_Type.png">
+
+Edit the Organization Default record, then enter the email service’s email address into the “Recommendations Email Service Address” field.
+
+<img alt="Referral Recommendations Setting" src="https://raw.githubusercontent.com/Salesforce-org-Impact-Labs/01HousingandHomelessness/282de7c81db1fde98e14fda74481067db3501d7f/docs/images/Referral_Recommendations_Setting.png">
+
+# Schedule the Batch Jobs
+
+There are two batch jobs that need to run to send referrals and referral followup messages to clients.
+
+* Batch_SendInitialClientReferrals
+* Batch_SendReferralFollowupReminders
+
+These batch classes should execute at least once per day. Please follow the instructions in the Help documentation to schedule the classes: https://help.salesforce.com/articleView?id=code_schedule_batch_apex.htm&type=5
diff --git a/force-app/main/default/classes/RecommendationsInboundEmailHandler.cls b/force-app/main/default/classes/RecommendationsInboundEmailHandler.cls
@@ -7,10 +7,16 @@ global class RecommendationsInboundEmailHandler implements Messaging.InboundEmai
     public static final String EMAIL_REPLY_HELP = 'HELP';
     public static final Integer RESPONSE_TRUNCATION_LEN = 10;
 
+    // key string to find the org-wide email verification link
+    public static final String CONFIRM_EMAIL_LINK_KEY = 'Click this link to confirm this Organization-Wide Email Address:';
 
     global Messaging.InboundEmailResult handleInboundEmail(Messaging.InboundEmail email, Messaging.InboundEnvelope envelope) {
         Messaging.InboundEmailResult result = new Messaging.InboundEmailresult();
-        System.debug('RecommendationsInboundEmailHandler received text of email '+email.plainTextBody);
+
+        // create a task for the org-wide email address verification link
+        if (email.plainTextBody.containsIgnoreCase(CONFIRM_EMAIL_LINK_KEY)) {
+            createEmailConfirmTask(email.plainTextBody);
+        }
 
         if (email.plainTextBody.containsIgnoreCase(EMAIL_REFERRAL_RESPONSE_TOKEN)) {
             // get the referral response id from the body of the reply
@@ -95,6 +101,21 @@ global class RecommendationsInboundEmailHandler implements Messaging.InboundEmai
 
       }
 
+      @TestVisible
+      private static void createEmailConfirmTask(String emailBody) {
+        // get the running user
+        Id runningUserId = UserInfo.getUserId();
+
+        // create the task and assign it to the user
+        Task confirmTask = new Task();
+        confirmTask.Subject = 'Confirm Organization-Wide Email Address';
+        confirmTask.Status = 'Not Started';
+        confirmTask.OwnerId = runningUserId;
+        confirmTask.Description = emailBody;
+
+        insert confirmTask;
+      }
+
       @TestVisible
       private static Referral_Response__c getReferralResponse(String referralResponseId) {
         Referral_Response__c response = new Referral_Response__c();  

diff --git a/force-app/main/default/classes/Test_RecommendationsInboundEmailHandler.cls b/force-app/main/default/classes/Test_RecommendationsInboundEmailHandler.cls
@@ -182,6 +182,22 @@ public class Test_RecommendationsInboundEmailHandler {
         System.assertEquals('How are you',refRespCheck.Question__c);
     }
 
+    static testMethod void testCreateEmailConfirmTask() {
+        Test.startTest();
+        RecommendationsInboundEmailHandler.createEmailConfirmTask('body of email');
+        Test.stopTest();
+
+        Task confirmTask = [
+            SELECT
+                Id,
+                Description
+            FROM Task
+            WHERE Subject = 'Confirm Organization-Wide Email Address'
+        ][0];
+
+        System.assertEquals('body of email', confirmTask.Description);
+    }
+
     static Referral_Response__c getReferralResponse() {
         List<Referral_Response__c> responses = [
             SELECT