dotzero/yii-amocrm

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

v1.1.0 2016-05-11 14:00 UTC

This package is auto-updated.

Last update: 2024-11-27 20:14:28 UTC


README

Latest Stable Version License

EAmoCRM это расширение для Yii PHP framework реализующее клиент для работы с API amoCRM используя библиотеку amocrm-php.

Требования:

Установка

Через composer:

$ composer require dotzero/yii-amocrm
  • Добавить amocrm в секцию components конфигурационного файла:
'aliases' => array(
    ...
    'vendor' => realpath(__DIR__ . '/../../vendor'),
),
'components' => array(
    ...
    'amocrm' => array(
        'class' => 'vendor.dotzero.yii-amocrm.EAmoCRM',
        'subdomain' => 'example', // Персональный поддомен на сайте amoCRM
        'login' => 'login@mail.com', // Логин на сайте amoCRM
        'hash' => '00000000000000000000000000000000', // Хеш на сайте amoCRM

        // Для хранения ID полей можно воспользоваться хелпером
        'fields' => [
            'StatusId' => 10525225,
            'ResponsibleUserId' => 697344,
        ],
    ),
),

Пример использования:

try {
    $amo = Yii::app()->amocrm->getClient();

    // Получение экземпляра модели для работы с аккаунтом
    $account = $amo->account;

    // Вывод информации об аккаунте
    print_r($account->apiCurrent());

    // Получение экземпляра модели для работы с контактами
    $contact = $amo->contact;

    // Заполнение полей модели
    $contact['name'] = 'ФИО';
    $contact['request_id'] = '123456789';
    $contact['date_create'] = '-2 DAYS';
    $contact['responsible_user_id'] = Yii::app()->amocrm->fields['ResponsibleUserId'];
    $contact['company_name'] = 'ООО Тестовая компания';
    $contact['tags'] = ['тест1', 'тест2'];
    $contact->addCustomField(448, [
        ['+79261112233', 'WORK'],
    ]);

    // Добавление нового контакта и получение его ID
    print_r($contact->apiAdd());

} catch (\AmoCRM\Exception $e) {
    printf('Error (%d): %s' . PHP_EOL, $e->getCode(), $e->getMessage());
}

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

Смотреть документацию к библиотеке amocrm-php.

Лицензия

Библиотека доступна на условиях лицензии MIT: http://www.opensource.org/licenses/mit-license.php