--- title: "Установка и настройка библиотеки интеграции AmoCRM в Joomla - WebTolk" description: "Как установить и настроить библиотеку Amo CRM в Joomla. Создание интеграции по API на стороне Amo CRM." url: "https://web-tolk.ru/dev/biblioteki/wt-amo-crm-library/documentation/ustanovka-biblioteki-v-joomla-4" date: "2026-06-19T04:53:46+00:00" language: "ru-RU" --- # Установка библиотеки в Joomla WT Amo CRM library - Документация **Категория:** [Библиотеки](https://web-tolk.ru/dev/biblioteki) [Проект](https://web-tolk.ru/dev/biblioteki/wt-amo-crm-library)[Версии](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) Как установить и настроить библиотеку Amo CRM в Joomla. Создание интеграции по API на стороне Amo CRM. ## Видео установки и настройки Как быстро настроить интеграцию 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) ## Установка расширения в Joomla Установка и обновление библиотеки происходит стандартным для Joomla способом через менеджер расширений. Пройдите в `Система - Установка - Расширения`. ![Joomla 4 - Система - установка расширений](https://web-tolk.ru/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/1-ru.jpg) Вернитесь на страницу расширения на сайте [https://web-tolk.ru](https://web-tolk.ru), нажмите правой кнопкой мыши на кнопку "скачать" и выберите "скопировать адрес ссылки". Ссылка на скачивание скопируется в буфер обмена. ![скриншот сайта веб толк ру джумла](https://web-tolk.ru/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/2-ru.jpg) В разделе установки расширений выберите вкладку "Установить по URL" и нажмите "Проверить и установить". Либо же скачайте предварительно zip-архив и установите через вкладку "Загрузить и установить". ![джумла 4 установщик расширений вкладка установить по url](https://web-tolk.ru/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/3-ru.jpg) После успешной установки будет показаный приветственный экран расширения. ![приветственный экран вебтолк расширений джумла](https://web-tolk.ru/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/4-ru.jpg) ## Настройка библиотеки Amo CRM в Joomla Библиотека состоит из собственно библиотеки и системного плагина для настроек библиотеки. Также этот системный плагин регистрирует namespace библиотеки в пространстве имен Joomla. Таким образом, если плагин выключен, Вы не сможете использовать библиотеку и обращение к её namespace будет вызывать ошибку. Пройдите в `Система - Управление - Плагины`. ![джумла 4 система плагины](https://web-tolk.ru/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/5-ru.jpg) Найдите в поиске по плагинам плагин `System - WT Amo CRM Library`. ![Плагин амо срм в списке плагином джумла](https://web-tolk.ru/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/6-ru.jpg) ![поиск по плагинам джумла 4](https://web-tolk.ru/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/7-ru.jpg) По умолчанию плагин выключен и при установке не включается автоматически. Поскольку не указаны аутентификационные данные, будет показано сообщение об ошибке: ***Plugin System - WT Amo CRM: there is no credentials data**.* ![настройки плагина wt amo crm library для Joomla](https://web-tolk.ru/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/8-ru.jpg) Для работы библиотеки нужно указать данные интеграции по API, которая создаётся в интерфейсе AmoCRM. ### Создание внешней интеграции по API AmoCRM Зайдите в свой портал AmoCRM. Выберете в левом меню раздел **amoМаркет**. ![Дашборд амо срм 2023 год](https://web-tolk.ru/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/9-ru.jpg) Для создания интеграции по API выберите "Создать интеграцию" в выпадающем меню с тремя точками около кнопки **WEB HOOKS** в разделе **AmoМаркет**. ![Раздел amo маркет в amo crm](https://web-tolk.ru/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/10-ru.jpg) В модальном окне "Создание интеграции" выберите тип "Внешняя интеграция". В описании типа интеграции сказано: > Внешняя интеграция взаимодействует с API amoCRM при помощи запросов и не требует загрузки ар > ива с JS-кодом виджета. Авторизация и обработка данны > аккаунта проис > одит на стороне сервиса интегратора с помощью доступов выданны > при создании интеграции в аккаунте amoCRM. ![окно создания внешних интеграций amo crm](https://web-tolk.ru/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/11-ru.jpg) Для создания интеграции Joomla и Amo CRM нужно указать URL для вебхуков интеграции, который Вы можете скопировать из настроек плагина `System - WT Amo CRM Library`. На данный момент вебхуки по этому URL никак не обрабатываются. В следующих версиях библиотеки будет добавлена возможность их обработки. Также для создания потребуется указать права доступа интеграции (все), включить контроль дублей, указать её название и описание. ![скопировать callback url для интеграции амо срм и джумла](https://web-tolk.ru/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/12-ru.jpg) Созданную интеграцию можно увидеть в разделе `AmoCRM - AmoМаркет - Установленные - название Вашей интеграции`. ![Список установленных интеграций в амо срм](https://web-tolk.ru/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/13-ru.jpg) Необходимо из вкладки "Ключи и доступы" скопировать в настройки плагина: - **секретный ключ** - в настройках плагина это **Client secret**. - ID интеграции - в настройках плагина это **Client ID** - Код авторизации - в настройках плагина это **Auth code** Код авторизации действует 20 минут и его можно использовать лишь однажды. По истечении 20 минут или неудачной авторизации интеграцию в Amo CRM придется пересоздавать. После успешной авторизации AmoCRM выдает refresh token, который действует одни сутки и хранится в базе данных в параметрах библиотеки. Обновление токена происходит автоматически в случае использовании интеграции. В случае если интеграцией не пользовались в течение 3-х месяцев - её придется пересоздавать заново. ![скопировать client id и client secret для интеграции амо срм и joomla](https://web-tolk.ru/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/14-ru.jpg) В случае успешного подключения и получения `refresh token` в настройках плагина отобразится поле типа `accountinfo` с данными портала и пользователя. ![успешная интеграция амо срм и джумла](https://web-tolk.ru/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/15-ru.jpg) На этом установку и подключение можно считать завершёнными. Библиотеку можно подключать через `use` `Webtolk\Amocrm\Amocrm;`и использовать её методы в своих расширениях. ### Долгосрочные токены AmoCRM Начиная с версии 1.3.0 библиотека поддерживает авторизацию по долгосрочным токенам AmoCRM. Они отличаются от стандартных ограниченным сроком действия, который может составлять до 5 лет. Таким образом даже если ваша интеграция бездействовала более 3-х месяцев - токен по-прежнему будет действовать. С другой стороны вам нужно самостоятельно отслеживать срок окончания действия токена и обновлять его при необходимости. ![Долгосрочные токены AmoCRM в Joomla](https://web-tolk.ru/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/16-ru.webp)Долгосрочные токены AmoCRM в Joomla ## 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": { "@id": "/dev/biblioteki/wt-amo-crm-library", "name": "WT Amo CRM library" } }, { "@type": "ListItem", "position": 5, "item": { "@id": "/dev/biblioteki/wt-amo-crm-library/documentation", "name": "Документация" } }, { "@type": "ListItem", "position": 6, "item": { "name": "Установка библиотеки в Joomla" } } ] } ``` ```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/documentation/ustanovka-biblioteki-v-joomla-4", "name": "Установка и настройка библиотеки интеграции AmoCRM в Joomla - WebTolk", "description": "Как установить и настроить библиотеку Amo CRM в Joomla. Создание интеграции по API на стороне Amo CRM.", "isPartOf": { "@id": "https://web-tolk.ru/#/schema/WebSite/base" }, "about": { "@id": "https://web-tolk.ru/#/schema/TechArticle/base" }, "inLanguage": "ru-RU", "breadcrumb": { "@id": "https://web-tolk.ru/#/schema/BreadcrumbList/17" } }, { "@type": "TechArticle", "headline": "Установка библиотеки в Joomla", "url": "https://web-tolk.ru/dev/biblioteki/wt-amo-crm-library/documentation/ustanovka-biblioteki-v-joomla-4", "description": "Как установить и настроить библиотеку Amo CRM в Joomla. Создание интеграции по API на стороне Amo CRM.", "mainEntityOfPage": { "@type": "WebPage", "url": "https://web-tolk.ru/dev/biblioteki/wt-amo-crm-library/documentation/ustanovka-biblioteki-v-joomla-4" } } ] } ```