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. It is ready for full-fledged work: a lead will be created when registering on the site and creating an order on the site, and a deal will be formed after payment. The webhook remains available until the administrator who created it is deleted.