Integrations and API testing

Integrations feature allows you to create an integration by yourself without opening a ticket and waiting for an integration. You can also use it in order to make changes in an existing integration.

Click your profile circle on the top right. From there, click ‘Integrations’.

You will now see all the current integrations in your system.

On the right side of the screen, you have to press on +

You will be requested to provide brand's name and brand's API URL. Insert the brand's name and ask him to provide you the API URL.

Please note:

If you're getting an error after filling brand's name and API URL - please open a ticket and share with support the brand name and API URL you have entered.

After filling brand's name and API URL you will see the relevant fields to fill for the brand, i.e username, password, API key.

Some of the fields are already pre-filled, and only need to be changed if you want the visual campaign or brand name to be different.

This page will also let you click-to-copy our list of IPs that some brands need to whitelist.

Once done, hit “Create integration” and you will be directed to test the integration.

To send a test lead, select an affiliate, the relevant Geo, and press the “Autofill data” in user data section.

Filling free parameters fields is not a must, you can leave it as it is:

In case you want to pass something in one of the parameters, for example, to send any value in "MPC_1", all you have to do it do pick the parameter from the list and fill the value you want to pass.

Then, fire a test lead! On the right side you will see the results of your test. At this stage you can close the integration flow safely.

Make a test, check the response on the right, if its False or you see there an error, copy the Request + Response send it to the brand and ask why lead failed.

Please note

You don't have to create an integration to send a test. You can always send a test via API testing, whether if it's to check something in the request, for example if the funnel is being sent to the broker, or if the broker is not seeing a test that was sent before, or if you just need a test.

If you want some changes in an integration, for example, to change the name of an integration, all you have to do is click on the three dots of the relevant integration and click edit:

Here you can edit the name of the integration:

You can also change the creds for the integration and add parameters in MapDynamicparams.

For example, if you want to send the funnel (source) in MPC_1 all you have to do it to add it like this:

Don't forget to send a test to make sure it's working!

If you're having issues with getting call status and deposits the first thing you should check is the miners.

What are the miners?

In integrations tab, where you see all your integrations, you can see the miners for FTD and call status. If the miners are turned on it means that we can pull lead status and deposits from the broker. If the miners are turned off it means that the option to pull from the broker is closed and that's why you're not getting it from the broker.

If you see in status and FTD last sync that the dates are in red as above in the screenshot - it means that there is an issue with pulling lead status and deposits from the brand. Sometimes there might be an issue with only one pulling method.

In order to check what is the issue and fix it what needs to be done is to pull manually and check the response and the request.

Go to API testing, click on pull test and then you will see fields to fill up:

General:

In method you need to choose either pull FTD or pull lead status, depending on the issue you have.

Afterwards in Brand you need to choose the relevant brand and in page number write down either 0 or 1.

Important!

If you can't find the relevant brand in the list it means that the miner are turned off. Only brands with open miners will be available for pulling. In this case you need to go back to Integrations, search for the relevant brand and turn off the miners (either for one of the methods or both).

Time:

Select by period, then select the period type by hours, days, weeks or months.

Then in time back put a number. For example if you have chosen to pull by week and you put 1 in time back it means that you will pull leads from one week back.

After you've filtered click on "pull". You would see the brand response in response and the pulling request you will see the pulling request.

If you see some kind of error in the response or no leads in response you need to forward it to the broker and let them check.

For example:

{

"data": [],

"meta": {

"limit": 500,

"count": 0,

"total": 0,

"currentPage": 1,

"lastPage": 1,

"prevUrl": null,

"nextUrl": null

}

}

If you're getting a list of leads in response please make sure the lead you're having issues with is in there. If it's not the status won't change or FTD won't be visible for you.

If you do see the lead and the status is "new" in their response - you need to check with the brand why they are returning call status new. If they are returning "new" you will see on your side "new as well.

In case you see the status is not "new" but a different one, for example "no answer", and you still see the lead as new, please contact support.