--- title: "Two-way synchronization of Joomla users and amoCRM contacts - WebTolk websites development, Joomla Extensions" description: "How to create a Joomla user profile for all contacts in amoCRM. How to create a contact in amoCRM for Joomla users when registering on the site." url: "https://web-tolk.ru/en/dev/biblioteki/wt-amo-crm-library/documentation/two-way-synchronization-of-joomla-users-and-amocrm-contacts" date: "2026-06-19T04:25:41+00:00" language: "en-GB" --- # Two-way synchronization of Joomla users and amoCRM contacts WT Amo CRM library - Documentation **Category:** [Libraries](https://web-tolk.ru/en/dev/biblioteki) [Project](https://web-tolk.ru/en/dev/biblioteki/wt-amo-crm-library)[Versions](https://web-tolk.ru/en/dev/biblioteki/wt-amo-crm-library/versions)[Documentation](https://web-tolk.ru/en/dev/biblioteki/wt-amo-crm-library/documentation)[GitHub](https://github.com/WebTolk/WT-Amo-CRM-library-for-Joomla-4) How to create a Joomla user profile for all contacts in amoCRM. How to create a contact in amoCRM for Joomla users when registering on the site. The WT AmoCRM library includes the **User - WT AmoCRM user sync** plugin, which offers basic integration scenarios between Joomla and AmoCRM in both directions. Integrating two different systems is a complex process that requires considering numerous nuances and the specific logic of a particular business. Therefore, the details of each specific integration can sometimes vary significantly. In some cases, it might be easier to create several custom plugins to address your specific tasks. This plugin is not an absolutely universal tool and may not fully meet your requirements. Enable the **User - WT AmoCRM user sync** plugin in the **System - Manage - Plugins** section. You can find the plugin by searching for the term **amo** or by using filters (search parameters). ![How to find the Joomla AmoCRM integration plugin](https://web-tolk.ru/en/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/joomla-amocrm-user-synchronization/1-en.webp)How to find the Joomla AmoCRM integration plugin ## Creating AmoCRM contacts upon Joomla user registration or creation **Data source:** Joomla. **Data destination:** AmoCRM. Plugin settings: Create contact in AmoCRM?Yes or No. When a Joomla user is created or registers independently, a contact will be created in AmoCRM.Contact TagsA dropdown list with tags loaded from AmoCRM. If selected, new contacts will be assigned the selected AmoCRM tags. ![Selecting an AmoCRM tag for a contact when creating a Joomla user](https://web-tolk.ru/en/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/joomla-amocrm-user-synchronization/2-en.webp)Selecting an AmoCRM tag for a contact when creating a Joomla userUpdate contact data in AmoCRM when updated in Joomla?Yes or No. If Joomla user data is changed, should the data in the linked AmoCRM contact be updated?Field for Joomla user linkFor an AmoCRM contact, you can create a field of type **link** to store a link to the Joomla user profile. This is convenient for quick navigation between the Joomla and AmoCRM interfaces. ![Joomla profile field in the AmoCRM contact interface](https://web-tolk.ru/en/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/joomla-amocrm-user-synchronization/3.webp)Joomla profile field in the AmoCRM contact interface A tab named "AmoCRM" is added to the Joomla user edit page, where you can find a direct link to this user's contact in AmoCRM. ![Link to AmoCRM contact in the Joomla user profile](https://web-tolk.ru/en/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/joomla-amocrm-user-synchronization/4-en.webp)Link to AmoCRM contact in the Joomla user profile ## Configuring mapping between Joomla user fields and AmoCRM contact fields Configure the mapping between AmoCRM contact fields and Joomla user fields. You can store field data in the `params` property of the user object (for developers) or in custom fields. These settings are also used when processing incoming webhooks from AmoCRM and by the CLI contact import plugin **Console - WT Import AmoCRM contacts**. ![Mapping AmoCRM and Joomla data fields](https://web-tolk.ru/en/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/joomla-amocrm-user-synchronization/5-en.webp)Mapping AmoCRM and Joomla data fields ### What is the difference between custom fields and the `$user['params']` property? The main difference is the storage location of the data and the possibilities for editing and cleaning them. ### Storing data in Joomla custom fields for users **Joomla Custom Fields** are created manually in the admin panel beforehand. After that, you select which AmoCRM contact property should be placed into which Joomla user field. Technically, field values are stored in a separate table in the database: `#__field_values`. Joomla fields use `ACL` (Access Control List) - access level groups. This means you can control the visibility of data received from AmoCRM for different access levels. You can change them by editing the user. In code, `FieldsHelper` is used to get the field data for a user. ``` $urser_id], true); // Joomla uses Symfony vardamper dump($fields ); ``` **Less obvious drawbacks:** Since `FieldsHelper` uses ACL, it requires a session to determine the current user. In some cases (external requests without cookies, for example) a session is not created, and it becomes impossible to get a field via `FieldsHelper`. ### Storing data in the `$user['params']` property of the user object. `params` is a column in the `#__users` table in Joomla where you can store your required data in **json** format. The advantage of this approach is that you don't need to use `FieldsHelper` to get the AmoCRM contact data. **Every time you get a user object, you already have this data immediately.** This is very convenient in cases of large and long loops where **you don't need to make a separate database query for each iteration** or build additional `JOIN`s in SQL queries. Considering that `FieldsHelper` uses ACL, this adds several more `JOIN`s and additional queries to the tables storing access rights. In your code, you get the user and simply access their `params` property. Note that `params` is a json string, which you can convert into a `Registry` object for convenience. However, you can access a "ready" property via the method `getParam($key, $default_value)`; ``` getIdentity(); // Similarly $user_id = 17; $user = new User($user_id ); $telegram = $user->getParam('amocrm.telegram', null); ``` **Drawbacks of this approach:** This data is not available anywhere in the admin panel in the standard implementation. You can only manage this data in code. The choice of storage location for each AmoCRM contact property directly depends on the features of your integration and the nuances of working with the data. To be continued... ## JSON-LD Schema ```json { "@context": "https://schema.org", "@type": "BreadcrumbList", "@id": "https://web-tolk.ru/#/schema/BreadcrumbList/17", "itemListElement": [ { "@type": "ListItem", "position": 1, "item": { "@id": "https://web-tolk.ru/en", "name": "Home" } }, { "@type": "ListItem", "position": 2, "item": { "@id": "https://web-tolk.ru/en/dev", "name": "Joomla extensions" } }, { "@type": "ListItem", "position": 3, "item": { "@id": "/en/dev/biblioteki", "name": "Libraries" } }, { "@type": "ListItem", "position": 4, "item": { "@id": "/en/dev/biblioteki/wt-amo-crm-library", "name": "WT Amo CRM library" } }, { "@type": "ListItem", "position": 5, "item": { "@id": "/en/dev/biblioteki/wt-amo-crm-library/documentation", "name": "Documentation" } }, { "@type": "ListItem", "position": 6, "item": { "name": "Two-way synchronization of Joomla users and amoCRM contacts" } } ] } ``` ```json { "@context": "https://schema.org", "@graph": [ { "@type": "Organization", "@id": "https://web-tolk.ru/#/schema/Organization/base", "name": "WebTolk", "url": "https://web-tolk.ru/", "logo": { "@type": "ImageObject", "@id": "https://web-tolk.ru/#/schema/ImageObject/logo", "url": "images/webtolk-1080p.jpg", "contentUrl": "images/webtolk-1080p.jpg", "width": 1920, "height": 1080 }, "image": { "@id": "https://web-tolk.ru/#/schema/ImageObject/logo" }, "sameAs": [ "https://github.com/WebTolk", "https://github.com/sergeytolkachyov", "https://vk.com/web_tolk", "https://vk.com/webtolkru", "https://tenchat.ru/sergeytolkachyov", "https://t.me/sergeytolkachyov", "https://t.me/webtolkru" ] }, { "@type": "WebSite", "@id": "https://web-tolk.ru/#/schema/WebSite/base", "url": "https://web-tolk.ru/", "name": "WebTolk websites development, Joomla Extensions", "publisher": { "@id": "https://web-tolk.ru/#/schema/Organization/base" } }, { "@type": "WebPage", "@id": "https://web-tolk.ru/#/schema/WebPage/base", "url": "https://web-tolk.ru/en/dev/biblioteki/wt-amo-crm-library/documentation/two-way-synchronization-of-joomla-users-and-amocrm-contacts", "name": "Two-way synchronization of Joomla users and amoCRM contacts - WebTolk websites development, Joomla Extensions", "description": "How to create a Joomla user profile for all contacts in amoCRM. How to create a contact in amoCRM for Joomla users when registering on the site.", "isPartOf": { "@id": "https://web-tolk.ru/#/schema/WebSite/base" }, "about": { "@id": "https://web-tolk.ru/#/schema/TechArticle/base" }, "inLanguage": "en-GB", "breadcrumb": { "@id": "https://web-tolk.ru/#/schema/BreadcrumbList/17" } }, { "@type": "TechArticle", "headline": "Two-way synchronization of Joomla users and amoCRM contacts", "url": "https://web-tolk.ru/en/dev/biblioteki/wt-amo-crm-library/documentation/two-way-synchronization-of-joomla-users-and-amocrm-contacts", "description": "How to create a Joomla user profile for all contacts in amoCRM. How to create a contact in amoCRM for Joomla users when registering on the site.", "mainEntityOfPage": { "@type": "WebPage", "url": "https://web-tolk.ru/en/dev/biblioteki/wt-amo-crm-library/documentation/two-way-synchronization-of-joomla-users-and-amocrm-contacts" } } ] } ```