Create an integration

To set up the integration, go to the Integration with Bitrix24 → Integration settings section of the Agora administrative panel.

A settings window will open in which you need to enter data.

Parts of the incoming webhook URL created in Bitrix24 should be inserted into the Bitrix24 Portal, Administrator ID and Webhook Key fields.

To create a new webhook in Bitrix24, go to Applications → Developer resources→ Other → Inbound webhook.

In the window that opens, copy the webhook URL from the field  Webhook to call the rest api (it will be used in further integration settings) and select CRM rights.

After completing the settings, Save the changes.

Return to the admin panel of the Agora project.

The previously copied URL must be broken into 3 parts and pasted into different fields:

• up to a number (including the «/» symbol) — to the Bitrix24 Portal;
• number — in the Administrator ID;
• the rest (without the «/» symbol) — in the Webhook key field.

Then check or leave empty the Send a webhook about user registration checkbox, select Lead creation status and Transaction creation status — at what order statuses in Agora the lead and deal will be created in Bitrix24. 

The field TIN field code in Bitrix24 is optional. To fill it out, you need to find the TIN field ID in your Bitrix.

For this:

• go to CRM → Settings → CRM settings → Form and report settings → Custom Fields → Lead (Fields);
• find the TIN field in the list and go to it;
• in the search bar, at the end of the url, you will see the value UF_CRM_XXXXXXXXXX, where UF_CRM_XXXXXXXXXX is the ID;
• copy it.

Paste the received value into the field TIN field code in Bitrix24, save the changes.

Now the integration of Agora with Bitrix24 can be considered complete. The webhook remains available until the administrator who created it is deleted.

Query Log

The section displays the history of Bitrix REST API interactions with the Agora system. To access it, click on the Query Log button in the Agora administration panel.

Image Added

In the table that opens, you will see the columns:

• ID — request number;
• Departure Shipping date;
• Date of responseResponse date;
• Type of ad appeal — for example, order or registration;
• Link to the buyer — if a new user is created, a link with the name Go to the buyer's profile will appear in the column;
• Link to the order — if the case type is Order, the field will display the Go to order link.
• Request log type — detailed information about the request;
• Status — the request was processed with or without an error.

Image Added

Clicking on a request ID will take you to a page with detailed information about the request.

Image Added

It is also possible to select multiple queries in the table and delete them.