yurcrm/yurcrm-client

yurcrm.ru 服务 API 客户端

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

This package is auto-updated.

Last update: 2024-09-19 14:10:37 UTC


README

该客户端确保与律师事务所 CRM API 的工作

要求

  • 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 - 电子邮件(可选)
  • townId - 城市ID(可选)
  • externalId - 您系统中的联系人 ID(可选)

您可以在存储库中的 towns.csv 文件中找到城市 ID

响应格式为 JSON 的示例

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

状态 200 表示成功发送联系人,其他状态表示错误。错误将描述在 data 字段中。

YurcrmClient::send 方法执行的结果 - YurcrmResponse 类对象