--- title: "PHP библиотека для Joomla и Amo CRM - WebTolk" description: "Небольшая PHP библиотека для Joomla 4 / Joomla 5 / Joomla 6 и Amo CRM. Для разработчиков." url: "https://web-tolk.ru/dev/biblioteki/wt-amo-crm-library" date: "2026-05-31T13:52:33+00:00" language: "ru-RU" --- ![WT Amo CRM library](https://web-tolk.ru/images/swjprojects/projects/57/ru-RU/cover.webp) --- # WT Amo CRM library - **Категории:** [Библиотеки](https://web-tolk.ru/dev/biblioteki), [Расширения для Joomla 4 - Joomla 6](https://web-tolk.ru/dev/rasshireniya-dlya-joomla-4) - **Версия:** 1.3.1 - **Дата:** 04 октября 2025 9275 7691 CTR 121% Pack Free [Скачать](https://web-tolk.ru/get?element=pkg-lib-wt-amocrm)[Версии](https://web-tolk.ru/dev/biblioteki/wt-amo-crm-library/versions)[Документация](https://web-tolk.ru/dev/biblioteki/wt-amo-crm-library/documentation)[GitHub](https://github.com/WebTolk/WT-Amo-CRM-library-for-Joomla-4) Небольшая PHP библиотека для Joomla 4 / Joomla 5 / Joomla 6 и Amo CRM. Для разработчиков. ![WT Amo CRM library](https://web-tolk.ru/images/swjprojects/projects/57/ru-RU/icon.jpg) ## Описание Пакет представляет собой набор расширений для удобной работы с REST API AmoCRM в Joomla. Библиотека не требует установки никаких дополнительных программных пакетов (зависимостей), использует только API Joomla. Код библиотеки документирован и IDE (профессиональные среды разработки) будут показывать подсказки по кодовой базе. Версии 1.3+ работают только с Joomla 5.1+. Эта библиотека в чистом виде будет интересна скорее всего только профессиональным разработчикам и интеграторам. ### Видео Как быстро настроить интеграцию AmoCRM и сайта на Joomla?Использовать PHP библиотеку WT AmoCRM для Joomla, которая предполагает использование её разработчиками. А разработчики могут написать любое количество плагинов и решений по интеграции и автоматизации AmoCRM и Joomla. Содержание видео: - 00:15 - что такое эта библиотека и как она работает? Тех.ликбез. - 03:00 - установка с сайта или с GitHub - 04:00 - собственно установка и настройка интеграции. - 05:10 - создание внешней интеграции в интерфейсе AmoCRM - 08:05 - что-то пошло не так... Почему и как исправить (случай с пересозданием интеграции) - 08:48 - успешное подключение к AmoCRM - 11:11 - как понять что всё работает? - 11:50 - демонстрация работы: отправка заказа из компонента интернет-магазина RadicalMart в AmoCRM - 14:20 - потенциальные возможности по автоматизации бизнес-процессов в связке Joomla с AmoCRM Так же это видео: - [на YouTube](https://www.youtube.com/watch?v=mGPgbpgJHt8) - [на RuTube](https://rutube.ru/video/6f7e3a0ee5ccf47f7e61a11373194a18/) - [на VK Видео](https://vkvideo.ru/video-230331145_456239026) ### Состав пакета В составе пакета: WT Amo CRM LibraryБиблиотека интеграции Joomla и AmoCRMСистема - WT Amo CRM Libraryплагин хранения настроек для подключения к AmoCRMПользователь - WT AmoCRM user synсПлагин для синхронизации данных контактов AmoCRM и пользователей JoomlaКонсоль - WT import AmoCRM contactsПлагин для CLI Joomla (команды консоли сервера) для добавления команд в CLI Joomla ### Авторизация библиотеки в REST API AmoCRM Для хранения данных авторизации в AmoCRM служит плагин **Система - WT Amo CRM Library**. В нём вы указываете домен, секретный ключ, токен, ID интеграции и т.д. Библиотека получает данные из параметров плагина. Поддерживаются как обычные, так и долгоживущие (долгосрочные) токены. #### Удаление старого refresh token Если вы используете обычные токены, а не долгосрочные, то Amo CRM выдаёт access-токен на одни сутки. Для получения нового токена используется refresh-токен. Refresh токен действует всего 3 месяца. Если интеграция не используется в течение 3 месяцев, не было ни одного запроса на актуализацию ключа, то интеграция потеряет доступ к данным и будем необходимо повторно создавать и настраивать интеграцию. Для упрощения этого процесса в параметры плагина **добавлена кнопка удаления старого refresh-токен из базы данных**. Если refresh-токен есть в базе данных - отображается дата его получения. Вы должны использовать эту кнопку только в том случае, если срок действия вашего refresh-токена истек и вам необходимо удалить его из настроек библиотеки. ### Подключение библиотеки в своё расширение для Joomla ``` use Webtolk\Amocrm\Amocrm; $amocrm = new Amocrm(); $accountData = $amocrm->account()->getAccountInfo(); // Joomla uses a Symfony vardumper dump($accountData); ``` ### Список сущностей AmoCRM для работы из Joomla PHP-классы поддерживаемых сущностей находятся в папке `src/Entities`. 1. **\Webtolk\Amocrm\Entities\Account** `$amocrm->account()` - получение информации об аккаунте 2. **\Webtolk\Amocrm\Entities\Contacts** `$amocrm->contacts()` - работа с сущностью контактов AmoCRM 3. **\Webtolk\Amocrm\Entities\Customfields** `$amocrm->customfields()` - работа с кастомными полями сущностей AmoCRM 4. **\Webtolk\Amocrm\Entities\Leads** `$amocrm->leads()` - работа с сущностью сделок AmoCRM 5. **\Webtolk\Amocrm\Entities\Notes** `$amocrm->notes()` - работа с примечаниями к сущностям AmoCRM 6. **\Webtolk\Amocrm\Entities\Tags** `$amocrm->tags()` - работа с сущностью тегов AmoCRM 7. **\Webtolk\Amocrm\Entities\Users** `$amocrm->users()` - работа с сущностью пользователей AmoCRM 8. **\Webtolk\Amocrm\Entities\Webhooks** `$amocrm->webhooks()` - работа с вебхуками AmoCRM ### Синхронизация пользователей Joomla и AmoCRM. Двухсторонняя интеграция. Плагин **Пользователь - WT AmoCRM user synс** в поставке библиотеки позволяет как создавать новые контакты в AmoCRM при создании / регистрации пользователей в Joomla, так и создавать пользователей Joomla при создании контактов AmoCRM. Возможно обновлять информацию в одной системе при изменении данных в другой. Настройки сопоставления полей Joomla и AmoCRM. Данные также можно хранить в свойстве `params` объекта пользователя (`$user->params`). Сопоставление полей настраивается в параметрах плагина. ### CLI плагин импорта пользователей Joomla из контактов AmoCRM. В AmoCRM есть экспорт данных в CSV. Однако, возможно из-за большого количества разного рода интеграций, данные не всегда корректно экспортируются. Дабы избежать проблем с нарушением структуры данных было принято решение сделать более медленный импорт данных напрямую по REST API. Команды для выполнения в консоли сервера можно увидеть в параметрах плагина группы `console`. ### Обработка входящих вебхуков AmoCRM в Joomla. В системном плагине добавлена единая точка входа для вебхуков со стороны AmoCRM. В дальнейшем информация из вебхука передаётся плагинам групп `system`, `user` и `amocrm`, срабатывающим на событие `onAmocrmIncomingWebhook`. Вы можете создать собственный плагин, который будет слушать это событие и обрабатывать данные или выполнять некие действия на стороне Joomla при событиях в AmoCRM. ### Коллекция полей Joomla Form с данными из AmoCRM для разработчиков. Для использования в расширениях Joomla создана коллекция полей Joomla Form. Эти поля используются в плагинах самой библиотеки, однако разработчики могут использовать готовые поля и в сторонних расширениях. Классы полей находятся в папке `src/Fields` библиотеки. Для корректной работы поля необходимо в XML-манифесте вашего расширения (плагин, модуль, компонент) указать атрибут `addfieldprefix` с неймспейсом библиотеки. ``` ``` Список полей на текущий момент: - `Accountinfo` - поле с информацией об аккаунте AmoCRM - `Companiestagslist` - выпадающий список тегов компаний AmoCRM - `Companycustomfieldslist` - выпадающий список пользовательских полей компаний AmoCRM - `Contactcustomfieldslist` - выпадающий список пользовательских полей контактов AmoCRM - `Contactinfo` - информация о контакте и ссылка на него в AmoCRM - `Contactstagslist` - выпадающий список тегов контактов AmoCRM - `Entitymodalselect` - модальное (всплывающее) окно для выбора id сущности: сделки или контакта. - `Leadcustomfieldslist` - выпадающий список пользовательских полей сделки AmoCRM - `Leadspipelineslist` - выпадающий список воронок AmoCRM - `Leadstagslist` - выпадающий список тегов сделок AmoCRM - `Webhookslist` - информация о вебхуках аккаунта AmoCRM и их ограничениях. Поля реализованы с использованием `layouts` Joomla. При острой необходимости вы можете переопределить макет вывода поля штатными средствами Joomla. ### Группа плагинов `amocrm` для разработчиков Чтобы гибкие и сложные интеграции не влияли скорость работы сайта - добавлена специализированная группа для плагинов - amocrm. Вы можете создать собственный плагин этой группы и работать с данными AmoCRM не затрагивая остальные разделы Joomla. ## Joomla **Тип расширения:** Пакет **Состав пакета:** Библиотека, Плагин **Версия Joomla:** 4.1, 4.2, 4.3.4, 5.0.0, 6.0.0 ## Галерея ![...](https://web-tolk.ru/dev/biblioteki/images/swjprojects/projects/57/ru-RU/gallery/1lCt6h3n9uy.webp) ![...](https://web-tolk.ru/dev/biblioteki/images/swjprojects/projects/57/ru-RU/gallery/4TGDsrPRULt.webp) ![...](https://web-tolk.ru/dev/biblioteki/images/swjprojects/projects/57/ru-RU/gallery/7sogN2rXUlL.webp) ![...](https://web-tolk.ru/dev/biblioteki/images/swjprojects/projects/57/ru-RU/gallery/BLybTy1bAMu.webp) ![...](https://web-tolk.ru/dev/biblioteki/images/swjprojects/projects/57/ru-RU/gallery/Gxkmt8jLmcl.webp) ![...](https://web-tolk.ru/dev/biblioteki/images/swjprojects/projects/57/ru-RU/gallery/IIFidnfDtSI.webp) ![...](https://web-tolk.ru/dev/biblioteki/images/swjprojects/projects/57/ru-RU/gallery/JSNzZaRnj5v.webp) ![...](https://web-tolk.ru/dev/biblioteki/images/swjprojects/projects/57/ru-RU/gallery/LoNZCx6SneD.webp) ![...](https://web-tolk.ru/dev/biblioteki/images/swjprojects/projects/57/ru-RU/gallery/aHreMJdd3XT.webp) ![...](https://web-tolk.ru/dev/biblioteki/images/swjprojects/projects/57/ru-RU/gallery/egKKlvuMsSF.webp) ![...](https://web-tolk.ru/dev/biblioteki/images/swjprojects/projects/57/ru-RU/gallery/kOovDcUI3vG.webp) ![...](https://web-tolk.ru/dev/biblioteki/images/swjprojects/projects/57/ru-RU/gallery/rP9N1hg0mfk.webp) ![...](https://web-tolk.ru/dev/biblioteki/images/swjprojects/projects/57/ru-RU/gallery/sVl3N1y7DtA.webp) ![...](https://web-tolk.ru/dev/biblioteki/images/swjprojects/projects/57/ru-RU/gallery/0cypJFu4Y6y.jpg) ![...](https://web-tolk.ru/dev/biblioteki/images/swjprojects/projects/57/ru-RU/gallery/xrMNFsz6aYI.webp) ## Что нового 04.10.2025, 18:04:47 Исправлено ### Исправление ошибок Исправлена ошибка обновления полей AmoCRM контакта при сохранении пользователя через фронтенд форму. --- ## Смотрите также [!\[WT AmoCRM - RadicalForm\](https://web-tolk.ru/images/swjprojects/projects/58/ru-RU/icon.jpg) WT AmoCRM - RadicalForm](https://web-tolk.ru/dev/joomla-plugins/wt-amocrm-radicalform) [!\[WT AmoCRM - JoomShopping\](https://web-tolk.ru/images/swjprojects/projects/61/ru-RU/icon.jpg) WT AmoCRM - JoomShopping](https://web-tolk.ru/dev/joomla-plugins/wt-amocrm-joomshopping) [!\[WT AmoCRM - RadicalMart\](https://web-tolk.ru/images/swjprojects/projects/106/ru-RU/icon.webp) WT AmoCRM - RadicalMart](https://web-tolk.ru/dev/joomla-plugins/wt-amocrm-radicalmart) ## 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/", "name": "Главная" } }, { "@type": "ListItem", "position": 2, "item": { "@id": "https://web-tolk.ru/dev", "name": "Расширения Joomla" } }, { "@type": "ListItem", "position": 3, "item": { "@id": "/dev/biblioteki", "name": "Библиотеки" } }, { "@type": "ListItem", "position": 4, "item": { "name": "WT Amo CRM library" } } ] } ``` ```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", "publisher": { "@id": "https://web-tolk.ru/#/schema/Organization/base" } }, { "@type": "WebPage", "@id": "https://web-tolk.ru/#/schema/WebPage/base", "url": "https://web-tolk.ru/dev/biblioteki/wt-amo-crm-library", "name": "PHP библиотека для Joomla и Amo CRM - WebTolk", "description": "Небольшая PHP библиотека для Joomla 4 / Joomla 5 / Joomla 6 и Amo CRM. Для разработчиков.", "isPartOf": { "@id": "https://web-tolk.ru/#/schema/WebSite/base" }, "about": { "@id": "https://web-tolk.ru/#/schema/SoftwareApplication/base" }, "inLanguage": "ru-RU", "breadcrumb": { "@id": "https://web-tolk.ru/#/schema/BreadcrumbList/17" } }, { "@type": "SoftwareApplication", "name": "WT Amo CRM library", "url": "https://web-tolk.ru/dev/biblioteki/wt-amo-crm-library", "description": "Небольшая PHP библиотека для Joomla 4 / Joomla 5 / Joomla 6 и Amo CRM. Для разработчиков.", "applicationCategory": "Библиотеки", "softwareVersion": "1.3.1", "downloadUrl": "https://web-tolk.ru/get?element=pkg-lib-wt-amocrm", "image": "https://web-tolk.ru/images/swjprojects/projects/57/ru-RU/icon.jpg", "operatingSystem": "ANY", "interactionStatistic": [ { "@type": "InteractionCounter", "interactionType": "https://schema.org/DownloadAction", "userInteractionCount": 9275 }, { "@type": "InteractionCounter", "interactionType": "https://schema.org/ViewAction", "userInteractionCount": 7692 } ], "mainEntityOfPage": { "@type": "WebPage", "url": "https://web-tolk.ru/dev/biblioteki/wt-amo-crm-library" }, "softwareRequirements": "Joomla", "applicationSubCategory": "Библиотеки, Расширения для Joomla 4 - Joomla 6", "isAccessibleForFree": true } ] } ```