xjtdy888 / workec

EC开放平台API

EC开放平台

使用API，您可将EC与第三方系统进行数据级别的集成

环境需求

• PHP >= 5.6

安装

$ composer require "oiuv/workec"

使用

use Oiuv\WorkEc\EC;

$ec = new EC('corpId', 'appId', 'appSecret');

获取部门和员工信息

echo $ec->structure();

查询客户

//通过手机号查询单个客户
$mobile = '13800138000';
echo $ec->queryCustomer($mobile);

//通过crmId批量查询客户
$crmIds = '12345,14336,13093';
echo $ec->preciseQueryCustomer($crmIds);

创建客户

// 单个创建；参数：$optUserId, $name, $mobile, $followUserId
echo $ec->addCustomer(12345, '测试API', '13800138000', 67890);
// 批量创建
$data = [
    'optUserId' => $optUserId,
    'list' => [
        [
            'name' => $name,
            'mobile' => $mobile,
            'followUserId' => $followUserId,
            'channelId' => $channelId,
            'memo' => $memo,
        ],
        [
            'name' => $name,
            'mobile' => $mobile,
            'followUserId' => $followUserId,
            'channelId' => $channelId,
            'memo' => $memo,
        ],
        [
            'name' => $name,
            'mobile' => $mobile,
            'followUserId' => $followUserId,
            'channelId' => $channelId,
            'memo' => $memo,
        ]
    ]
];
echo $ec->addCustomers($data);

修改客户资料

// 修改单个用户
$data = [
    'optUserId' => 123456,
    'crmId'     => 123456789,
    'name'    => '陈小萌',
    'mobile'    => '13800138000'
];
echo $ec->updateCustomer($data);
// 批量修改用户
$list =[
    [
        'optUserId' =>12345,
        'crmId'=>1234567,
        'name'=>'用户1'
    ],
    [
        'optUserId' =>12345,
        'crmId'=>1234568,
        'name'=>'用户2'
    ],
    [
        'optUserId' =>67890,
        'crmId'=>1234569,
        'name'=>'用户3'
    ]
];
echo $ec->batchUpdateCustomer($list);

方法列表

方法	说明
updateLabel	修改客户标签(支持批量)
queryLabel	查询客户标签(支持批量)
abandonCustomer	放弃客户(支持批量)
customerChangeUser	变更跟进人(支持批量)
getCustomerGroup	查询客户分组(请求协议错误！???)
getTrajectory	查询客户轨迹
queryCustomer	分页查询客户信息
getCustomer	自定义分页查询客户信息
preciseQueryCustomer	批量查询客户信息
addCustomer	创建客户
addCustomers	批量创建客户
combineCustomer	合并客户
updateCustomer	修改客户信息
batchUpdateCustomer	批量修改客户信息
updateStep	修改客户阶段(支持批量)
createDept	创建部门
editDept	编辑部门
structure	获取架构信息
createUser	创建员工
User	启用/禁用员工
call	电话外呼
smsRecord	短信记录
telRecord	电话记录
getLabelInfo	获取标签信息

更多方法看源码并参考EC开放平台技术文档

• EC开放平台技术文档

License

MIT