Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Compatible with Vtiger CRM: 5.1*, 5.2.*, 5.3.*, 5.4.*, 6.0.*, 6.1.*, 6.2.*, 6.3.*, 6.4.*

Your store should be running on Magento Community Edition version 2.0.x and 2.1.x.

Configuration

Set up Vtiger account

Go to https://www.vtiger.com/log-in/ to login ( if you had an existing Vtiger account) or register new one.

 

Image Modified

Getting Vtiger Access Key

 

Access your Vtiger account and click on your profile name on the top right corner, then go to My Preferences 


Image Modified

 

Scroll to bottom of the page, you can see the Access Key in User Advanced Options


Image Modified

 

 

Note

 Please save this information to start using the Vtiger CRM Integration extension. 

 


 

Back End 

Go to the Vtiger CRM tab, then the Vtiger CRM menu will be shown. 

 

Image Modified

 

There are 4 sub-tabs that admins need to consider:

(plus) Configuration

To start using the extension, admins need to set some configurations by navigating to  Vtiger CRM > Configuration.

 

Image Modified

 

Expand the VtigerCRM Information section, there are three fields will be shown.

(minus) Username: Your Vtiger username.

(minus) URL: Please follow the format of your_vtiger_site/webservice.php

(minus) Access Key: Used the access key which saved in the previous step to enter this field. 

(info) Check Connect VtigerCRM: After filling in some information mentioned above, please click on the Save Config and Check Connect VtigerCRM button to make sure that these information entered is correctly. 

 

 

Image Modified

 

Expand the Synchronization Settings section, there are seven sub-sections will be shown:

 

Image Modified

 

Expand the sub-section named Sync Account, there are two fileds (in the first time).

 

(minus) Enable: Yes/No.

(minus) Sync Mode: There are two options to choose:

  • Immediately: The extension will sync all of account from the Magento 2 site to the Vtiger CRM account immediately. 

Image Modified

 

  • Cron Job: Admin will set a period of time to sync data.

Example: When admin set 5 times at the Time field, that means the data of account will be synced from the Magento 2 site to the Vitger CRM account after 5 minutes automatically.

 

Image Modified

 

Note

Add All Customers To Queue button: If

...

admins want to sync all of existing customers before the time that the extension is installed, please click on this button to use this feature.

...

 

...

 


(plus) Setting Up Field Mapping

In order to synchronize data fields from Magento 2 store to your Vtiger CRM account correctly, you need to create the mapping for these fields first.  

Go to Vtiger Integration > Field Mapping

The module enables a grid table to manage mapping fields between Magento 2 and Vtiger CRM. You can choose which data fields you want to sync from Magento 2 to Vtiger CRM account. 

From the manage mapping, you can export, change the status with enable and disable options, edit or delete a mapping. 

 

Image Modified

 

In order to create a new mapping, please click on the Add New Mapping button

 

Image Modified

 

Image Modified

 

 

Fill in mapping information: 

  • Type: select data type: Leads, Contacts, Accounts, SalesOrders, Invoices, Products, Campaigns.
  • Description: describe data information 
  • Magento field: select Magento data field from dropdown list which you want to synchronize.  
  • Vtiger field: select Vtiger field from dropdown list which you want to store data in.  
  • Status: select Enabled/Disabled.

Remember to click Save Mapping to store information. 

Process Synchronization  

If the App mode is Cron Job, Queue page is the place which the created, updated data is stored in and are waiting to be synced. If you wish to sync data right away, you can press Sync Now button. 


Note
Note that synchronizing will take some time, the length of time depends on the size of data.  


Image Modified 


When the process is done, go to Vtiger Integration > View Report to check what is synced in the grid.

 

  • If the data is synced right, the Status will be success and the Message will be "OK"
  • If there's a problem during syncing process, the Status will be error and the Message tab will show the error message like the record below. 

Moreover, admin can easily check the synchronization with View Request Daily button and View On Vtiger button. 

 

Image Modified

 

Navigate to Vtiger Integration > Request Daily Report, admins can easily follow their synchronization status.  

 

Image Modified

 


Data Integration Settings

 


Click on VtigerIntegration > Field Mapping.You can define field mappings between Magento and VtigerCRM easily.

 

Image Modified

To add a new mapping, click on Add button, Add New Mapping page will show up

  • Type: Choose table you want to map

  • Vtiger Field: Choose Vtiger Field

  • Magento Field: Choose corresponding Magento Field

  • Status: Inactive or active

  • Description: Describe your mapping

Hit Save when done, your mapping is ready for the next sync.

Image Modified


Main Functions

  • When a new account is registered in Magento 2, Vtiger will automatically add a new record of this account in Leads, Organizations, Contacts.


Image Modified

Image Modified

Image Modified


Image Modified


  • When a customer adds items to cart then check out, Sales Orders in Vtiger will be auto synced.


Image Modified


Image Modified


  • When an invoice is made by admin in Magento 2, Invoice in Vtiger will be synced.

Image Modified


Image Modified


  • When admin add a new product in Magento 2, Vtiger will auto sync data about that product.


Image Modified


Image Modified


  •  When admin edits a customer account/product in Magento 2, that customer/product will also be changed from Leads, Organizations and Contacts, products in Vtiger.


...

Update

 

  • When a bug fix or new feature is released, we will provide you with the module's new package.
  • All you need to do is repeating the above installing steps and uploading the package onto your store. The code will automatically override.
  • Flush the config cache. Your store and newly installed module should be working as expected.

 

...