通话记录操作事件 - 尘锋SCRM开放平台

当系统产生通话记录数据、通话录音转文字完成时，将推送本文档里对应的事件内容。

HTTP - Body 格式说明

字段名称	类型	说明
`event`	`String`	推送事件类型, 通话记录同步为: `callRecord`
`body`	`Object`	推送事件具体数据

body 字段格式说明

字段名称	类型	说明
`type`	`String`	事件操作类型
`ids`	`String[]`	通话ID列表

其中 type 可能出现的值有:

参数值	说明
`add`	新增了若干条通话记录
`update`	更新了若干条通话记录 (例如: 同步记录补充了通话录音或更新通话标签)
`convertRecordSuccess`	通话录音转文字成功。仅当开启通话录音转文字功能，并且录音有真实对话内容时，才会推送本事件。

ids 为通话记录 ID 列表, 用户拿到此数据后, 可以根据查询通话记录列表进行查询详细的通话记录信息

推送请求格式
数据推送会以 POST 请求的形式向推送发出若干次请求, 具体请求格式如下:

POST  https://example.dustess.com/event_push_url/
Content-Type: application/json; charset=utf-8
//新增通话记录
{
	"event": "callRecord",
	"body": {
		"type": "add",
		"ids": ["352961e6-1111-1111-1111-8ab72528b8e5"]
	}
}
//修改通话记录
{
	"event": "callRecord",
	"body": {
		"type": "update",
		"ids": ["352961e6-1111-1111-1111-8ab72528b8e5"]
	}
}
//通话录音转文字成功
{
	"event": "callRecord",
	"body": {
		"type": "convertRecordSuccess",
		"ids": ["352961e6-1111-1111-1111-8ab72528b8e5"]
	}
}

当用户开启数据加密后, body 格式为:

参数名	类型	说明
event	`String`	事件名称, 公司推送为 `company`
body	`Object`	启加密则返回加密的数据结构，需要对body.encrypt进行解密，其中参数：msgSignature，timeStamp，nonce属于解密参数，详情见文档首页加解密SDK描述
body.encrypt	`String`	加密内容
body.msgSignature	`String`	解密参数
body.timeStamp	`String`	解密参数
body.nonce	`String`	解密参数

示例

{
  "event": "company",
  "body": {
    "encrypt": "ZcaBSTGyKGu5/MknLgXop/ZIe++db5OOqS19OLEytr9KZhUQsMONpQwmOo9ZfkEWbxvTRq8TFFSqnqdzSzuw==",
    "msgSignature": "fc3a056e34f6b9e1891a9d00841e27e17611111",
    "timeStamp": "1635302196",
    "nonce": "Kocpj4zdaBDZcWB2"
  }
}

成功响应

当用户收到推送事件后, 需要向服务器回复 接受成功响应; 若没有及时回复, 服务器将会一段时间后重试 (最多15次)

响应参数名	类型	说明
`code`	`Int`	状态码: 0: 失败, 1: 成功
`msg`	`String`	响应提示

成功响应示例

{
	"code": 1,
	"msg": "success"
}