Configuring the module "NeoSeo Exchange with Bitrix24" for the online store {SEO-shop}, OpenCart 2.x, 3.x, ocStore

To install the “NeoSeo Exchange with Bitrix24” module you need:

Install the module files and licenses on the site.

After the module files and license are installed on the site, go to the administrative panel of the site and select the “Add-ons” -> ”Modules” section:

3. In the list of modules that will open, select “NeoSeo Exchange with Bitrix24” and click the “Install” button:

4. It is necessary to go to the section “Add-ons” -> ”Add-ons Manager”:

​

5. In the “Add-ons Manager” section, you need to update the modifiers.

 Preparing for synchronization on the Bitrix24 side

       In order to set up synchronization with the Bitrix24 system, you need to perform some actions in the system itself.

       For synchronization between the opencart site and Bitrix24, the incoming webcaps are used. In order to be able to use the webbooks, the settings must be made under the main user of the system (owner) or under the user with full rights, otherwise the connection to the system will not be available.

       To create an incoming web-based web browser, go to the “Applications” section - “Web-based browsers” and choose to create an incoming web-based web site.

         On the addition form of the incoming webhuk, you must fill in the fields “Name”, “Description” (if desired) and select the access rights. Currently the module supports the following rights: Users (user) and CRM (crm). Support for the rest is missing. After entering the settings, you must save the new incoming webhооk.

ATTENTION!!! These rights are Users (user) and CRM (crm) are required to select.

 

After saving the data will be available:

1. Portal name

2. User ID

3. Secret code

All these data will be required for entering into the module settings.

The “Basic Settings” tab contains the basic settings of the module.

Consider each option in more detail.

ATTENTION!!! Without filling out the basic settings, directories that are used in the module settings will not be available. In this case there will be the following message in the module settings:

The list of basic settings of the module:

Status - the status of the module (values ​​Enabled / Disabled).

Portal name - the name of the portal can be obtained through a link in the creation of a webhuk. Specifies only the name of the portal, without bitrix24. For example, the name of the portal test.bitrix24. In the field you must specify test.

User ID — The numeric identifier for the user who created the WebHook. Under the rights of this user this webhuk will work. ID can be obtained through the link in the creation of webhооk.

Secret code - a secret code, you can get through the link in the creation of a webhооk

After entering the settings on the “Basic Settings” tab, you need to save the module settings.

ATTENTION!!! If after entering the basic settings and saving the data from the directories are not available on the tabs, then the connection to the system has not been made and the entered data should be checked.

 

The “Contacts” tab contains settings that are responsible for creating contacts in Bitrix24. Consider each option in more detail.

Create contact before creating a lead is an option that is responsible for creating a lead with the values ​​Enabled / Disabled. On what basis are the leads described in the next paragraph.

The contact user is an option that assigns the user responsible for contacts in the Bitrix24 system. Available options from the Bitrix24 user directory.

Source when creating a contact is an option that assigns the source of a contact in the Bitrix24 system. Available options from the Bitrix24 source directory.

The default contact type is used if the customer group is not selected in the match table. Available options from the Bitrix24 Contact Type Reference.

Consider the advanced option “Matching table: Buyer group on the site - Contact type in Bitrix24”. This option is necessary if each group of customers on the site is required to associate their contact type in the bitrix24 system.

The “Leads” tab contains settings that are responsible for creating leads in Bitrix24.

Consider each option in more detail.

Leads are created only when registering on the site (on a separate registration page, when placing an order), provided that the registration uses standard opencart methods. Implemented lead creation support when a request is received in the “NeoSeo Contact Pickup” and “NeoSeo Subscription for Goods Receipts” module.

Create lead at registration - a lead will be created only using standard registration methods.

The user responsible for leads is the option that assigns the user responsible for leads in the Bitrix24 system. Available options from the Bitrix24 user directory.

The registration source is an option that assigns a lead source in the Bitrix24 system. Available options from the Bitrix24 source directory.

Create a lead when creating an application in the "NeoSeo Contact Capture" module - a lead will be created only if the "NeoSeo Contact Capture" module is installed.

The source when creating an order in the "NeoSeo Contact Pickup" module is an option that assigns a lead source in the Bitrix24 system. Available options from the Bitrix24 source directory.

Create a lead when creating an application in the "NeoSeo Subscription for Goods Receipt" module - a lead will be created only if the "NeoSeo Subscription for Goods Receipt" module is installed.

The source when creating an order in the "NeoSeo Subscription for Goods Receipt" module is an option that assigns the source of the lead in the Bitrix24 system. Available options from the Bitrix24 source directory.

The “Transactions” tab contains settings that are responsible for creating leads in Bitrix24. Consider each option in more detail.

Transactions are created based on orders from authorized buyers. Contacts are assigned to deals in the order (provided that contact creation is enabled in the module settings), which is created on the basis of leads. A separate transaction is created for each product from the order.

Create a deal when creating an order - a deal will be created using standard order creation methods. Values ​​Enabled / Disabled.

The user who is responsible for the transaction - an option that assigns the user responsible for transactions in the Bitrix24 system. Available options from the Bitrix24 user directory.

The default transaction stage is applied if the order status is not selected in the correspondence table. Available options from the Bitrix24 transaction stages directory.

Default transaction type - applies if the category is not selected in the match table. Available options from the Bitrix24 transaction type directory.

Unload options in the transaction comment - if the item has an option in the order and the option is selected in this setting, then the option will be unloaded in the transaction comment. Available options from the list of site options.

Create a deal if the order is assigned status - available options from the list of site order statuses.

Consider the advanced option “Correspondence table: Order status on the site - Stage of the transaction in Bitrix24”. This option is necessary if each order status on the website is required to match its stage of the transaction in the bitrix24 system.

Consider the advanced option “Match table: Category on the site - Type of transaction in Bitrix24”. This option is necessary if each category of goods (main category) from the order is required to match its type of transaction in the bitrix24 system.