Configure Salesforce for Forethought Triage

Mature support organizations often face the challenge of time-consuming yet vital ticket triage processes. These processes typically require the most experienced representatives to perform the task, which can be both costly and inefficient.

Technical Overview

This article will guide you through setting up your Salesforce Instance for Triage.

Pre-requisite: If you are a new customer, make sure to have completed the Salesforce pre-installation guide. 

The general flow is the following:

1. A case is created in Salesforce.
2. A new case has been detected, which triggers an outbound message in Salesforce.
3. The Salesforce Outbound Message sends the relevant information to Forethought.
4. Forethought analyzes the data and generates a prediction, which it writes back to a custom field in the object.
5. The Dashboard provides insights into the accuracy of the predictions by comparing the predicted value to the final user value.

Step 1: Initial setup 

Create Outbound Message

1. Name: Forethought Outbound Message
2. Unique Name: Forethought_Outbound_Message
3. Description: "Sends a message to Forethought API every time a case is created in order to make predictions. This outbound message is called by the workflow rule of the same name."
4. Endpoint URL: https://app.forethought.ai/salesforce/case-created
5. User to send as: Look for "Forethought user" or "Agatha". You should have a dedicated user for Forethought already set up
6. Send Session ID: True
7. Case Fields to send: id

   

8. Click Save > Done.
9. This will bring you back to the Workflow rule.
10. Click the Activate button.

Create Flow Rules

1. Go to Salesforce Setup > Flows.
2. Click > New flow > Record-Triggered Flow
3. Object: Case
4. Configure Trigger: A record is created
5. Optimize the Flow for: Actions and Related Records
6. Click Done.
7. You will see a flow chart like this:
   
8. Click the "+"  button below "Run Immediately".
   
   
9. Click Action from "Interaction".
10. In the new action window, select Outbound Message.
11. Select Forethought Outbound Message.
12. Fill the Label "ft_outbound_msg".
    
13. Click Done. You will see a flow chart like this:
    

Remove a Flow

1. Go to Salesforce Setup > Flows.
2. Click the drop-down button on the right side of the flow you want to remove.
3. Click View Details and Versions.
4. Click Deactivate under flow versions.
   
5. Click Delete in flow detail.

Step 2: Notify Forethought

Once you are done with the initial set-up, please notify your Forethought team with the following information:

Workflow rule + outbound message created & active: yes/no
Model name: e.g. "SPAM filter", "category-subcategory", "Escalation"
Field to read from: e.g. Is_Spam__c, the field you are currently using.
Field to write to: e.g. Forethought_Spam_Predicted__c 
(refer to "Final Implementation")
I have verified that the Forethought user has full write
access to that field, for any case type: Yes/No

Step 3: Final Implementation (per use-case)

SPAM Detection

Field to read from: e.g. Is_spam__c
Field to write to: Forethought_Spam_Predicted  

We suggest implementing the following logic, after an observation phase of the model's accuracy:

• When Forethought predicts that a case is a SPAM (Writes Forethought_Spam_Predicted = SPAM),
  • A workflow sets your current "Is_spam__c*" = SPAM
  • This sends the ticket to a SPAM Queue
  • An email is sent to the user, mentioning that her/his request was classified as such and that they can respond to this notification to re-open the case, if a mistake was made.
• If the user responded to a mistakenly classified SPAM:
  • A workflow triggers "Is_spam__c" = "Not SPAM"
  • This should surface the case back out to the right queue.
  • Forethought Dashboard will measure this as an inaccurate prediction (Is_spam__c <> Forethought_Spam_Predicted)
• If an agent audits the SPAM queue and finds a misclassification:
  • They will set "Is_spam__c" = "Not SPAM", which will trigger the same mechanism as above.