'/**
 * 沃创云
 * Class ApiRongYing
 * @package frontend\\controllers
 */'

---

1.call 拨打电话
( token , callee_number , customer_id=0 )

'/**
     * 拨打电话
     * @param string $token token
     * @param int $customer_id 客户ID (OA工单没有客户ID时可以不传)
     * @param string $callee_number 被叫电话
     * @return array|string
     * @throws \\Exception
     */'

2.set-seats 通过登录号新增或更新坐席
( password , login_name , seats_phone , api_id='' )

'/**
     * 通过登录号新增或更新坐席
     * @param string $password 密码
     * @param string $login_name 登录账号
     * @param string $seats_phone 坐席号码
     * @param string $api_id 第三方提供的key,为空则使用默认的主体
     * @return mixed
     */'

3.save-seats 新增或更新坐席号码
( token , seats_phone )

'/**
     * 新增或更新坐席号码
     * @param string $token
     * @param string $seats_phone
     * @throws \\Exception
     * @return mixed
     */'

4.log 获取拨打记录
( token , callee_number=NULL , caller_number=NULL , begin_date=NULL , end_date=NULL , company_name=NULL , city_id=NULL , county_id=NULL , status=0 , sec_range=NULL , caller_user_id=NULL , page=1 , page_size=20 )

'/**
     * 获取拨打记录
     * @param $token
     * @param null $callee_number 被叫号码
     * @param null $caller_number 主叫(坐席)号码
     * @param null $begin_date 通话时间范围
     * @param null $end_date 通话时间范围
     * @param null $company_name 公司名称
     * @param null $city_id 城市ID
     * @param null $county_id  地区ID
     * @param int $status 状态 0-不限 1-正常 2-未接通
     * @param string $sec_range 通话时长范围 例如: 0,60表示1分钟以内
     * @param string $caller_user_id 主叫员工ID
     * @param int $page
     * @param int $page_size
     * @return array|string
     * @throws \\Exception
     */'

5.output 导出
( token , callee_number=NULL , caller_number=NULL , begin_date=NULL , end_date=NULL , company_name=NULL , city_id=NULL , county_id=NULL , status=0 , sec_range=NULL , caller_user_id=NULL )

'/**
     * 导出
     * @param string $token
     * @param $
     * @param null $callee_number
     * @param null $caller_number
     * @param null $begin_date 起始时间 默认:本月第一天
     * @param null $end_date 结束时间 默认:本月最后一天
     * @param null $company_name
     * @param null $city_id
     * @param null $county_id
     * @param int $status
     * @param null $sec_range
     * @param null $caller_user_id
     * @return array|string
     */'

6.add-task 添加待联系客户到任务队列
( token , customer_ids )

'/**
     * 添加待联系客户到任务队列
     * @param string $token token
     * @param string $customer_ids 英文逗号\",\"分隔的客户id
     * @return array|string
     * @throws Exception
     */'

7.get-task 获取需要拨打电话的任务
( token , limit=1 )

'/**
     * 获取需要拨打电话的任务
     * @param string $token token
     * @param int $limit 获取本组电话任务
     */'

8.set-task-called 更新呼叫状态
( token , task_id )

'/**
     * 更新呼叫状态
     * @param string $token
     * @param int $task_id
     * @return array|string
     */'