更新时间:2023-09-27 GMT+08:00

概述

智能助手平台(OIAP)提供接口给包括IVR,聊天APP,CSP或客服云系统等调用,满足智能化交互场景的操作。

所有URL中的IP:PORT均为OIAP在NSLB上对应的IP和PORT。

典型交互序列

  • 第一步 获取token

    首先确认是系统粒度(内部系统如客服云或CSP)对接还是租户粒度(第三方系统)对接。

    第三方系统在与智能助手平台系统对接,需要使用租户id来获取token(C3 智能助手平台接口鉴权方式),在token有效期内完成调用操作,而且后续每一次接口调用都需要传入获取的token。

    内部系统(客服云或CSP)与OIAP对接,需要使用默认系统对接约定的默认用户来获取token(C3 智能助手平台接口鉴权方式),在token有效期内完成调用操作,而且后续每一次接口调用都需要传入获取的token。

  • 第二步 建立与智能助手平台系统的绑定关系
  • 在获取token后,第三方需通过传入特定租户和语言信息查询号航系统对应已激活的领域(领域查询接口),并绑定第三方的接入标识与领域的绑定(对话标识绑定查询接口)。
  • 第三步 完成对话交互

    在将接入标识与智能助手平台系统的领域完成绑定后,就可以通过调用智能助手平台的各种对话接口来实现对话交互了(对话接口),比如初始化,放音,转接,挂机等。

常用错误码

表1 常用错误码参考表

错误码

描述

900001

无Token信息,或Token已过期。

900002

检查Token信息失败。

10000001

内部错误,通常因为应用系统故障引起。

10000002

参数错误。通常由于请求中未提供全部必填字段的值。

10000006

接口入参重复

10000007

接口出参重复

10000008

接口头参数重复

10000003

参数不存在,必须输入该参数

10000004

参数已经在系统中存在,不能重复使用

20000001

处于发布状态不能修改

20000002

流程名已经存在

20000003

删除节点错误,节点被别的流程引用

20000004

删除变量错误,变量被流程或者模板引用

20000005

修改变量错误,原变量被流程或者模板引用

20000006

文件路径不存在

20000007

IOException 读取文件流错误

20000008

更新数据错误

200900002

内部错误,通常因为应用系统故障引起

200900003

参数错误。通常由于请求中未提供全部必填字段的值

200800001

密钥不存在

200800002

密钥错误

200800003

锁账号