How to Add a Custom App as a Trigger in Bit Flows

In this documentation, I will explain how to create a custom trigger app in Bit Flows. The main focus is to guide users on the process of building and configuring a custom trigger app. For demonstration purposes, we will capture Gravity Form submissions using the hook “gform_after_submission” and send the submission data to Google Sheets as an action.

After reading this documentation, users will gain a clear understanding of how to create and set up custom trigger apps in Bit Flows to suit their unique automation needs. The output of this workflow will ensure that data from the configured custom trigger is processed and sent to the specified Google Sheet, enhancing efficiency and reducing manual tasks.

What is a Custom Trigger App in Bit Flows?

A Custom Trigger App in Bit Flows allows you to define specific events that initiate workflows. A trigger is an event that starts a workflow, and with a custom trigger, you can configure a unique event from any app or system you’re working with. After setting up the custom trigger, you can link it to your workflow, and upon the occurrence of the event, the workflow will be activated to perform defined actions. This gives you the flexibility to automate processes based on custom events specific to your requirements.

Create Custom App in Bit Flows

First, go to Bit Flows Custom App and click on Create New App. A popup will appear.

Here, you can provide a name for your app, add a description, choose a logo, and even select a theme. Once done, click on the Create button.

Congratulations! You have successfully created a Custom App.

Add Custom Trigger in Bit Flows

Now, you need to create a module. These modules can either be a Trigger or an Action, and you can add as many triggers and actions as needed.

To create a Custom Trigger, click on Add Module. This will open a popup.

We want to create a Custom App based on a trigger. So, for this module, we will select “Trigger.” After that, we need to configure the module for the trigger.

Configure The Trigger

Here, you need to configure the trigger for your custom app. Start by setting a name for the trigger for easy identification, add a description, and select a Trigger Type.

There are two types of triggers available:

1. Webhook-based: This trigger works by capturing data from external applications using a webhook URL. It listens for incoming data and starts the workflow whenever the webhook is called.
2. WP Action Hook-based: This trigger is designed to capture data within WordPress using specific action hooks. It listens for events triggered by WordPress and initiates the workflow accordingly.

For this demonstration, we will use the WP Action Hook. Select “WP Action Hook” as the Trigger Type. You will then be prompted to enter your WP Action Hook. Here, we will use the hook “gform_after_submission” to capture Gravity Form submissions. Once the hook is entered, click on the Save button. This hook will allow us to retrieve the submission data, which can then be sent to any action as needed.

Congratulations! You have successfully added a trigger to your Custom App.

You can manage your triggers in custom apps with ease. You have the options to turn off, edit, or delete any trigger. Simply click on the respective icon located on the right side of the trigger.

Test The Custom Trigger App

After creating a trigger in your custom app, let’s see how to use the custom trigger app. Open an existing workflow or create a new one. For this demonstration, we already have a workflow named “GravityFormToGoogleSheet,” and we will add our custom trigger app to it.

First, navigate to the Flows section and open a flow. Select your created custom app as the trigger, and then choose the trigger event. For this example, we select “Gravity Forms” and the event “Submit Success.”

Next, we need to capture the response. Click on “Listen Response” and submit a Gravity Form. Once submitted, check the response. As you can see, the response has been successfully captured.

Now, you can send the submitted Gravity Forms data to your preferred action, which in this case is Google Sheets. Add Google Sheets as an action and configure it accordingly. Once done, test the flow by clicking “Test Flow Once” and running the trigger (in this case, Gravity Forms Submit Success). Finally, verify if the submitted data has been sent to Google Sheets.