Skip to content
Fluentos Wiki

Add / Edit Integration

Fluentos enables you to create campaigns to capture users’ data, such as getting users’ emails for newsletter subscriptions.

To gather this data into your marketing platform or third party tools like Google Sheets, you need to integrate that application with Fluentos. For this purpose, you can use the Integrations page in your Fluentos account. You need a valid endpoint of the application that you want to connect with Fluentos to push submitted data.

Below are the steps for creating a new integration in Fluentos. You can connect to any third-party platform; you only need a valid endpoint URL.

Add New Integration

  1. Navigate to the Fluentos Dashboard https://app.fluentos.com.
  2. On the left side, click on Integrations.
  3. Click on the Add New Integration button.
  4. Enter Integration name > type name of the third-party application, for example, Google Sheets or anything else you prefer.
  5. Select Integration > Custom (if the application name is not provided in the dropdown, select “custom”).
  6. Turn on the Enabled toggle.
  7. Select Method > Post.
  8. Enter Endpoint URL > the endpoint URL generated in the third-party application.
  9. Click Add New Header, then select Header Key > Content-Type and enter application/json into the Assign value field.
  10. Using the Param options, you can define the dynamic and static values you want to append to the website’s submitted campaign data.
  11. In the Notification Recipients field, enter your email address to receive notifications if the integration fails.
  12. Before clicking the Add button to save the integration, you can confirm the correctness of the endpoint URL by clicking the Validate Connection button.
  13. If everything looks OK, click the Add button to save the integration settings.

Add New Integration

Enable / Disable Integration

Once an integration is added, it’s listed on the Integrations page with a toggle that you can use to enable or disable it whenever needed.

Enable / Disable Integration

Submit Additional Data

When setting up an integration for a campaign, you can append an additional data.

Dynamic Values

Assign in the following format in the Param Value field to pass dynamic values.

  • {{ip}}: IP where the request originated.
  • {{origin}}: Domain where the request originated.
  • {{locale}}: Locale, empty if not detected.
  • {{datahub:KEY}}: Dynamic data from the Fluentos Datahub.

Static Values

Add any key and value for the integration level if needed. For example: Source: Fluentos

Array Values

Passing values in a list/array: If you want to pass values in a list, you will use the format [value1,value2].

Array Values

Empty values

If a key or value is not entered, it will not be pushed to the integration, as it is assumed that values without defined keys are not needed.

Required values

If a toggle is selected but submitted data is not filled, the whole integration push will be discarded. Use it with the campaign required field option.

Integration Level vs. Campaign Level

  • Defining Param values at Integration Level: The values defined on the integration will append the defined data to all the website’s campaign integrations.
  • Defining Param values at Campaign Level: The values defined on the campaign’s integration settings will append the data to the the website’s specific campaign.

Example

In the image below, the component names can be seen.

Example Components

In the image below, the “Email” component’s value is passed as a dynamic value to the Google Sheet integration.

And, the “Source: Fluentos” as a fixed value.

Example Integration

Failed Integrations

If the Integration response status is 500 and above, you will be informed about the failing integration via notification in Fluentos and email. You can retry manually after the endpoint is alive, by clicking the Process Failed Integrations button. You can also see the incremented count for the failed integration events. All data collected during this time from the customers will be saved on the server. Once the integration is live again, that data will be passed to the integrated application.

The image below demonstrates the website integration page view of failed integration with the response type 500 or above.

Failed Integration View

The image below demonstrates how you will be notified on the page view of the campaign for which the integration failed.

Failed Integration Campaign View

If the integration response status is between 300 and 499, the integration will be discarded without any notification. In this case, you will have to make sure that the integration is properly set up.

Request Signature

All Fluentos server side requests are sent with a header 'User-Agent': 'Fluentos (https://fluentos.com)'. This allows to exclude Fluentos from the firewall if needed.

Troubleshooting

Empty Request Payload

If you’re experiencing issues and think it is related to Fluentos. Please try the following:

  • Install Postman.
  • Make a Post request.
  • Use Body > Raw and select JSON.

Paste following JSON into the Body request payload:

{
  "test": "value"
}

If you receive the request correctly but not via Fluentos, please contact support@fluentos.com.