调用流程 - 网易七鱼 API

下面是一次完整的访客咨询客服的调用时序图：

正常流程说明：

发送消息：用户发送消息给应用服务器，触发请求分配客服的动作。除了发送消息触发外，应用服务器也可以使用指定命令来触发分配。例如在微信公众号中，添加一个单独的客服菜单，用户点击后触发分配客服，只有点击过这个菜单后，用户消息才转到七鱼客服。

应用服务器向七鱼服务器请求分配客服。请求中必须带上用户的ID，以标致来自于哪个用户。除此之外，还可以带上指定的客服分组ID，客服ID等参数。

七鱼服务器根据请求参数分配空闲的客服。分配成功后，服务器会生成一个新会话，然后通知客服有访客进入。

七鱼服务器将分配结果返回给应用服务器。建议应用服务器将会话状态缓存下来，当用户在继续说话时，应用服务器查询到用户已经在会话中了，只需要将消息转给七鱼服务器即可，无需再次请求分配客服。

更新用户的最新资料，可以包括用户的昵称，电话，邮件等基础信息，还可以包含用户的最近订单，最新状态等扩展信息。更新用户资料接口可以随时调用，调用后立即生效，客服可以马上看到。

将新的用户资料通知给客服，显示在会话窗口的右上角。

应用服务器将用户消息传到七鱼服务器。

用户消息传递给客服。

客服回复消息。

10.

七鱼服务器将客服消息传到应用服务器。

11.

应用服务器将消息回复给用户。

12.

用户咨询完毕，客服主动关闭会话，或者用户长时间没有回答，系统判断超时自动关闭后，会话结束。

13.

七鱼服务器通知应用服务器会话结束。如果应用服务器缓存了会话信息，可在此时移除相关缓存。

14.

如果需要告知用户会话已经结束，或者需要邀请用户对客服服务进行评价，可进行此步骤。

15.

用户对服务进行评价。除了会话结束时，在会话过程中任意时候，用户其实都可以进行评价。

16.

应用服务器将用户评价结果告诉七鱼服务器。

异常流程说明：

用户发送消息后，如果应用服务器不经过请求分配客服，就直接将消息转到七鱼服务器，七鱼服务器将自动触发客服分配流程。如果企业开通了机器人服务，且用户为第一次访问，则将自动分配给机器人，由机器人自动回复；若用户之前已经有人工接待过，则将继续分配给之前的客服。

请求分配的客服不在线时，将返回14005，并附上在后台设置客服不在线提示文案。此时消息仍然可以继续转发到七鱼服务器，这些消息将进入留言列表，等客服上线后，可以从留言列表中重新发起会话，进行回复。进入留言后，如果超过5分钟用户都没有再发送消息，这条留言就会关闭，这时客服才能在留言列表中看到。当用户再次发消息时，将重新触发客服分配的流程。

如果请求分配的客服接待的访客已经达到上限，将返回14006，表示访客需要排队。应用服务器可以通过查询排队状态的接口查看当前队列中有多少人，并反馈给用户。