PHPackages                             ufee/amoapi - 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. [Authentication & Authorization](/categories/authentication)
4. /
5. ufee/amoapi

ActiveLibrary[Authentication & Authorization](/categories/authentication)

ufee/amoapi
===========

amoCRM API V2 Client, V4: (https://packagist.org/packages/ufee/amoapi-v4)

0.9.4.8(8mo ago)4523.5k↑22.2%22[5 issues](https://github.com/ufee/amoapi/issues)1MITPHPPHP >=5.6CI failing

Since Mar 25Pushed 8mo ago7 watchersCompare

[ Source](https://github.com/ufee/amoapi)[ Packagist](https://packagist.org/packages/ufee/amoapi)[ Docs](https://github.com/ufee)[ RSS](/packages/ufee-amoapi/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (1)Versions (69)Used By (1)

AmoCRM API Client
-----------------

[](#amocrm-api-client)

Клиент для работы с amoCRM Api v2
Поддержка Api v4 в клиенте: [amoapi-v4](https://github.com/ufee/amoapi-v4)

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

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

```
composer require ufee/amoapi

```

Запуск тестов
-------------

[](#запуск-тестов)

Отредактировать vendor/ufee/amoapi/tests/Config.php

```
composer require --dev phpunit/phpunit ^5
vendor/bin/phpunit vendor/ufee/amoapi

```

Инициализация клиента по oAuth
------------------------------

[](#инициализация-клиента-по-oauth)

Хранение oauth токена возможно в нескольких вариантах

#### Файловое хранилище

[](#файловое-хранилище)

Используется по умолчанию (/vendor/ufee/amoapi/src/Cache/), можно задать свой путь
Создается поддиректория: {path}/{domain}/{client\_id}.json
Настоятельно рекомендуется использовать cвой путь для кеширования, в противном случае данные будут УДАЛЕНЫ composer'ом при обновлении на новую версию.

```
\Ufee\Amo\Oauthapi::setOauthStorage(
	new \Ufee\Amo\Base\Storage\Oauth\FileStorage(['path' => '/full/oauth/path'])
);
```

#### Redis

[](#redis)

Поддерживается библиотека [phpredis](https://github.com/phpredis/phpredis)
Формат ключа: {domain}\_{client\_id}

```
$redis = new \Redis();
$redis->connect('/var/run/redis/redis.sock');
$redis->setOption(\Redis::OPT_SERIALIZER, \Redis::SERIALIZER_PHP);
$redis->select(5); // switch to specific db

\Ufee\Amo\Oauthapi::setOauthStorage(
	new \Ufee\Amo\Base\Storage\Oauth\RedisStorage(['connection' => $redis])
);
```

#### MongoDB

[](#mongodb)

Поддерживается библиотека [mongodb](https://github.com/mongodb/mongo-php-library)

```
$mongo = new \MongoDB\Client('mongodb://host');
$collection = $mongo->selectCollection('database', 'some_collection');

\Ufee\Amo\Oauthapi::setOauthStorage(
	new \Ufee\Amo\Base\Storage\Oauth\MongoDbStorage(['collection' => $collection])
);
```

#### Наследование хранилища

[](#наследование-хранилища)

Реализуется класс, наследующий \\Ufee\\Amo\\Base\\Storage\\Oauth\\AbstractStorage

```
class CustomOauthStorage extends \Ufee\Amo\Base\Storage\Oauth\AbstractStorage
{
	protected function initClient(Oauthapi $client) {
		parent::initClient($client);
		$key = $client->getAuth('domain').'_'.$client->getAuth('client_id');
		if ($data = getClientOauthData($key)) {
			static::$_oauth[$key] = $data;
		}
	}
	public function setOauthData(Oauthapi $client, array $oauth) {
		parent::setOauthData($client, $oauth);
		$key = $client->getAuth('domain').'_'.$client->getAuth('client_id');
		return setClientOauthData($key, $oauth);
	}
}
\Ufee\Amo\Oauthapi::setOauthStorage(
	new CustomOauthStorage()
);
```

#### Стороннее хранение

[](#стороннее-хранение)

Кеширование oauth данных библиотекой не производится

```
\Ufee\Amo\Oauthapi::setOauthStorage(
	new \Ufee\Amo\Base\Storage\Oauth\AbstractStorage()
);
$amo = \Ufee\Amo\Oauthapi::setInstance([...]);
$first_token = $amo->fetchAccessToken($code);
saveToCustomStorage($first_token);
$last_saved_token = getFromCustomStorage();
$amo->setOauth($last_saved_token);
$amo->onAccessTokenRefresh(function($oauth) {
	saveToCustomStorage($oauth);
});
```

#### Deprecated

[](#deprecated)

Задать свой путь для кеширования oauth данных (устаревший метод)

```
$amo->setOauthPath('path_to/oauth');
// equal to new method
\Ufee\Amo\Oauthapi::setOauthStorage(
    new \Ufee\Amo\Base\Storage\Oauth\FileStorage(['path' => 'path_to/oauth'])
);
```

#### Получение объекта для работы с конкретным аккаунтом

[](#получение-объекта-для-работы-с-конкретным-аккаунтом)

```
$amo = \Ufee\Amo\Oauthapi::setInstance([
    'domain' => 'testdomain',
    'client_id' => 'b6cf0658-b19...', // id приложения
    'client_secret' => 'D546t4yRlOprfZ...',
    'redirect_uri' => 'https://site.ru/amocrm/oauth/redirect',
    'zone' => 'ru', // or com
    'timezone' => 'Europe/Moscow',
    'lang' => 'ru', // or en
    'user_agent' => '' // ifempty = Amoapi v. ()
]);
$amo->setAuth('user_agent', 'MyCustomUserAgent');
```

Получение ранее инициализированного объекта по id приложения

```
$amo = \Ufee\Amo\Oauthapi::getInstance('b6cf0658-b19...');
```

Получение URL авторизации в приложении amoCRM
Необходимо для извлечения кода авторизации

```
$first_auth_url = $amo->getOauthUrl($arg = ['mode' => 'popup', 'state' => 'amoapi']);
```

Получение oauth данных - access\_token, refresh\_token производится единоразово, по коду авторизации
Полученные данные oauth кешируются в соответствии с выбранным хранилищем
Применяются при API запросах автоматически

```
$oauth = $amo->fetchAccessToken($code);
```

При необходимости можно задать oauth данные принудительно, вручную
Данные также будут кешированы автоматически в соответствии с выбранным хранилищем

```
$amo->setOauth([
	'token_type' => 'Bearer',
	'expires_in' => 86400,
	'access_token' => 'bKSuyc4u6oi...',
	'refresh_token' => 'a89iHvS9uR4...',
	'created_at' => 1597678161
]);
```

Токен доступа обновляется автоматически, если срок действия refresh\_token не истек
При необходимости можно обновить oauth данные по refresh\_token принудительно, вручную
Новые oauth данные также будут кешированы автоматически

```
$oauth = $amo->refreshAccessToken($refresh_token = null); // при передаче null используются кешированные oauth данные
```

Вызов callback функции при автоматическом обновлении токена доступа

```
$amo->onAccessTokenRefresh(function($oauth, $query, $response) {
	echo $query->startDate().' - ['.$query->method.'] '.$query->getUrl()."\n";
	print_r($query->post_data);
	echo $query->endDate().' - ['.$response->getCode().'] '. $response->getData(). "\n\n";
	echo "\nRefreshed oauth: \n";
	print_r($oauth);
});
$amo->onAccessTokenRefreshError(function($exc, $query, $response) {
	echo $query->startDate().' - ['.$query->method.'] '.$query->getUrl()."\n";
	print_r($query->post_data);
	echo $query->endDate().' - ['.$response->getCode().'] '. $response->getData(). "\n\n";
	exit('Error refresh token: '.$exc->getMessage().', code: '.$exc->getCode());
});
```

После первичного выполнения метода fetchAccessToken(), можно пользоваться клиентом в обычном режиме
Повторное выполнение метода fetchAccessToken() или setOauth() необходимо только в случаях, если:

1. Изменились ключи доступа в приложении
2. Изменился поддомен amoCRM аккаунта
3. Истек срок действия refresh\_token
4. Получена ошибка авторизации

Рекомендуется убедиться в отсутствии публичного доступа к папке с кешем - /vendor/ufee/amoapi/src/Cache/
(если используется директория по умолчанию)

Обмен API ключа на код авторизации oAuth

```
$resp_code = $amo->ajax()->exchangeApiKey(
	$crm_login,
	$api_hash,
	$client_id,
	$client_secret
);
if ($resp_code === 202) {
	// Запрос принят, код авторизации будет отправлен на redirect_uri
}
```

Инициализация клиента по API-hash
---------------------------------

[](#инициализация-клиента-по-api-hash)

Получение объекта для работы с конкретным аккаунтом

```
$amo = \Ufee\Amo\Amoapi::setInstance([
    'id' => 123,
    'domain' => 'testdomain',
    'login' => 'test@login',
    'hash' => 'testhash',
    'zone' => 'com', // default: ru
    'timezone' => 'Europe/London', // default: Europe/Moscow
    'lang' => 'en' // default: ru
]);
```

Включение/выключение автоматической авторизации при ошибке 401
Сессия (cookie) кешируется в файлах

```
$amo->autoAuth(true); // true/false, рекомендуется true
```

Работа с клиентом
-----------------

[](#работа-с-клиентом)

Включение логирования заросов (Logs/m-Y/domain.log)

```
$amo->queries->logs(true); // to default path
```

или

```
$amo->queries->logs('path_to_log/queries'); // to custom path
```

Не более 1 запроса за заданное время, в секундах

```
$amo->queries->setDelay(0.5); // default: 0.15 sec
```

Запрос /api/v2/account кешируется в файлах, время указывается в секундах

```
\Ufee\Amo\Services\Account::setCacheTime(1800); // default: 600 sec
```

Пользовательская отладка запросов (обновлено с вводом oAuth)

```
$amo->queries->onResponseCode(429, function(\Ufee\Amo\Base\Models\QueryModel $query) {
	echo 'Resp code 429, retry '.$query->retries."\n";
});
$amo->queries->listen(function(\Ufee\Amo\Base\Models\QueryModel $query) {
    $code = $query->response->getCode();
    echo $query->startDate().' - ['.$query->method.'] '.$query->getUrl()."\n";
    print_r($query->headers);
    if ($code === 0) {
        echo $query->response->getError()."\n\n";
    } else {
        print_r(count($query->json_data) ? $query->json_data : $query->post_data);
        echo $query->endDate().' - ['.$query->response->getCode().'] '.$query->response->getData()."\n\n";
    }
});
```

Кеширование запросов
--------------------

[](#кеширование-запросов)

Хранение кеша возможно в нескольких вариантах

#### Файловое хранилище

[](#файловое-хранилище-1)

Используется по умолчанию (/vendor/ufee/amoapi/src/Cache/), можно задать свой путь
Создаются кеш-файлы: {path}/{domain}\_{hash}.cache
Настоятельно рекомендуется использовать cвой путь для кеширования, в противном случае данные будут УДАЛЕНЫ composer'ом при обновлении на новую версию.

```
$apiClient->queries->setCacheStorage(
	new \Ufee\Amo\Base\Storage\Query\FileStorage($apiClient, ['path' => 'pull_path_to/cache'])
);
```

#### Redis

[](#redis-1)

Поддерживается библиотека [phpredis](https://github.com/phpredis/phpredis)
Формат ключа: {domain}-cache:{hash}

```
$redis = new \Redis();
$redis->connect('/var/run/redis/redis.sock');
$redis->setOption(\Redis::OPT_SERIALIZER, \Redis::SERIALIZER_PHP); // \Redis::SERIALIZER_IGBINARY recommended
$redis->select(5); // switch to specific db

$apiClient->queries->setCacheStorage(
	new \Ufee\Amo\Base\Storage\Query\RedisStorage($apiClient, ['connection' => $redis])
);
```

Поиск сущностей
---------------

[](#поиск-сущностей)

Поиск по дополнительному полю

```
$leads = $amo->leads()->searchByCustomField('Москва', 'Город', 300); // by CF name, max 300
$leads = $amo->leads()->searchByCustomField('Москва', 623425); // by CF id
$companies = $amo->companies()->searchByName('ООО Шарики за Ролики', 100); // by name, max 100
$contacts = $amo->contacts()->searchByEmail('Test@Mail.Ru', 0); // by email, no max limit
$contacts = $amo->contacts()->searchByPhone('89271002030');
```

Работа с дополнительными полями
-------------------------------

[](#работа-с-дополнительными-полями)

Убрать значение

```
$entity->cf('Имя поля')->reset();
$entity->cf('Организация')->removeBy('name', 'ИП Петров А.А.');
```

Получить значение

```
$entity->cf('Имя поля')->getValue();
$entity->cf('Имя поля')->getValues();
$entity->cf('Имя поля')->getEnums();
$entity->cf('Дата')->format('Y-m-d');
$entity->cf('Дата')->getTimestamp();
$entity->cf('Организация')->getValues();
```

Задать значение

```
$entity->cf('Имя поля')->setEnum($enum);
$entity->cf('Имя поля')->setEnums($enums);
$entity->cf('Число')->setValue(5);
$entity->cf('Текст')->setValue('Test');
$entity->cf('Мультисписок')->reset()->setValues(['Мужская одежда', 'Аксессуары']);
$entity->cf('День рождения')->setDate('Y-m-d');
$entity->cf('Дата')->setTimestamp(14867456357);
$entity->cf('Дата')->setDate('Y-m-d');
$entity->cf('Переключатель')->enable();
$entity->cf('Переключатель')->disable();
$entity->cf('Полный адрес')->setCountry('Россия');
$entity->cf('Полный адрес')->setRegion('Чувашская республика');
$entity->cf('Полный адрес')->setCity('Чебоксары');
$entity->cf('Полный адрес')->setIndex(428000);
$entity->cf('Телефон')->setValue('987654321', 'Home');
$entity->cf('Телефон')->setValue('123456789');
$entity->cf('Email')->setValue('best@list.ru');
$entity->cf('Мгн. сообщения')->setValue('bestJa', 'Jabber');
$entity->cf('Юр. лицо')->setName('Команда F5');
$entity->cf('Юр. лицо')->setAddress('РФ, ЧР, г.Чебоксары');
$entity->cf('Юр. лицо')->setType(1);
$entity->cf('Юр. лицо')->setInn(123);
$entity->cf('Юр. лицо')->setKpp(456);
$entity->cf('Организация')->addValue([
    'name' => 'ИП Петров А.А.',
    'city' => 'Москва',
    '...' => '...'
]);
```

Работа с коллекциями
--------------------

[](#работа-с-коллекциями)

Перебор, поиск и фильтрация

```
foreach ($amo->leads as $lead) { ... }
$amo->leads->each(function(&$lead) { ... });
$leadsByCf = $amo->leads->find('name', 'Трубы гофрированные');
$leadsBySale = $amo->leads->filter(function($lead) {
    return $lead->sale > 0;
});
$firstLead = $lead->first();
$lastLead = $lead->last();
```

Сортировка

```
$leads->sortBy('sale', 'DESC');
$leads->usort(function($a, $b) {});
$leads->uasort(function($a, $b) {});
```

Дополнительно

```
$has_contains =  $leads->contains('name', 'Test');
$sale_sum = $leads->sum('sale');
$leads = $leads->transform(function($lead) {
    return [
        'id' => $lead->id,
        'name' => $lead->name
    ];
});
$leads_array = $leads->toArray();
```

Работа со сделками
------------------

[](#работа-со-сделками)

Получение всех сделок

```
$leads = $amo->leads;
$leads = $amo->leads()->recursiveCall();
$leads = $amo->leads()->call(); // первые 500
```

Получение по дате последнего изменения

```
$leads = $amo->leads()
             ->modifiedFrom('Y-m-5 09:20:00') // по дате, с 5 числа текущего месяца, с 9:20 утра
             ->modifiedFrom(1528188143) // или по timestamp
             ->maxRows(1000)
             ->listing();
```

Получение по ID

```
$lead = $amo->leads()->find($id); // array|integer
```

Получение сделок с дополнительным условием

```
$lead = $amo->leads()->where('key', $val)->recursiveCall();
```

Связанные сущности по сделке

```
$contact = $lead->contact;
$contacts = $lead->contacts;
$company = $lead->company;
$tasks = $lead->tasks;
$notes = $lead->notes;
```

Создание сделок

```
$leads = [
    $amo->leads()->create(),
    $amo->leads()->create()
];
$leads[0]->name = 'Amoapi v7 - 1';
$leads[1]->name = 'Amoapi v7 - 2';
$amo->leads()->add($leads);

$lead = $amo->leads()->create();
$lead->name = 'Amoapi v7';
$lead->attachTag('Amoapi');
$lead->pipeline_id = $amo->account->pipelines->main();
$lead->status_id = $lead->pipeline->statuses->first();
$lead->responsible_user_id = $amo->account->currentUser->id;
$lead->sale = 100500;
$lead->cf('Число')->setValue(5);
$lead->cf('Текст')->setValue('Test');
$lead->cf('Мультисписок')->reset()->setValues(['Мужская одежда', 'Аксессуары']);
$lead->cf('Дата')->setValue(date('Y-m-d'));
$lead->cf('Переключатель')->disable();
$lead->save();
```

Создание сделки из контакта

```
$lead = $contact->createLead();
$lead->name = 'Amoapi v7';
$lead->save();
```

Копирование сделки

```
$copy = clone $lead;
$copy->name = 'New lead';
$copy->save();
```

Работа с контактами
-------------------

[](#работа-с-контактами)

Получение всех контактов

```
$contacts = $amo->contacts;
$contacts = $amo->contacts()->recursiveCall();
$contacts = $amo->contacts()->call(); // первые 500
```

Получение по ID

```
$contact = $amo->contacts()->find($id); // array|integer
```

Получение контактов с дополнительным условием

```
$contacts = $amo->contacts()->where('key', $val)->recursiveCall();
```

Связанные сущности по контакту

```
$leads = $contact->leads;
$company = $contact->company;
$tasks = $lead->tasks;
$notes = $lead->notes;
```

Создание контактов

```
$contacts = [
    $amo->contacts()->create(),
    $amo->contacts()->create()
];
$contacts[0]->name = 'Amoapi v7 - 1';
$contacts[1]->name = 'Amoapi v7 - 2';
$amo->contacts()->add($contacts);

$contact = $amo->contacts()->create();
$contact->name = 'Amoapi v7';
$contact->attachTags(['Amoapi', 'Test']);
$contact->cf('Телефон')->setValue('987654321', 'Home');
$contact->cf('Телефон')->setValue('123456789');
$contact->cf('Email')->setValue('best@list.ru');
$contact->save();
```

Создание контакта из сделки

```
$contact = $lead->createContact();
$contact->name = 'Amoapi v7';
$contact->save();
```

Копирование контакта

```
$copy = clone $contact;
$copy->name = 'New contact';
$copy->save();
```

Работа с компаниями
-------------------

[](#работа-с-компаниями)

Получение всех компаний

```
$companies = $amo->companies;
$companies = $amo->companies()->recursiveCall();
$companies = $amo->companies()->call(); // первые 500
```

Получение по ID

```
$company = $amo->companies()->find($id); // array|integer
```

Получение компаний с дополнительным условием

```
$companies = $amo->companies()->where('key', $val)->recursiveCall();
```

Связанные сущности по компании

```
$leads = $company->leads;
$contacts = $company->contacts;
$tasks = $lead->tasks;
$notes = $lead->notes;
```

Создание компаний

```
$companys = [
    $amo->companies()->create(),
    $amo->companies()->create()
];
$companys[0]->name = 'Amoapi v7 - 1';
$companys[1]->name = 'Amoapi v7 - 2';
$amo->companies()->add($companys);

$company = $amo->companies()->create();
$company->name = 'Amoapi v7';
$company->save();
```

Создание компании из контакта или сделки

```
$company = $contact->createCompany();
$company = $lead->createCompany();
$company->name = 'Amoapi v7';
$company->save();
```

Копирование компании

```
$copy = clone $company;
$copy->name = 'New company';
$copy->save();
```

Работа с задачами
-----------------

[](#работа-с-задачами)

Получение всех задач

```
$tasks = $amo->tasks;
$tasks = $amo->tasks()->recursiveCall();
$tasks = $amo->tasks()->call(); // первые 500
```

Получение по ID

```
$task = $amo->tasks()->find($id); // array|integer
```

Получение задач с дополнительным условием

```
$tasks = $amo->tasks()->where('key', $val)->recursiveCall();
```

Создание задач

```
$tasks = [
    $amo->tasks()->create(),
    $amo->tasks()->create()
];
$tasks[0]->text = 'Amoapi v7 - 1';
$tasks[0]->element_type = 3;
$tasks[0]->element_id = 34762721;
$tasks[1]->text = 'Amoapi v7 - 2';
$tasks[1]->element_type = 2;
$tasks[1]->element_id = 34762720;
$amo->tasks()->add($tasks);

$task = $amo->tasks()->create();
$task->text = 'Amoapi v7';
$task->element_type = 1;
$task->element_id = 34762725;
$task->save();
```

Создание задачи из контакта, сделки или компании

```
$task = $contact->createTask($type = 1);
$task = $lead->createTask($type = 1);
$task = $company->createTask($type = 1);
$task->text = 'Amoapi v7';
$task->element_type = 1;
$task->element_id = 34762725;
$task->save();
```

Получение родительского контакта, сделки или компании

```
$contact = $task->linkedContact;
$lead = $task->linkedLead;
$comapny = $task->linkedCompany;
```

Работа с примечаниями
---------------------

[](#работа-с-примечаниями)

Получение всех примечаний

```
$notes = $amo->notes;
$notes = $amo->notes()->where('type', 'contact')->recursiveCall();
$notes = $amo->notes()->where('type', 'lead')->call(); // первые 500
```

Получение примечаний по ID и типу сущности

```
$note = $amo->notes()->find($id, 'lead');
```

Получение примечаний с дополнительным условием

```
$notes = $amo->notes()->where('key', $val)->recursiveCall();
```

Создание примечаний

```
$notes = [
    $amo->notes()->create(),
    $amo->notes()->create()
];
$notes[0]->note_type = 4;
$notes[0]->text = 'Amoapi v7 - 1';
$notes[0]->element_type = 3;
$notes[0]->element_id = 34762721;
$notes[1]->note_type = 4;
$notes[1]->text = 'Amoapi v7 - 2';
$notes[1]->element_type = 2;
$notes[1]->element_id = 34762720;
$amo->notes()->add($notes);

$note = $amo->notes()->create();
$note->note_type = 4;
$note->text = 'Amoapi v7';
$note->element_type = 1;
$note->element_id = 34762725;
$note->save();
```

Создание примечания из контакта, сделки или компании

```
$note = $contact->createNote($type = 4);
$note = $lead->createNote($type = 4);
$note = $company->createNote($type = 4);
$note->text = 'Amoapi v7';
$note->element_type = 2;
$note->element_id = 34762728;
$note->save();
```

Закрепление/открепление примечаний (note type 4)

```
$note->setPinned(true); // true/false
```

Получение содержимого файла (note type 5)

```
$contents = $note->getAttachment();
```

Получение родительского контакта, сделки или компании

```
$contact = $note->linkedContact;
$lead = $note->linkedLead;
$comapny = $note->linkedCompany;
```

Работа со списками
------------------

[](#работа-со-списками)

Получение всех списков (каталогов)

```
$catalogs = $amo->catalogs;
```

Получение по ID

```
$catalog = $amo->catalogs()->find($id); // array|integer
```

Получение списков с дополнительным условием

```
$catalogs = $amo->catalogs()->where('key', $val)->call();
```

Связанные сущности по списку

```
$elements = $catalog->elements;
```

Создание списков

```
$catalogs = [
    $amo->catalogs()->create(),
    $amo->catalogs()->create()
];
$catalogs[0]->name = 'Amoapi v7 - 1';
$catalogs[1]->name = 'Amoapi v7 - 2';
$amo->catalogs()->add($catalogs);

$catalog = $amo->catalogs()->create();
$catalog->name = 'Amoapi v7';
$catalog->save();
```

Удаление списков

```
$amo->catalogs()->delete($catalogs); // array|integer
$catalog->delete();
```

Работа с элементами каталога (товарами)
---------------------------------------

[](#работа-с-элементами-каталога-товарами)

Получение товаров

```
$element = $amo->catalogElements()->find($id);
$elements = $amo->catalogElements()->where('catalog_id', 1234)->call();
$elements = $catalog->elements;
```

Добавление товаров

```
$element = $amo->catalogElements()->create();
$element->catalog_id = 1234;
```

или

```
$element = $catalog->createElement();
$element->name = 'Холодильник LG';
$element->cf('Артикул')->setValue('ML-4675');
$element->cf('Количество')->setValue(100);
$element->cf('Цена')->setValue(38500);
$element->save();
```

Обновление товаров

```
$element->cf('Скидка')->setValue(5);
$element->save();
```

Связанные сущности по товару

```
$catalog = $element->catalog;
$leads = $element->leads;
```

Удаление товаров

```
$amo->elements()->delete($elements); // array|integer
$catalog->elements->delete(); // удаление всех товаров каталога
$element->delete();
```

Прикрепление товаров к сделке

```
$lead->attachElement($catalog->id, $element->id, $count = 1);
```

Работа с покупателями
---------------------

[](#работа-с-покупателями)

Получение всех покупателей

```
$customers = $amo->customers;
$customers = $amo->customers()->recursiveCall();
$customers = $amo->customers()->call(); // первые 500
```

Получение по ID

```
$customer = $amo->customers()->find($id); // array|integer
```

Получение покупателей с дополнительным условием

```
$customer = $amo->customers()->where('key', $val)->recursiveCall();
```

Связанные сущности покупателя

```
$contact = $customer->contact;
$contacts = $customer->contacts;
$company = $customer->company;
$tasks = $customer->tasks;
$notes = $customer->notes;
$transactions = $customer->transactions;
```

Создание покупателей

```
$customer = $amo->customers()->create();
$customer->name = 'Amoapi v7';
$customer->next_date = time();
$customer->next_price = 100;
$customer->responsible_user_id = $amo->account->currentUser->id;
$customer->cf('Число')->setValue(5);
$customer->cf('Текст')->setValue('Test');
$customer->cf('Мультисписок')->reset()->setValues(['Мужская одежда', 'Аксессуары']);
$customer->cf('Дата')->setValue(date('Y-m-d'));
$customer->cf('Переключатель')->disable();
$customer->save();
```

Создание покупателя из контакта

```
$customer = $contact->createCustomer();
$customer->name = 'Amoapi v7';
$customer->next_date = time();
$customer->save();
```

Удаление покупателей

```
$amo->customers()->delete($customers); // array|integer
$customer->delete();
```

Работа с покупками
------------------

[](#работа-с-покупками)

Получение транзакций (покупок)

```
$transactions = $amo->transactions;
$transactions = $customer->transactions;
```

Добавление транзакций

```
$transaction = $amo->transactions()->create();
$transaction->customer_id = 1234;
```

или

```
$transaction = $customer->createTransaction();
$transaction->price = 1500;
$transaction->save();
```

Обновление комментариев транзакций покупателя

```
$transaction->comment = 'Тест';
$transaction->save();
```

Удаление транзакций покупателей

```
$amo->transactions()->delete($transactions); // array|integer
$customer->transactions->delete(); // удаление всех покупок покупателя
$transaction->delete(); // удаление покупки
```

Работа с веб-хуками
-------------------

[](#работа-с-веб-хуками)

Получение вебхуков (webhooks)

```
$webhooks = $amo->webhooks;
```

Добавление вебхуков

```
$result = $amo->webhooks()->subscribe('http://site.ru/handler/', ['add_lead', 'update_contact', 'responsible_lead']);
```

Удаление вебхуков

```
$result = $amo->webhooks()->unsubscribe('http://site.ru/handler/', ['update_contact', 'responsible_lead']);
```

Работа с frontend методами
--------------------------

[](#работа-с-frontend-методами)

Скачивание файла из примечания

```
$contents = $amo->ajax()->getAttachment('AbCd_attach_name.zip');
```

Выполнение произвольных запросов

```
$amo->ajax()->get($url = '/ajax/example', $args = []);
$amo->ajax()->post($url = '/ajax/example', $data = [], $args = [], $post_type = 'raw OR json');
$amo->ajax()->postJson($url = '/ajax/example', $data = [], $args = []);
$amo->ajax()->patch($url = '/ajax/example', $data = [], $args = []);
```

Работа с Salesbot
-----------------

[](#работа-с-salesbot)

```
$bots = $amo->salesbots()->get($page = 1, $limit = 250);
$bots = $amo->salesbots;

$start = $amo->salesbots()->start($bot_id, $entity_id, $entity_type = 2);
$stop = $amo->salesbots()->stop($bot_id, $entity_id, $entity_type = 2);
```

###  Health Score

48

—

FairBetter than 95% of packages

Maintenance59

Moderate activity, may be stable

Popularity40

Moderate usage in the ecosystem

Community23

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 75.7% of commits — single point of failure

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 ~35 days

Recently: every ~51 days

Total

68

Last Release

245d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/a96bd0bd19d47662e57148eb7b87decef1618b4dd1e9f9d75e42346c4c322843?d=identicon)[Ufee](/maintainers/Ufee)

---

Top Contributors

[![ufee](https://avatars.githubusercontent.com/u/28390028?v=4)](https://github.com/ufee "ufee (53 commits)")[![vladimir-proger](https://avatars.githubusercontent.com/u/13275464?v=4)](https://github.com/vladimir-proger "vladimir-proger (5 commits)")[![Denkong](https://avatars.githubusercontent.com/u/34238037?v=4)](https://github.com/Denkong "Denkong (4 commits)")[![m4tlch](https://avatars.githubusercontent.com/u/3687188?v=4)](https://github.com/m4tlch "m4tlch (3 commits)")[![bigperson](https://avatars.githubusercontent.com/u/4757391?v=4)](https://github.com/bigperson "bigperson (3 commits)")[![MaestroDDoS](https://avatars.githubusercontent.com/u/32622425?v=4)](https://github.com/MaestroDDoS "MaestroDDoS (1 commits)")[![MkhK6](https://avatars.githubusercontent.com/u/90448973?v=4)](https://github.com/MkhK6 "MkhK6 (1 commits)")

---

Tags

amocrmapicrmoauthphp

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/ufee-amoapi/health.svg)

```
[![Health](https://phpackages.com/badges/ufee-amoapi/health.svg)](https://phpackages.com/packages/ufee-amoapi)
```

###  Alternatives

[bezhansalleh/filament-shield

Filament support for `spatie/laravel-permission`.

2.8k2.9M88](/packages/bezhansalleh-filament-shield)[gesdinet/jwt-refresh-token-bundle

Implements a refresh token system over Json Web Tokens in Symfony

70516.4M35](/packages/gesdinet-jwt-refresh-token-bundle)[illuminate/auth

The Illuminate Auth package.

9327.3M1.0k](/packages/illuminate-auth)[beatswitch/lock

A flexible, driver based Acl package for PHP 5.4+

870304.7k2](/packages/beatswitch-lock)[amocrm/amocrm-api-library

amoCRM API Client

182728.5k6](/packages/amocrm-amocrm-api-library)[vonage/jwt

A standalone package for creating JWTs for Vonage APIs

424.1M4](/packages/vonage-jwt)

PHPackages © 2026

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