External Integrations (App Integrations)

An overview of how push data from Quixy to the 3rd party system

In this article, you will learn how to transfer data from the Quixy application to a third-party application and what parameters to obtain from the third-party application.

Note: This is a sub-article. Please read the main article before you continue to read this article.

External Integrations (App integrations) in Quixy are mainly used to establish a connection between the Quixy platform and 3rd party platform using application programming interface (APIs). Once connected, the app can request and share data freely with the other app.

Now-a-days, real-time monitoring of an API call's response is essential for some business use-cases, at times, it can be a time-consuming and labor-intensive process. but with Quixy's Integrations, you may easily capture the API response data.

For Example: 

Assume an ERP company uses the Quixy platform as the first step in their Order Fulfillment Process to allow its users to place an order. Now, when a new order is initiated in Quixy, the Quixy platform connects to the ERP company (third-party system) through integrations to generate a tracking number and return it to Quixy to save the response data for the future order processing and tracking. 

In order to ensure that, your app should have the required data capturing fields to capture the API response data, and you need to verify that the correct mappings are made to the fields while configuring the Integrations. 

Do you wish to have a quick look at the Integration API Response configuration?

How to configure app integrations?

Prerequisites:

  1. You should create an app with all the necessary data capturing fields whose data you want to send to a 3rd party system after submitting a record in that app.
  2. To consume Report API, it is mandatory for the third-party platforms to have a bearer token for authentication. To generate the bearer token, one should have Integration Access in Quixy. 
  • Go to the app view page, click the 3-dot menu, and select Integrations.

  • You will land on the app integrations page, click Add tab.

  • You will land on the integrations configuration page.

  • There are three types of integrations in Quixy:
    • Custom: This is the most common type for integrating the Quixy application with a third-party system.
    • Zapier Webhook: When a 3rd-party system does not allow for direct integration with the Quixy platform, this option is used. Third-party systems will generate a webhook, which we must connect to.
    • Payments Gateway: Payment Gateway Integrations is for seamless online money transactions from Quixy apps.

Custom Integration Configuration

  • Select the Integration Type as Custom.

  • Enter the API Name and API Url, obtained from the 3rd party platform.

  • Next, select the Work Flow Step and Work Flow Step Action, according to which the integration should initiate.
  • Select Without Authorization as the Authentication Type, if the integration API is an Open API without any security layer.
  • Select With Authorization as the Authentication Type, if the integration API is a secured API with a security layer.
  • For APIs with authorization, enter the security details in the respective fields obtained from the 3rd party system, as shown below.

1-1

  • Add the Custom Headers.
  • Set the Has Mapping radio button to YES, If you have a Json body, shared by the 3rd party system, to map the data fields in the Json body to the fields in the Quixy app. 
  • Set the Has Mapping radio button to No, If the 3rd party system doesn't share any Json body.

Note: We have different configuration processes for Has Mapping and Has no Mapping.

Configuration when integration Has Mapping:

2

You need to enter the following details:

  1. JSON Object, obtain from the third-party platform.
  2. Object Name, obtain from the third-party platform.

2-1

  • Select the Type as Single, if you want to map only individual data capturing fields.
  • Select the Type as List, if you want to map Grid's data capturing fields along with the individual data capturing fields.
  • After filling in all the required details, click Create Mapping and map the elements in the JSON Object to the elements present in the Quixy app.

5-3

To receive a response to an API call you made and save the data from the API response. Follow the below process. 

  • Set the Has Response Mapping radio button to YES, If you want the response data to the API call.
  • Provide the Response Json Object, click Create Response Mapping, map the API's response data fields to the data capturing fields in the Quixy app.

6-4

  • Set the Has Mapping radio button to No, If you do not want the response data to the API call.
  • Click Save.

Configuration when integration Has no Mapping

3-1

  • Set the Has Mapping to No.
  • Since there isn't any mapping to be done, you can simply Save the configuration.

How to configure Zapier Webhook integrations?

  • Select the Integration Type as Zapier Webhook.

4-Feb-14-2022-10-10-19-52-AM

  • Enter the Webhook Name and Webhook Url obtained from the 3rd party system.
  • Select the Work Flow Step and Work Flow Step Action, according to which the integration should initiate.
  • Select the Type as Single, if you want to map only individual data capturing fields.
  • Select the Type as List, if you want to map Grid's data capturing fields along with the individual data capturing fields.
  • Provide the JSON Object obtained from the 3rd party system.
  • Click Create Mapping and map the data fields in the JSON Object to data fields in the Quixy app.

To receive a response to an API call you made and save the data from the API response.

  • Set the Has Response Mapping radio button to YES, If you want the response data to the API call.
  • Provide the Response JSON Object, click Create Response Mapping, map the API's response data fields to the data capturing fields in the Quixy app.

6-4

  • Set the Has Mapping radio button to No, If you do not want the response data to the API call.
  • Click Save.