README

EAmoCRM 是一个针对 Yii PHP 框架 的扩展，它通过使用 amocrm-php 库来实现与 amoCRM API 的交互。

要求

• Yii Framework 1.1.14 或更高版本
• Composer

安装

通过 composer

$ composer require dotzero/yii-amocrm

• 在配置文件的 components 部分添加 amocrm

'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 许可证下提供： https://open-source.org.cn/licenses/mit-license.php