yurcrm/yurcrm-client

API client for yurcrm.ru service

v2.1.0 2022-03-19 07:57 UTC

This package is auto-updated.

Last update: 2024-04-19 13:07:56 UTC


README

Клиент обеспечивает работу с API CRM для юридических компаний

Требования

  • PHP 5.4+ с модулем curl

Установка

Подключите в composer зависимость yurcrm/yurcrm-client Обязательно укажите номер версии.

Быстрый старт

Для работы с API вам понадобится токен. Получить его можно зарегистрировавшись на yurcrm.ru и залогинившись под пользователем с ролью Директор. Перейдите в раздел Моя компания / API. Также понадобится ID источника контактов. Его вы найдете на странице Моя компания / Источники контактов

Пример добавления контакта в компанию

$yurcrmClient = new YurcrmClient('contact/create', 'POST', 'ваш токен');
$yurcrmClient->setData([
    'contact[name]' => "Александр Пушкин",
    'contact[sourceId]' => ID_источника,
    'contact[phone]' => '79031112233',
    'contact[question]' => "Суд с Дантесом",
    'contact[email]' => "alex@pushkin.ru",
    'contact[townId]' => 598,
    'contact[externalId]' => 781827,
]);

$createLeadResult = $yurcrmClient->send();

Параметры контакта:

  • name - Имя (обязательно)
  • sourceId - ID источника контактов (обязательно)
  • phone - Телефон (обязательно)
  • question - Вопрос клиента (обязательно)
  • email - Email (необязательно)
  • townId - ID города (необязательно)
  • externalId - ID контакта в вашей системе (необязательно)

ID городов вы можете найти в файле towns.csv в репозитории

Ответ вы получите в формате JSON Пример ответа

{
    "status": 200,
    "data": {
        "name": "Александр Пушкин",
        "sourceId": "173",
        "phone": "79031112233",
        "question": "Суд с Дантесом",
        "companyId": ID вашей компании,
        "phone2": "",
        "id": ID контакта в YurCRM
    }
}

Статус 200 говорит об успешной отправке контакта, другие статусы - об ошибке. При возникновении ошибки в поле data будет описание ошибки.

Результат выполнения метода YurcrmClient::send - объект класса YurcrmResponse