Finding ACP Actions in Flow Builder

​

Introduction

​

Prerequisites

• ACP-Backed Invocable Action: You must have an Apex class deployed in your Salesforce org containing at least one method annotated with @InvocableMethod. This method should be designed to call an ACP tool.
  • Example: An Apex class named ACPSlackActions with a method sendMessage annotated with @InvocableMethod(label='ACP Slack: Send Message' description='Sends a message to a Slack channel via ACP.').
• Access to Flow Builder: You need the necessary Salesforce permissions to create or edit Flows.

​

Steps to Find and Add ACP Actions in Flow Builder

1. Open Flow Builder:
   • Navigate to Setup in Salesforce.
   • In the Quick Find box, type “Flows” and select Flows.
   • Click New Flow to create a new Flow, or open an existing Flow where you want to add the ACP action.
   • Choose the type of Flow you want to create (e.g., Screen Flow, Autolaunched Flow, Record-Triggered Flow).
2. Add an “Action” Element:
   • In the Flow Builder canvas, click the + (Add element) icon where you want to insert the ACP action.
   • Select the Action element from the “Interaction” or “Logic” section (depending on your Flow type and canvas view).
   (Ideally, replace this with an actual image or a more descriptive placeholder if images aren’t supported here)
3. Search for Your ACP Action:
   • In the “New Action” configuration pane that appears on the right, click into the Action search box.
   • Search by Label: The easiest way to find your ACP action is to type the label you specified in the @InvocableMethod annotation in your Apex class.
     • For our example: Type “ACP Slack: Send Message”.
   • Search by Category: If you specified a category in the @InvocableMethod annotation (e.g., @InvocableMethod(label='...' category='ACP Tools')), you can filter by that category on the left side of the Action selection dialog.
   • Browse All Actions: You can also scroll through the list of available actions, but searching is usually faster.
   (Placeholder image)
4. Select the ACP Action:
   • Once you find your ACP action in the search results, click on it to select it.
5. Configure the Action:
   • Label: Give this specific instance of the action a unique and descriptive label within your Flow (e.g., “Send Welcome Message to Slack”).
   • API Name: An API name will be auto-generated. You can modify it if needed.
   • Input Values: This is where you provide the inputs that your Invocable Method expects.
     • For each input parameter defined with @InvocableVariable in your Apex method, a field will appear here.
     • You can set these values statically, or more commonly, map them from Flow resources (like variables, record fields, screen component inputs, or outputs from previous Flow elements).
     • Toggle “Include” for each parameter you want to set.
     • For example, if your ACPSlackActions.sendMessage method expects channelId and messageText, you’ll see input fields for these. You might map messageText to a Flow variable called varWelcomeMessageText.
   (Placeholder image)
6. Handle Output Values (Optional but Recommended):
   • If your Invocable Method returns values (also defined with @InvocableVariable), you can store these outputs in Flow variables for use in subsequent Flow elements.
   • Under the “Advanced” section (or directly visible depending on the interface), you can manually assign output variables.
   • For example, if your action returns a success boolean or a responseId, you can create Flow variables to store these and use them for decision logic later in the Flow.
   (Placeholder image)
7. Click “Done”:
   • Once you’ve configured the label, API name, inputs, and any outputs, click Done.

​

Tips for Finding ACP Actions

• Consistent Naming Convention: Use a consistent prefix or naming convention for the label of all your ACP-related Invocable Actions (e.g., “ACP [Connector Name]: [Action]”). This makes them easier to find and identify.
• Use the category Attribute: Group related ACP actions using the category attribute in the @InvocableMethod annotation. This helps organize them in the Flow Builder action selection dialog.
• Descriptive Labels and Descriptions: Ensure the label and description in your @InvocableMethod and @InvocableVariable annotations are clear and accurately reflect what the action and its parameters do. These are displayed in Flow Builder and help users understand how to use the action.