更新时间:2023-10-11 GMT+08:00
实例简介
当前实例只涉及座席的登录、强制登录、设置技能队里、获取事件四个接口。
业务逻辑如下:
图1 座席事件轮询方式
图2 座席事件推送方式
- 调用座席登录接口(login)进行登录,如果返回结果中retcode为0,则表示登录成功;如果返回结果中retcode为100-002,则表示当前座席已经登录,可以调用强制登录接口进行登录(forceLogin),同样当返回结果中retcode为0,表示登录成功。
- 在调用登录或强制登录接口登录成功时,CC-Gateway会在HTTP请求的响应response中的headers中新增返回一个Set-GUID的header,值例如为“JSESSIONID=279fe21d-2caa-4437-84c3-ab9e9dae20f5.AgentGateway0”,其中279fe21d-2caa-4437-84c3-ab9e9dae20f5.AgentGateway0为guid,是CC-Gateway对座席调用接口的鉴权信息。
- 获取guid之后,可以通过调用重置技能队列(resetSkill)接口,签入指定的技能队列。
- 如图一所示,采用座席事件轮询方式,完成签入技能后,调用获取座席事件(getAgentEvent)接口定时轮询获取座席事件,该接口不仅用于获取座席的事件,同时也是座席与CC-Gateway之间的心跳线;
如图二所示,采用座席事件推送方式,签入成功和完成签入技能后,事件会直接推送到签入时传入的回调地址,只需调用座席心跳接口保持CC-Gateway与三方回调地址心跳。
当CC-Gateway采用动态鉴权时,guid会动态更新,并且当guid更新后,都会在轮询获取事件接口和座席心跳接口的HTTP请求的响应response中的headers中新增返回一个Set-GUID的header,同样需要获取并更新guid,并且在其他接口调用中用新获取的guid进行设置。
父主题: 第一次应用开发