Decionis Salesforce Starter Package

The wrapper entry point exposed to Flow and Agentforce. It forwards Salesforce action context to the Decionis Action Gate and maps back decision, dossier, and verification fields.

public with sharing class DecionisActionGate {
    public class Request {
        @InvocableVariable(required=true)
        public String orgId;

        @InvocableVariable(required=true)
        public String endpointBaseUrl;

        @InvocableVariable(required=true)
        public String apiKey;

        @InvocableVariable(required=true)
        public String objectType;

        @InvocableVariable(required=true)
        public String recordId;

        @InvocableVariable
        public String recordName;

        @InvocableVariable(required=true)
        public String actionName;

        @InvocableVariable
        public String workflowKey;

        @InvocableVariable
        public String decisionType;

        @InvocableVariable
        public Decimal amount;

        @InvocableVariable
        public Decimal riskScore;

        @InvocableVariable
        public String mode;

        @InvocableVariable
        public String policyVersion;

        @InvocableVariable
        public String objectiveProfile;

        @InvocableVariable
        public String contextJson;
    }

    public class Response {
        @InvocableVariable public String decision;
        @InvocableVariable public Boolean continueAction;
        @InvocableVariable public Boolean escalateAction;
        @InvocableVariable public Boolean delayAction;
        @InvocableVariable public String dossierId;
        @InvocableVariable public String verificationUrl;
        @InvocableVariable public String verificationSignature;
        @InvocableVariable public String summary;
        @InvocableVariable public String rawResponse;
        @InvocableVariable public String errorMessage;
    }

    private static String asString(Object value) {
        return value == null ? null : String.valueOf(value);
    }

    private static Boolean asBoolean(Object value) {
        if (value == null) {
            return false;
        }
        if (value instanceof Boolean) {
            return (Boolean) value;
        }
        return 'true'.equalsIgnoreCase(String.valueOf(value));
    }

    private static Map<String, Object> parseContext(String contextJson) {
        if (String.isBlank(contextJson)) {
            return new Map<String, Object>();
        }
        Object parsed = JSON.deserializeUntyped(contextJson);
        if (parsed instanceof Map<String, Object>) {
            return (Map<String, Object>) parsed;
        }
        return new Map<String, Object>();
    }

    @InvocableMethod(
        label='Evaluate Action with Decionis'
        description='Calls the Decionis Salesforce Action Gate before a consequential action executes.'
    )
    public static List<Response> evaluate(List<Request> requests) {
        List<Response> responses = new List<Response>();

        for (Request request : requests) {
            Response responseItem = new Response();
            try {
                Map<String, Object> payload = new Map<String, Object>{
                    'object_type' => request.objectType,
                    'record_id' => request.recordId,
                    'record_name' => request.recordName,
                    'action_name' => request.actionName,
                    'workflow_key' => request.workflowKey,
                    'decision_type' => request.decisionType,
                    'amount' => request.amount,
                    'risk_score' => request.riskScore,
                    'mode' => request.mode,
                    'policy_version' => request.policyVersion,
                    'objective_profile' => request.objectiveProfile,
                    'context' => parseContext(request.contextJson)
                };

                DecionisGatewayClient.GatewayResult gatewayResult = DecionisGatewayClient.post(
                    request.endpointBaseUrl,
                    '/v1/orgs/' +
                        EncodingUtil.urlEncode(request.orgId, 'UTF-8') +
                        '/salesforce/action-gate',
                    request.apiKey,
                    payload
                );

                responseItem.rawResponse = gatewayResult.rawBody;
                if (gatewayResult.statusCode >= 300) {
                    responseItem.errorMessage =
                        'Decionis action gate returned HTTP ' + String.valueOf(gatewayResult.statusCode);
                    responses.add(responseItem);
                    continue;
                }

                Map<String, Object> body = gatewayResult.body;
                Map<String, Object> actionGate = body.containsKey('action_gate') &&
                        body.get('action_gate') instanceof Map<String, Object>
                    ? (Map<String, Object>) body.get('action_gate')
                    : new Map<String, Object>();
                Map<String, Object> verification = body.containsKey('verification')
                        && body.get('verification') instanceof Map<String, Object>
                    ? (Map<String, Object>) body.get('verification')
                    : new Map<String, Object>();

                responseItem.decision = asString(body.get('decision'));
                responseItem.continueAction = asBoolean(body.get('continue_action'));
                responseItem.escalateAction = asBoolean(body.get('escalate_action'));
                responseItem.delayAction = asBoolean(body.get('delay_action'));
                responseItem.dossierId = asString(actionGate.get('dossier_id'));
                responseItem.verificationUrl = asString(verification.get('verification_page_url'));
                responseItem.verificationSignature = asString(verification.get('signature'));
                responseItem.summary = asString(body.get('summary'));
            } catch (Exception ex) {
                responseItem.errorMessage = ex.getMessage();
            }
            responses.add(responseItem);
        }

        return responses;
    }
}