## 座席签入
>[info]**功能说明:**
> 实现分机、工号、队列的关系绑定。
> 座席签入后,队列的电话会分配给空闲座席
>
* **请求地址**
```
{base_url}/{api_version}/login
```
* **请求参数**
| 参数 | 是否必选 | 类型 | 描述 |
| --- | --- | --- | --- |
| agentNum | 是 | string | 座席工号 |
| agentName | 是 | string | 座席姓名 |
| agentId | 否 | string | 座席在数据库中的自增id或其他标识 |
| playNum | 否 | string | 座席接听电话后系统自动报工号的数字,如果1001号客服代表为您服务,如果没有该参数,则报agentNum |
| groupNum | 是 | string | 座席队列编号,该队列编号必须在呼叫中心系统存在,如果需要同时签入多个队列,以半角逗号分隔 |
| ext | 是 | string | 座席的分机号码 |
* **响应参数**
| 参数 | 类型 | 描述 |
| --- | --- | --- |
| status | string | 请求结果:success:成功。failed:失败。|
| msg | string | 如果返回failed,对失败原因的描述。|
* **响应示例**
```
{
"status": "success",
"msg": ""
}
```
*****
> **提示:**
> 座席签入后系统并不会给座席分配电话,还需要执行“置闲”接口,系统才会给座席分配电话。