Executing Processes

Symphona Flow enables you to flexibly execute processes in a wide variety of ways, maximizing the range of use cases supported. In this article, we will cover all the different options available for triggering processes, including:

• Symphona Process Trigger
• File Upload (one-time or recurring)
• Form Entry (one-time or recurring)
• Webhook Events
• REST API Execution
• Converse Agent
• Public Submission Form
• Inbound Email

Tutorial Video

Follow along with us as we explore some of the common ways to execute Processes, including via public submission forms, file upload, recurring, webhook events, and REST API.

Process Trigger

Process Trigger enables you to execute single and bulk records through form entry or file upload. For each execution triggered in Process Trigger, you can define when execution begins and the frequency of execution (one-time or recurring).

File Upload

To execute your Process based on the data in an upload Excel or CSV file, follow these instructions:

1. Navigate to Process Trigger by clicking on Flow -> Process Trigger in the left side bar menu.

2. In Step 1 of the Process Trigger form, select your target Process.

3. In Step 2 of the Process Trigger form, click File Upload and add the file you would like to trigger Process executions from.
1. Note that one Process execution will be triggered for each row within the uploaded file.
2. Note that the file must be formatted with the mandatory Process parameters occupying one column each.
3. To review the Process parameters required by your Process, you can click the Expected Column Fields below File Upload.

4. In Step 3 of the Process Trigger form, you can select the execution frequency (“Only Once,” “Daily,” “Weekly,” “Monthly,” and “Yearly”) and when you would like the Process to start executing (e.g. at a later date rather than right away).
5. Once everything looks good, click the Submit Execution button at the bottom of the page.

After following these steps, your execution(s) should start as you specified, either now or in the future (depending on your selected execution time).

Form Entry

To execute your Process based on the data in an upload Excel or CSV file, follow these instructions:

1. Navigate to Process Trigger by clicking on Flow > Process Trigger in the left side bar menu.

2. In Step 1 of the Process Trigger form, select your target Process.

3. In Step 2 of the Process Trigger form, click Define Execution and enter in the required and optional Process parameters.
1. Note that you can define as many executions as you would like - each one will be considered its own Process execution.
2. Note that the file must be formatted with the mandatory Process parameters occupying one column each.
3. To review the Process parameters required by your Process, you can click the Expected Column Fields below File Upload.

4. In Step 3 of the Process Trigger form, you can select the execution frequency (“Only Once,” “Daily,” “Weekly,” “Monthly,” and “Yearly”) and when you would like the Process to start executing (e.g. at a later date rather than right away).
5. Once everything looks good, click the Submit Execution button at the bottom of the page.

After following these steps, your execution(s) should start as you specified, either now or in the future (depending on your selected execution time).

Webhook Events

To have your Process executed when an event occurs in another digital system (e.g. CRM) which support emitting webhook events, follow these instructions:

1. Navigate to Process Trigger by clicking on Flow > Process Trigger in the left side bar menu.

2. Click on the Manage Event Triggers (Webhooks) tab at the top of the view.
3. Click on the Create Event Trigger button in the top right corner of the view.

4. Enter in the required fields, including name, filter expression, and Process.
1. Note that you can use logical operators within the filter expressions to selectively execute Processes only when the incoming event data has certain field values. To learn more about logical operators, view our tutorial on them here.
5. Configure Event Payload Mapping to pass data from the received event to the Process input parameters of the Process you would like to execute.

REST API Execution

To execute your Process via the REST API, you will need to make a request to the specified endpoint with one of your organization’s API keys. Details on the specific API request you need to make can be found in the API section of this documentation portal or within the platform at Process Manager > Detail View > How to Execute Process > REST API.

Converse Agent

Generative Agents

To execute your Process during a conversation with a Generative Agent, follow these steps:

1. Navigate to Converse > Agent Manager in the side navigation bar and click Edit Agent to open the Agent Editor.
2. Click Add Action on the desired Objective you would like the Process to trigger from.

3. Enter in an Action Name and Purpose, and select the target Process you would like to execute.
1. Note that all Process executions from Generative Agents occur synchronously, meaning the conversation will wait for the Process to complete and the final execution parameter values will be provided back to the Agent for later use in the conversation.

4. Once you’re done making changes, click Deploy to update your Agent and publish the changes.

Structured Agents

To execute your Process during a conversation with a Structured Agent, follow these steps:

1. Navigate to Converse > Agent Manager in the side navigation bar and click Edit Agent to open the Agent Editor.
2. Create a new Action Block in the conversation step you would like the Process to execute on.
3. Click on the new Action Block to edit it.
4. Select Execute Process (Asynchronously) or Execute Process (Synchronously) in the Type field of the Action configuration view.
1. Note that “asynchronously” means the Process will execute in the background and the conversation will continue, whereas “synchronously” means the conversation will wait for the Process to complete and the final execution parameter values will be provided back to the Agent for later use in the conversation.

5. Select your target Process in the Process field, define the required input parameters in the Process Input Fields section, and for "synchronous" executions, optionally define any output parameters you would like for later use in the Agent in the Process Output Fields section.

6. Once you’re done making changes, click Deploy to update your Agent and publish the changes.

Public Submission Form

To execute your Process from a publicly accessible form, enable the form in Process Manager > Process Settings > Public Submission Form and turn on the toggle. After it has been enabled, a URL will appear at the bottom of the side modal which you can use to access the Public Submission Form.

Note that you can configure the appearance of the Public Submission Form to match your organization’s branding. Simply go to Settings > Back Office > Public Submission Form Branding to customize the styling as needed.

Inbound Email

To execute your Process when inbound emails are received, you will need to forward your emails to a specific email address provided by Symphona. Please contact Symphona Support to set up this feature for your organization. Note that this feature is limited to Enterprise plans and is not available within Explore plans.

• Executing Processes
• Tutorial Video
• Process Trigger
• File Upload
• Form Entry
• Webhook Events
• REST API Execution
• Converse Agent
• Generative Agents
• Structured Agents
• Public Submission Form
• Inbound Email