Skip to main content

Celonis Product Documentation

Trigger an Action Flow from a Process Copilot

To trigger an Action Flow from a Process Copilot, a webhook must be added to the Action Flow. This allows the Process Copilot to recognize and execute the flow. The setup involves creating a webhook trigger, adding the Trigger Action Flow tool to the Process Copilot configuration, linking it to the Action Flow in the tool activation settings, and then executing the Action Flow from the Process Copilot chat interface.

Requirements
  • Action Flow and Process Copilot permissions

  • A pre-configured Action Flow

Add a webhook to the Action Flow

Tip

Ensure that the webhook is correctly saved in the Action Flow or it will not appear in tool selection dropdown when configuring the Trigger Action Flow tool in Process Copilot.

  1. Open your Action Flow.

  2. Right-click and select Add a module.

  3. Connect the new module to the beginning of the Action Flow.

  4. Click on the new module and select Webhooks.

  5. Select a Custom webhook trigger.

    Screenshot showing the types of Webhooks available to add to an Action Flow.
  6. Open the webhook settings and then click Add.

    Screenshot showing the windows used to create and name a webhook within an Action Flow.
  7. Enter a unique name such as my_PDF_action_flow.

  8. Click Save and then click OK to create the webhook.

  9. Exit the Action Flow.

Add the Trigger Action Flow tool
  1. Go to your Process Copilot and click the Configuration icon in the upper right.

  2. Click 2 - Tool Activation.

    Screenshot of the Tool Activation section of the Process Copilot configuration process with no tools assigned.
  3. Click Add Tools and select "Trigger Action Flow".

  4. On the Add Trigger Action Flow screen, assign an ID (e.g., my_PDF_action_flow) and add a description.

    Screenshot showing the configuration options for the Add Trigger Action Flow tool in a Process Copilot.
  5. From the Select Action Flow dropdown, select the Action Flow associated with the webhook.

    Screenshot of the configuration screen for the Add Trigger Action Flow tool with the Select Action Flow dropdown expanded.
  6. Click Add Tool.

Add to start screen

The steps in this section are optional, but make it easier to manually trigger the Action Flow from the Process Copilot chat interface.

  1. Click 5 - Start Screen.

    Screenshot showing the Start Screen section of the Process Copilot configuration with the default settings.
  2. Use one of the question fields to add a prompt that will trigger your Action Flow, such as "Run my_pdf_trigger_action_flow".

  3. Click Save Changes. This question will now display on the start screen when accessing this Process Copilot.

Execute the Action Flow from Process Copilot
  1. Click the Go to Process Copilot Chat button in the upper right.

  2. On the start screen, click the question you created in the previous section to prompt the Process Copilot to run the assigned Action Flow.

    Screenshot showing the Process Copilot chat interface with a trigger for the Action Flow added to the start screen.

    The Process Copilot will process your request and display a button to execute the Action Flow.

  3. Click the button to execute the Action Flow.

    A confirmation message will appear once the execution is complete.