# 预测式外呼 - 获取agent转接情况

#### 接口说明

**获取坐席转接情况**

#### 请求参数

| 参数名 | 类型 | 是否必须 | 说明 |
| --- | --- | --- | --- |
| service | string | 是 | App.Sip_Yccall.TaskAgentTta |
| token | string | 是 | 通过授权接口获取的token |
| createtime |string| 是 | 任务创建开始时间, 格式 2025-09-01 00:00:00
| endtime |string| 是 | 任务创建结束时间，格式 2025-09-05 00:00:00
| taskid | string | 否 | 任务ID 多个任务id用,分隔
| agent |string| 否 | agent 名称
| customtaskid| string | 否 | 自定义任务id
| currentpage | int | 否 | 当前页 |
| itemsperpage | int | 否 | 每页显示 |
#### 接口请求示例（PHP）

    <?php
        $apiUrl = 'http://127.0.0.1:8080';
        $postFields = [
            'service'   => 'App.Sip_Yccall.TaskAgentTta',
            'token'     => 'ABCDEFG',
            'taskid'     => 'taskid'
        ];
        $curl = curl_init();
        curl_setopt($curl, CURLOPT_URL, $apiUrl);
        curl_setopt($curl, CURLOPT_POST, 1);
        curl_setopt($curl, CURLOPT_POSTFIELDS, $postFields);
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
        $response = curl_exec($curl);
        $curlError = curl_error($curl);
        curl_close($curl);
        var_dump($response);
    ?>
    

#### 返回数据结构示例

    {
    "ret": 200,
    "data": {
        "status": 0,
        "desc": "获取成功",
        "result": {
            "totalitems": 3,
            "currentpage": 1,
            "itemsperpage": 10,
            "task": [
                {
                    "agent": "测试1",  #agent名称
                    "total_tta": 168,   #转接到坐席数
                    "success_tta": 0,  #转接到坐席接通
                    "fail_tta": 168,    #转接坐席未接
                    "tta_rate_percent": "0.00"  #成功转接率
                }
            ]
        },
        "reqtime": 1756961582,
        "rsptime": 1756961582
    },
    "msg": ""
}
    

#### 返回参数说明

| 参数名 | 类型 | 说明 |
| --- | --- | --- |
| result | object | 返回结果 |