Salesforce Apex Triggers

This documentation guides you through the process of setting up Apex triggers in Salesforce to handle specific conditions related to Opportunities. The exemplary trigger will be designed to execute when an Opportunity meets two criteria:

1. The opportunity moved to the stage Proposal/Price Quote
2. It has a value in the custom field cello_ucc

Apex Trigger Configuration

1. Create an Apex Trigger

Find detailed documentation on Apex triggers in the Salesforce docs.

Navigate to Setup in Salesforce and follow these steps,:

• In the Quick Find box, type "Triggers" and select "Apex Triggers."
• Click "New Trigger" to create a new trigger.

trigger OpportunityTrigger on Opportunity (after update) {

    OpportunityHandler.handleOpportunityUpdate(Trigger.new);

}

2. Create an Apex Class

Now, create an Apex class to handle the logic and API call. Implement the call to the Cello API in the placeholder method makeApiCall in the below code.

This configuration ensures that the Cello API is triggered when an Opportunity meets the specified criteria. Customize the code as needed based on your individual Salesforce setup, API requirements and endpoint.

public class OpportunityHandler {

    public static void handleOpportunityUpdate(List<Opportunity> updatedOpportunities) {

        for (Opportunity opp : updatedOpportunities) {

            // Check criteria: Opportunity in Proposal/Price Quote stage and cello_ucc value

            if (opp.StageName == 'Proposal/Price Quote' && opp.Cello_UCC__c != null) {

                // Make the API call

                makeApiCall(opp.Id, opp.Cello_UCC__c);

            }

        }

    }

​

    private static void makeApiCall(Id opportunityId, String celloUccValue) {

        // Your code to make the API call using HTTP methods, e.g., HttpRequest and HttpResponse

        // Example:

        // HttpRequest req = new HttpRequest();

        // req.setEndpoint('your API endpoint');

        // req.setMethod('POST');

        // req.setHeader('Content-Type', 'application/json');

        // req.setBody('{"opportunityId": "' + opportunityId + '", "celloUccValue": "' + celloUccValue + '"}');

        // HttpResponse res = new Http().send(req);

    }

}

3. Test and Deploy

• Test your trigger and class in the sandbox environment to ensure proper functionality.
• Reach out to the Cello team to confirm that provided event data is correct.
• Deploy the trigger and class to your production environment once testing is successful.