PHPackages                             cl-lab/amo-middleware - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. cl-lab/amo-middleware

ActiveLibrary[API Development](/categories/api)

cl-lab/amo-middleware
=====================

Обёртка для библиотек работающих с API AmoCRM

v1.0.2(8y ago)034MITPHPPHP >=5.5.0

Since Sep 28Pushed 8y agoCompare

[ Source](https://github.com/cl-lab/amo-middleware)[ Packagist](https://packagist.org/packages/cl-lab/amo-middleware)[ RSS](/packages/cl-lab-amo-middleware/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (1)Versions (4)Used By (0)

Обёртка для библиотек работающих с API amoCRM
=============================================

[](#обёртка-для-библиотек-работающих-с-api-amocrm)

Установка
---------

[](#установка)

### Через composer:

[](#через-composer)

```
$ composer require cl-lab/amo-middleware
```

Использование
-------------

[](#использование)

Для использования обёртки пропишите в файле:

use CleverLab\\AmoCRM\\Middleware;

$amo = new Middleware('SUBDOMAIN', 'LOGIN', 'HASH');

$result = $amo->getAccount();

Соглашения
----------

[](#соглашения)

Любая обёртка для библиотеки должна реализовывать интерфейс CleverLab\\AmoCRM\\Interfaces\\iMiddleware

Это будет гарантировать единообразие и наличие всех необходимых методов, что позволит избежать ошшибок при изменении обёртки в клиентском коде.

При необходимости изменить поведение метода (заменить используемую им библиотеку и т.д.) не переписывать код имеющихся классов (Унаследовать класс от базового и ереопределить нужные методы).

Документация в анотация
-----------------------

[](#документация-в-анотация)

Каждый метод обёртки, а так же методы интерфейса документированны в формате phpDoc. Так же в большинстве методов указанны ссылки на документацию по оригинальному методу API.

Документация
------------

[](#документация)

### Параметры методов

[](#параметры-методов)

Часть методов, например такие как: получение списка, удаление и др. Являются просто обёрткой над методами библиотеки и принимают на вход точно такие же параметры как и метод библиотеки. Подробнее узнать о передаваемых параметрах можно в документации по API AmoCRM.

Но, методы отвечающие за добавление и групповое добавление берут работу по созданию объектов на себя и принимают на вход параметры для создания этих объектов.

Рассмотрим пример добавления сделки:

За добавление одной сделки отвечает метод addLead($parameters, $debug = false).

Как же должен выглядеть массив содержащийся в $parameters? $parameters является ассациативным массивом который может содержать все те параметры, которые допустимы для данного метода [https://developers.amocrm.ru/rest\_api/leads\_set.php](https://developers.amocrm.ru/rest_api/leads_set.php) но сложности начинаются на таком параметре как 'custom\_fields'. Установка этого параметра в библиотеке dotzero/amocrm-php осуществляется следующим методом:

```
$lead->addCustomField(167379, [[388733, 'Стартап']]);

```

Поэтому при передаче параметров ваш массив параметров должен выглядеть так:

```
$parameters = array(
    'name' => 'Тестовая сделка',
    'responsible_user_id' => '697344',
    ...
    'custom_fields' => array(
        array(
            'id' => 167379,
            'value' => [[388733, 'Стартап']],
        ),
    ),
);

```

Метод так же принимает два необязательных параметра "enum" и "subtype", при необходимости их так же можно указать:

```
$parameters = array(
    'name' => 'Тестовая сделка',
    'responsible_user_id' => '697344',
    ...
    'custom_fields' => array(
        array(
            'id' => 167379,
            'value' => [[388733, 'Стартап']],
            'enum' => true,
            'subtitle' => true,
        ),
    ),
);

```

При групповом добавлении передаётся список параметров.

За групповое добавление сделок отвечает метод addGroupOfLeads($dataList, $debug = false).

```
$dataList = array(
    array(
        'name' => 'Тестовая сделка',
        'responsible_user_id' => '697344',
        ...
        'custom_fields' => array(
            array(
                'id' => 167379,
                'value' => [[388733, 'Стартап']],
            ),
        ),
    ),
    array(
        'name' => 'Тестовая сделка2',
        'responsible_user_id' => '789344',
        ...
        'custom_fields' => array(
            array(
                'id' => 167379,
                'value' => [[388733, 'Стартап']],
            ),
            array(
                'id' => 168596,
                'value' => [[384533, 'Стартап2']],
            ),
        ),
    ),
);

```

При добавлении других сущностей, действуют те же принципы.

При возниконовении вопросов, смотрите метод setParameters($object, $parameters)

При добавлении сущностей типа "Воронки и этапы продаж" вы столкнётесь с параметром "statuses\_fields". В dotzero/amocrm-php данный параметр устанавливается следующим методом:

```
$pipeline->addStatusField([
    'name' => 'Pending',
    'sort' => 10,
    'color' => '#fffeb2',
]);

```

В этом случаи ваш массив должен выглядеть так:

```
$parameters = array(
    'name' => 'Воронка 1',
    'sort' => 1,
    ...
    'statuses_fields' => array(
        array(
            'parameters' => array(
                'name' => 'Pending',
                'sort' => 10,
                'color' => '#fffeb2',
            ),
        ),
    )
);

```

Метод "addStatusField" в качетве необязательного параметра может принимать уникальный идентификатор этапа воронки.

Чтобы его передать сформируйте массив параметров следующим образом:

```
$parameters = array(
    'name' => 'Воронка 1',
    'sort' => 1,
    ...
    'statuses_fields' => array(
        array(
            'parameters' => array(
                'name' => 'Pending',
                'sort' => 10,
                'color' => '#fffeb2',
            ),
            'id' => 12345,
        ),
    )
);

```

Для множественного добавления воронок, так же как и в случаи со сделками, сформируйте массив параметров. Как например:

```
$dataList = array(
    $parameters = array(
        'name' => 'Воронка 1',
        'sort' => 1,
        ...
        'statuses_fields' => array(
            array(
                'parameters' => array(
                    'name' => 'Pending',
                    'sort' => 10,
                    'color' => '#fffeb2',
                ),
                'id' => 12345,
            ),
        )
    ),
    $parameters = array(
        'name' => 'Воронка 2',
        'sort' => 1,
        ...
        'statuses_fields' => array(
            array(
                'parameters' => array(
                    'name' => 'Pending2',
                    'sort' => 11,
                    'color' => '#fffeb2',
                ),
            ),
            array(
                'parameters' => array(
                    'name' => 'Pending3',
                    'sort' => 2,
                    'color' => '#fffeb2',
                ),
                'id' => 2154,
            ),
        )
    )
);

```

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity60

Established project with proven stability

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~2 days

Total

3

Last Release

3142d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/8ae55ee9d77006bfa29c6ec7d3822e959cdff147fca798f259919d080c87e855?d=identicon)[will-evil](/maintainers/will-evil)

---

Tags

middlewareapicrmamoCRM

### Embed Badge

![Health badge](/badges/cl-lab-amo-middleware/health.svg)

```
[![Health](https://phpackages.com/badges/cl-lab-amo-middleware/health.svg)](https://phpackages.com/packages/cl-lab-amo-middleware)
```

###  Alternatives

[dotzero/amocrm

Удобный и быстрый клиент для работы с API amoCRM

221431.7k9](/packages/dotzero-amocrm)[dotzero/laravel-amocrm

ServiceProvider и Facade для Laravel 5 предоставляющие интеграцию с API amoCRM

3229.2k](/packages/dotzero-laravel-amocrm)[dotzero/yii2-amocrm

Расширение для Yii Framework 2 реализующее клиент для работы с API amoCRM

1639.7k](/packages/dotzero-yii2-amocrm)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)