---
title: "Installing the WT AmoCRM library in Joomla - WebTolk websites development, Joomla Extensions"
description: "How to install and configure the amoCRM library in Joomla. Creating API integration on the Amo CRM side."
url: "https://web-tolk.ru/en/dev/biblioteki/wt-amo-crm-library/documentation/ustanovka-biblioteki-v-joomla-4"
date: "2026-06-07T14:13:42+00:00"
language: "en-GB"
---

# Installing the library in Joomla

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 install and configure the amoCRM library in Joomla. Creating API integration on the Amo CRM side.

## Installing the extension in Joomla

The library is installed and updated in the standard Joomla way through the extension manager. Go to `System - Installation - Extensions`.

![Joomla 4 - System - install extensions](https://web-tolk.ru/en/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/1-en.jpg)

Go back to the extension page on the site [https://web-tolk.ru](https://web-tolk.ru), right-click on the "download" button and select "copy link address". The download link is copied to the clipboard.

![screenshot of the website <url> jumla](https://web-tolk.ru/en/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/2-en.jpg)

In the extensions installation section, select the "Install by URL" tab and click "Check and Install". Alternatively, pre-download the zip archive and install it via the "Download and Install" tab.

![jumla 4 extension installer tab install by url](https://web-tolk.ru/en/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/3-en.jpg)

After successful installation, the welcome screen of the extension will be displayed.

![welcome screen of jumla extensions webtholk](https://web-tolk.ru/en/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/4-en.jpg)

## Configuring the Amo CRM Library in Joomla

The library consists of the library itself and a system plugin for library settings. Also, this system plugin registers the namespace of the library in the Joomla namespace. Thus, if the plugin is disabled, you will not be able to use the library and accessing its namespace will cause an error.

Go to `System - Management - Plugins`.

![jumla 4 system plugins](https://web-tolk.ru/en/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/5-en.jpg)

Find the `System - WT Amo CRM Library` plugin in the plugin search.

![amo crm plugin in joomla](https://web-tolk.ru/en/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/6-en.jpg)

![search for jumla 4 plugins](https://web-tolk.ru/en/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/7-en.jpg)

By default, the plugin is disabled and does not turn on automatically during installation. Since authentication data is not specified, an error message will be displayed: ***Plugin System - WT Amo CRM: there is no credentials data**.*

![settings of the wt amo crm library plugin for Joomla](https://web-tolk.ru/en/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/8-en.jpg)

For the library to work, you need to specify the API integration data, which is created in the amoCRM interface.

### Creating external integration using the amoCRM API

Log in to your amoCRM portal. Select the **amoMarket** section in the left menu.

![Dashboard amo cpm 2023](https://web-tolk.ru/en/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/9-en.jpg)

To create an API integration, select "Create Integration" in the drop-down menu with three dots near the **WEB HOOKS** button in the **AmoMarket** section.

![amo market section in amo crm](https://web-tolk.ru/en/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/10-en.jpg)

In the modal window "Creating integration", select the type "External integration". The description of the integration type says:

> External integration interacts with the amoCRM API using requests and does not require downloading an archive with the widget's JS code. Authorization and processing of account data takes place on the side of the integrator service using the access granted when creating integration in the amoCRM account.

![window for creating external amo crm integrations](https://web-tolk.ru/en/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/11-en.jpg)

To create Joomla and Amo CRM integration, you need to specify the URL for the integration webhooks, which you can copy from the plugin settings`System - WT Amo CRM Library`. At the moment, webhooks at this URL are not processed in any way. In the next versions of the library, the ability to process them will be added.

Also, to create it, you will need to specify the integration access rights (all), enable duplicate control, specify its name and description.

![copy the callback url to integrate amo cpm and jumla](https://web-tolk.ru/en/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/12-en.jpg)

The created integration can be seen in the section `amoCRM - AmoMarket - Installed - the name of your integration`.

![List of installed integrations in amo cpm](https://web-tolk.ru/en/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/13-en.jpg)

It is necessary to copy from the "Keys and Accesses" tab to the plugin settings:

- **secret key** - in the plugin settings it is **Client secret**.
- Integration ID - in the plugin settings it is **Client ID**
- Authorization code - in the plugin settings it is **Auth code**

The authorization code is valid for 20 minutes and can be used only once. After 20 minutes or unsuccessful authorization, the integration into Amo CRM will have to be recreated.

After successful authorization, amoCRM issues a refresh token, which is valid for one day and is stored in the database in the library parameters. The token is updated automatically when integration is used.

If the integration has not been used for 3 months, it will have to be recreated again.

![copy client id and client secret to integrate amo cpm and joomla](https://web-tolk.ru/en/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/14-en.jpg)

In case of successful connection and receipt of the `refresh token`, a field of the `accountinfo` type with portal and user data will be displayed in the plugin settings.

![successful integration amo crm with joomla](https://web-tolk.ru/en/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/15-en.jpg)

At this point, the installation and connection can be considered completed. The library can be connected via `use` `Webtolk\Amocrm\Amocrm;`and use its methods in its extensions.

### Long-term amoCRM tokens in Joomla

Starting from version 1.3.0, the library supports authorization using long-term amoCRM tokens. They differ from the standard ones with a limited validity period, which can be up to 5 years. Thus, even if your integration has been inactive for more than 3 months, the token will still be valid. On the other hand, you need to independently track the expiration date of the token and update it if necessary.

 ![Долгосрочные токены AmoCRM в Joomla](https://web-tolk.ru/en/dev/biblioteki/wt-amo-crm-library/documentation/images/development/joomla/libraries/wt_amocrm/16-ru.webp)Long-term amoCRM tokens in 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/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": "Installing the library in 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 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/ustanovka-biblioteki-v-joomla-4",
            "name": "Installing the WT AmoCRM library in Joomla - WebTolk websites development, Joomla Extensions",
            "description": "How to install and configure the amoCRM library in Joomla. Creating API integration on the Amo CRM side.",
            "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": "Installing the library in Joomla",
            "url": "https://web-tolk.ru/en/dev/biblioteki/wt-amo-crm-library/documentation/ustanovka-biblioteki-v-joomla-4",
            "description": "How to install and configure the amoCRM library in Joomla. Creating API integration on the Amo CRM side.",
            "mainEntityOfPage": {
                "@type": "WebPage",
                "url": "https://web-tolk.ru/en/dev/biblioteki/wt-amo-crm-library/documentation/ustanovka-biblioteki-v-joomla-4"
            }
        }
    ]
}
```