README

为 Yii Framework 2 实现的与 amoCRM API 交互的客户端扩展，使用 amocrm-php 库。

要求

• Yii Framework 2
• Composer

安装

通过 Composer

$ composer require dotzero/yii2-amocrm

• 将 amocrm 添加到配置文件的 components 部分中

'components' => [
    ...
    'amocrm' => [
        'class' => 'yii\amocrm\Client',
        '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;

    // или прямо
    $account = Yii::$app->amocrm->account;

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

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

    // Заполнение полей модели
    $contact['name'] = 'ФИО';
    $contact['request_id'] = '123456789';
    $contact['date_create'] = '-2 DAYS';
    $contact['responsible_user_id'] = $amo->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