{"id":19853,"date":"2026-04-07T13:50:24","date_gmt":"2026-04-07T17:50:24","guid":{"rendered":"https:\/\/alix.ai\/documentation\/?post_type=docs&p=19853"},"modified":"2026-04-07T14:55:48","modified_gmt":"2026-04-07T18:55:48","password":"","slug":"zoho-crm-integration","status":"publish","type":"docs","link":"https:\/\/alix.ai\/documentation\/en\/doc\/integrations-en\/zoho-crm-integration\/","title":{"rendered":"Zoho CRM integration"},"content":{"rendered":"
\"image_print\"<\/a><\/div>

-> Integration coming soon<\/strong><\/em><\/p>\n

ALIX\u2019s integration with Zoho CRM enables bidirectional synchronization of customers between both systems. Customers created or modified in Zoho CRM are automatically synchronized to ALIX, and vice versa. This page covers the initial connection, module configuration and field mapping.<\/p>\n

Note: <\/em><\/strong>Only Zoho CRM accounts (Accounts) are synchronized. CRM contacts without an associated account are not imported into ALIX.<\/p><\/blockquote>\n

Scope of integration<\/h2>\n

The integration with Zoho CRM synchronizes the following elements in both directions (CRM \u2194 ALIX):<\/p>\n

    \n
  • Customers (Accounts in CRM)<\/li>\n
  • Contact persons (Contacts in CRM)<\/li>\n
  • Billing and shipping addresses<\/li>\n<\/ul>\n

     <\/p>\n

    Connect Zoho CRM<\/h2>\n
      \n
    1. In Settings<\/strong>, go to the Integration<\/strong><\/li>\n
    2. Click Connect<\/strong> next to Zoho CRM<\/strong>.
      \n\"\"<\/li>\n
    3. Authorize the connection by following Zoho\u2019s instructions.<\/li>\n
    4. Click Connect ALIX<\/strong>.
      \n\"\"<\/li>\n
    5. The integration page reloads. The button now shows Details<\/strong> next to Zoho CRM<\/strong>.
      \n\"\"<\/li>\n<\/ol>\n

       <\/p>\n

      Activate the Customers module<\/h2>\n
        \n
      1. In Settings<\/strong>, go to the Integration<\/strong> section, then click Details<\/strong> next to Zoho CRM<\/strong>.<\/li>\n
      2. In Customer field mapper<\/strong>, add the Currency<\/strong> field by mapping it to Currency<\/strong> in the CRM Field.
        \n<\/strong><\/p>\n

        Note:<\/em>If the currency is not mapped, an error message is displayed.<\/p><\/blockquote>\n

        \"\"<\/li>\n

      3. Activate Customers<\/strong> by clicking the toggle in the Synchronization.
        \n\"\"
        \n<\/strong><\/li>\n<\/ol>\n

         <\/p>\n

        Map fields<\/h2>\n

        Field mapping determines which information is synchronized between ALIX and Zoho CRM. Two mapping sections are available:<\/p>\n

          \n
        • Customer field mapper<\/strong>\u00a0\u2014 customer fields (name, currency, website, etc.)<\/li>\n
        • Customer contact person field mapper<\/strong>\u00a0\u2014 fields of the person associated with the customer (email, name, etc.)<\/li>\n<\/ul>\n

           <\/p>\n

          Four mandatory fields cannot be deleted:<\/p>\n

            \n
          • Customer name<\/strong> \u2192 Client Name \u2014 preconfigured, not modifiable<\/li>\n
          • Currency<\/strong> \u2192 Currency \u2014 must be added manually (see previous step), modifiable afterwards<\/li>\n
          • Email<\/strong> \u2192 Email \u2014 preconfigured, not modifiable<\/li>\n
          • Last name<\/strong> \u2192 Last Name \u2014 preconfigured, not modifiable<\/li>\n<\/ul>\n

             <\/p>\n

              \n
            1. In the desired mapping section, click the +<\/strong> to add a field mapping.<\/li>\n
            2. Select the ALIX field in the ALIX Field<\/strong> column and the corresponding CRM field in the CRM Field.
              \n\"\"
              \n<\/strong><\/li>\n
            3. Repeat for each field to synchronize.<\/li>\n<\/ol>\n

              Note: <\/em><\/strong>You must complete a field mapping before adding another one. If you click the +<\/strong> while a mapper is incomplete, an error message is displayed.<\/p><\/blockquote>\n

              To delete a field mapping, click the X<\/strong> to the right of the mapping. Mandatory fields cannot be deleted.<\/p>\n

               <\/p>\n

              Configure address modules<\/h2>\n

              The integration offers four address modules, each covering a different address type. Each module must be configured and activated separately.<\/p>\n

              Main billing address<\/h3>\n

              This module synchronizes the customer\u2019s default billing address, stored in the standard fields of the CRM account (Billing Street, Billing City, etc.).<\/p>\n

                \n
              1. In the Zoho CRM integration details, locate the Main billing address.<\/strong><\/li>\n
              2. In Main billing address field mapper<\/strong>, click the +<\/strong> and map the required fields: street, city, country, province and postal code.
                \n\"\"<\/li>\n<\/ol>\n

                Note: <\/em><\/strong>The Is main address<\/strong> field is not available in this module. The address synchronized by this module is always considered the main address in ALIX.<\/p><\/blockquote>\n

                  \n
                1. Activate the module by clicking the toggle.
                  \n\"\"<\/li>\n<\/ol>\n

                  Note: <\/em><\/strong>Once the module is activated, the required field mappings can no longer be deleted. To modify them, you must first deactivate the module.<\/p><\/blockquote>\n

                   <\/p>\n

                  Main shipping address<\/h3>\n

                  This module synchronizes the customer\u2019s default shipping address, stored in the standard fields of the CRM account (Shipping Street, Shipping City, etc.).<\/p>\n

                  The configuration follows the same process as the main billing address:<\/p>\n

                    \n
                  1. In the Zoho CRM integration details, locate the Main shipping address<\/strong><\/li>\n
                  2. In Main shipping address field mapper<\/strong>, click the +<\/strong> and map the required fields: street, city, country, province and postal code.
                    \n\"\"<\/li>\n<\/ol>\n

                    Note: <\/em><\/strong>The Is main address<\/strong> field is not available in this module. The address synchronized by this module is always considered the main address in ALIX.<\/p><\/blockquote>\n

                      \n
                    1. Activate the module by clicking the toggle.
                      \n\"\"<\/li>\n<\/ol>\n

                      Note: <\/em><\/strong>Once the module is activated, the required field mappers can no longer be deleted. To modify them, you must first deactivate the module.<\/p><\/blockquote>\n

                       <\/p>\n

                      Billing addresses<\/h3>\n

                      This module synchronizes billing addresses stored in a custom Zoho CRM module. This allows managing multiple billing addresses per customer, in addition to the main address.<\/p>\n

                        \n
                      1. In the Zoho CRM integration details, locate the Billing addresses<\/strong><\/li>\n
                      2. In the dropdown next to the toggle, select the CRM module that contains the billing addresses (for example, Billing addresses<\/strong>).
                        \n\"\"<\/li>\n<\/ol>\n

                        Note: <\/em><\/strong>To change the selected CRM module, you must first deactivate the module with the toggle, then delete the field mapping. As long as the module is activated, required fields cannot be deleted. Only manually added fields can be deleted at any time.<\/p><\/blockquote>\n

                          \n
                        1. In Billing address field mapper<\/strong>, click the +<\/strong> and map the required fields: street, city, country, province and postal code.<\/li>\n
                        2. Map the Is main address<\/strong> field to Default<\/strong> in the CRM module.
                          \n\"\"<\/li>\n
                        3. Activate the module by clicking the toggle.
                          \n\"\"<\/li>\n<\/ol>\n

                           <\/p>\n

                          Shipping addresses<\/h3>\n

                          This module synchronizes shipping addresses stored in a custom Zoho CRM module.<\/p>\n

                          The configuration follows the same process as billing addresses:<\/p>\n

                            \n
                          1. In the Zoho CRM integration details, locate the Shipping addresses<\/strong><\/li>\n
                          2. In the dropdown, select the CRM module that contains the shipping addresses (for example, Shipping Addresses<\/strong>).
                            \n\"\"<\/li>\n<\/ol>\n

                            Note: <\/em><\/strong>To change the selected CRM module, you must first deactivate the module with the toggle, then delete the field mappings. As long as the module is activated, required fields cannot be deleted. Only manually added fields can be deleted at any time.<\/p><\/blockquote>\n

                              \n
                            1. In Shipping address field mapper<\/strong>, click the +<\/strong> and map the required fields: street, city, country, province and postal code.<\/li>\n
                            2. Map the Is main address<\/strong> field to Default<\/strong> in the CRM module.
                              \n\"\"<\/li>\n
                            3. Activate the module by clicking the toggle.
                              \n\"\"<\/li>\n<\/ol>\n

                               <\/p>\n

                              Initial synchronization<\/h2>\n

                              Once the configuration is complete, launch an initial synchronization to import existing customers from Zoho CRM to ALIX.<\/p>\n

                                \n
                              1. In the Zoho CRM integration details, click the synchronization icon (cloud) next to the Customers.
                                \n\"\"
                                \n<\/strong><\/li>\n
                              2. The progress is displayed in a toast at the bottom of the screen. Wait for the synchronization to complete.
                                \n\"\"<\/li>\n
                              3. Once the synchronization is complete, verify the imported customers in Sales -> Customers<\/strong>.<\/li>\n<\/ol>\n

                                Note: <\/em><\/strong>If customers with the same name already exist in ALIX, they are automatically linked to the corresponding CRM account without creating duplicates.<\/p>\n

                                Note: <\/em><\/strong>Subsequent synchronizations are faster. Only customers that have been modified since the last synchronization are processed. Others are skipped.<\/p><\/blockquote>\n","protected":false},"excerpt":{"rendered":"

                                -> Integration coming soon ALIX\u2019s integration with Zoho CRM enables bidirectional synchronization of customers between both systems. Customers created or […]<\/p>\n","protected":false},"author":6,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","theme-transparent-header-meta":"default","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"set","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}}},"doc_category":[494],"doc_tag":[],"year_month":"2026-04","word_count":1000,"total_views":0,"reactions":{"happy":0,"normal":0,"sad":0},"author_info":{"name":"Genevi\u00e8ve Lamarche","author_nicename":"glamarche","author_url":"https:\/\/alix.ai\/documentation\/author\/glamarche\/"},"doc_category_info":[{"term_name":"Integrations","term_url":"https:\/\/alix.ai\/documentation\/en\/docs-category\/integrations-en\/"}],"doc_tag_info":[],"_links":{"self":[{"href":"https:\/\/alix.ai\/documentation\/wp-json\/wp\/v2\/docs\/19853"}],"collection":[{"href":"https:\/\/alix.ai\/documentation\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/alix.ai\/documentation\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/alix.ai\/documentation\/wp-json\/wp\/v2\/users\/6"}],"replies":[{"embeddable":true,"href":"https:\/\/alix.ai\/documentation\/wp-json\/wp\/v2\/comments?post=19853"}],"version-history":[{"count":9,"href":"https:\/\/alix.ai\/documentation\/wp-json\/wp\/v2\/docs\/19853\/revisions"}],"predecessor-version":[{"id":19898,"href":"https:\/\/alix.ai\/documentation\/wp-json\/wp\/v2\/docs\/19853\/revisions\/19898"}],"wp:attachment":[{"href":"https:\/\/alix.ai\/documentation\/wp-json\/wp\/v2\/media?parent=19853"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/alix.ai\/documentation\/wp-json\/wp\/v2\/doc_category?post=19853"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/alix.ai\/documentation\/wp-json\/wp\/v2\/doc_tag?post=19853"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}