获取业务记录模板

该接口用于获取公司下的所有业务记录模板

请求方法

get notes/note_template

请求参数

返回数据

属性 类型 说明
code 整型 执行结果码,1000代表成功
note_template 数组 模板内容,结构如下
属性 类型 说明
id 整型 业务记录模板的id
name 字符串 业务记录模板的名称
desc 字符串 业务记录的模板描述
category 字符串 业务记录的模板类型
custom_fields 数组 业务记录模板下的自定义字段
ticket_template_id 整型 工单模板
属性 类型 说明
field_id 整型 自定义字段的id
field_type 字符串 自定义字段的类型
name 字符串 自定义字段的name
comment 字符串 自定义字段的描述
is_required boolean 是否必填

示例

请求

curl https://demo.udesk.cn/open_api_v1/notes/note_template?email=admin@udesk.cn&timestamp=1504849662&sign=9f9d0857e93158d06ce32857d52401e76167bbe7

返回

{
    "code": 1000,
    "note_template": [
        {
            "id": 1,
            "name": "IM业务记录",
            "desc": "应用于客服对IM对话内容进行整理记录",
            "category": "im",
            "ticket_template_id": 1,
            "custom_fields": [
                {
                    "field_id": 3,
                    "field_type": "TextField",
                    "name": "TextField_3",
                    "comment": null,
                    "owner": "Ticket",
                    "is_required": true
                },
                {
                    "field_id": 14,
                    "field_type": "TextField",
                    "name": "TextField_14",
                    "comment": "发达",
                    "owner": "Ticket",
                    "is_required": false
                },
                {
                    "field_id": 40,
                    "field_type": "TextField",
                    "name": "TextField_40",
                    "comment": null,
                    "owner": "Ticket",
                    "is_required": false
                },
                {
                    "field_id": 5,
                    "field_type": "SelectField",
                    "name": "SelectField_5",
                    "comment": null,
                    "owner": "Ticket",
                    "is_required": false
                },
                {
                    "field_id": 17,
                    "field_type": "TextField",
                    "name": "TextField_17",
                    "comment": null,
                    "owner": "Ticket",
                    "is_required": false
                }
            ]
        },
        {
            "id": 2,
            "name": "呼叫中心业务记录",
            "desc": "应用于客服对呼叫中心通话记录进行整理记录",
            "category": "call",
            "ticket_template_id": 1,
            "custom_fields": []
        }
    ]
}

修改业务记录模板

本接口用于对业务记录模板内容的修改

请求方法

post notes/update_note_template

请求参数(request body)

属性 必填 类型 说明 限制
id 否     整型 业务模板的id
category 否     整型 业务模板的类型
ticket_template_id 否     整型 工单模板的id
custom_fields 否     数组 自定义字段的类型

示例

请求

curl https://demo.udesk.cn/open_api_v1/notes/update_note_template?email=admin@udesk.cn&timestamp=1504849662&sign=9f9d0857e93158d06ce32857d52401e76167bbe7 \
-X POST \
-H 'content-type:application/json' \
-d '{
    "id":"1",
    "ticket_template_id": 30002,
    "custom_fields":  [
       {"field_id":3, "field_type":"TextField", "is_required":true},
       {"field_id":14, "field_type":"TextField", "is_required":false},
       {"field_id":40, "field_type":"TextField", "is_required":false},
       {"field_id":17, "field_type":"TextField", "is_required":false},
       {"field_id":5, "field_type":"SelectField", "is_required":false},
       {"field_id":41, "field_type":"TextField", "is_required":true}

   ]

}'

返回

{
    "code": 1000,
    "ticket_template_id":30002,
    "note_template": {
        "id": 1,
        "name": "IM业务记录",
        "desc": "应用于客服对IM对话内容进行整理记录",
        "category": "im",
        "ticket_template_id": 30002,
        "custom_fields": [
            {
                "field_id": 3,
                "field_type": "TextField",
                "name": "TextField_3",
                "comment": null,
                "is_required": true
            },
            {
                "field_id": 14,
                "field_type": "TextField",
                "name": "TextField_14",
                "comment": "发达",
                "is_required": false
            },
            {
                "field_id": 40,
                "field_type": "TextField",
                "name": "TextField_40",
                "comment": null,
                "is_required": false
            },
            {
                "field_id": 17,
                "field_type": "TextField",
                "name": "TextField_17",
                "comment": null,
                "is_required": false
            },
            {
                "field_id": 5,
                "field_type": "SelectField",
                "name": "SelectField_5",
                "comment": null,
                "is_required": false
            },
            {
                "field_id": 41,
                "field_type": "TextField",
                "name": "TextField_41",
                "comment": null,
                "is_required": true
            }
        ]
    }
}

获取业务记录列表

本接口用于获取满足某条件的业务记录列表

请求方法

get /notes

请求参数(query string)

属性 必填 类型 说明 限制
start_date 日期时间 业务记录
end_date 日期时间 业务记录
category 字符串 业务记录类型,值为"im"或"call"
page 整型 当前页,默认为1
per_page 整型 每页显示的数据量,范围1~50,默认为20

返回数据

属性 类型 说明
code 整型 执行结果码,1000代表成功
note_record 数组 业务记录
meta 对象 分页相关内容
属性 类型 说明
id 整型 业务记录id
content 字符串 业务记录主题
agent_id 整型 客服id
agent_nick_name 字符串 客服昵称
customer_id 整型 客户id
customer_nick_name 字符串 客户昵称
custom_fields 数组 自定义字段
created_at 日期时间 业务记录创建时间
last_editor_id 整型 最后编辑者的id
last_editor_nick_name 字符串 最后编辑者的昵称
category 字符串 业务记录类型
session_id 整型 关联id
session_type 字符串 业务记录

示例

请求

curl https://demo.udesk.cn/open_api_v1/notes?email=admin@udesk.cn&timestamp=1504849662&sign=9f9d0857e93158d06ce32857d52401e76167bbe7

返回

{
    "code": 1000,
    "note_record": [
        {
            "id": 3,
            "content": "NULL",
            "category": "im",
            "custom_fields": {
                "SelectField_2": "1"
            },
            "created_at": "2017-01-17T14:14:55.000+08:00",
            "customer_id": 1014,
            "customer_nick_name": null,
            "agent_id": 1,
            "agent_nick_name": "alalla",
            "last_editor_id": 1,
            "last_editor_nick_name": "alalla",
            "session_id": 2,
            "session_type": "ImSubSession"
        },
        {
            "id": 2,
            "content": "NULL",
            "category": "im",
            "custom_fields": {
                "TextField_3": "2017-01-19"
            },
            "created_at": "2017-01-17T14:14:51.000+08:00",
            "customer_id": 1014,
            "customer_nick_name": null,
            "agent_id": 1,
            "agent_nick_name": "alalla",
            "last_editor_id": 1,
            "last_editor_nick_name": "alalla",
            "session_id": 4,
            "session_type": "ImSubSession"
        },
        {
            "id": 1,
            "content": "主题啦啦啦",
            "category": "im",
            "custom_fields": {
                "TextField_3": "2017-01-25",
                "TextField_4": "23:58:59",
                "TextField_5": "12313",
                "TextField_6": "2343243",
                "TextField_7": "https://demo.udesk.cn/entry/analysis/im/record",
                "SelectField_2": "0",
                "SelectField_3": "0,0,0",
                "SelectField_5": "0,1,2"
            },
            "created_at": "2017-01-17T14:13:41.000+08:00",
            "customer_id": 1014,
            "customer_nick_name": null,
            "agent_id": 1,
            "agent_nick_name": "alalla",
            "last_editor_id": 1,
            "last_editor_nick_name": "alalla",
            "session_id": 5,
            "session_type": "ImSubSession"
        }
    ],
    "meta": {
        "current_page": 1,
        "total_pages": 1,
        "total_records": 3
    }
}

获取某一条业务记录详情

本接口用于获取满足某条件的一条业务记录

请求方法

get /notes/detail

请求参数(query string)

属性 必填 类型 说明 限制
note_id 整型 业务记录id
category 字符串 业务记录类型
session_id 整型 关联id

返回数据

属性 类型 说明
code 整型 执行结果码,1000代表成功
note_record 对象 业务记录
属性 类型 说明
id 整型 业务记录id
content 字符串 业务记录主题
agent_id 整型 客服id
agent_nick_name 字符串 客服昵称
customer_id 整型 客户id
customer_nick_name 字符串 客户昵称
custom_fields 数组 自定义字段
created_at 日期时间 业务记录创建时间
last_editor_id 整型 最后编辑者的id
last_editor_nick_name 字符串 最后编辑者的昵称
category 字符串 业务记录类型
session_id 整型 关联id
session_type 字符串 业务记录

示例

请求

curl https://demo.udesk.cn/open_api_v1/notes/detail?email=admin@udesk.cn&timestamp=1504849662&sign=9f9d0857e93158d06ce32857d52401e76167bbe7&note_id=1

返回

{
    "code": 1000,
    "note_record": {
        "id": 1,
        "content": "主题啦啦啦",
        "category": "im",
        "custom_fields": {
            "TextField_3": "2017-01-25",
            "TextField_4": "23:58:59",
            "TextField_5": "12313",
            "TextField_6": "2343243",
            "TextField_7": "https://demo.udesk.cn/entry/analysis/im/record",
            "SelectField_2": "0",
            "SelectField_3": "0,0,0",
            "SelectField_5": "0,1,2"
        },
        "created_at": "2017-01-17T14:13:41.000+08:00",
        "customer_id": 1014,
        "customer_nick_name": null,
        "agent_id": 1,
        "agent_nick_name": "alalla",
        "last_editor_id": 1,
        "last_editor_nick_name": "alalla",
        "session_id": 5,
        "session_type": "ImSubSession"
    }
}

修改业务记录

该接口用于修改某条业务记录

请求方法

put /notes/:id

请求参数(request body)

属性 必填 类型 说明 限制
note 对象   业务记录内容
属性 必填 类型 说明 限制
content 字符串 业务记录主题
last_editor_id 整型 最后编辑者的id
custom_fields 对象 自定义字段

返回数据

属性 类型 说明
code 整型 执行结果码,1000代表成功
note_record 对象 业务记录
属性 类型 说明
id 整型 业务记录id
content 字符串 业务记录主题
agent_id 整型 客服id
agent_nick_name 字符串 客服昵称
customer_id 整型 客户id
customer_nick_name 字符串 客户昵称
custom_fields 数组 自定义字段
created_at 日期时间 业务记录创建时间
last_editor_id 整型 最后编辑者的id
last_editor_nick_name 字符串 最后编辑者的昵称
category 字符串 业务记录类型
session_id 整型 关联id
session_type 字符串 业务记录

示例

请求

curl https://demo.udesk.cn/open_api_v1/notes/1?email=admin@udesk.cn&timestamp=1504849662&sign=9f9d0857e93158d06ce32857d52401e76167bbe7 \
-X PUT \
-H 'content-type:application/json' \
-d '{
    "content": "修改业务记录",
    "custom_fields" : {
        "TextField_3": "2017-01-25",
        "TextField_4": "23:58:59",
        "TextField_5": "12313",
        "TextField_6": "2343243",
        "TextField_7": "https://demo.udesk.cn/entry/analysis/im/record",
        "SelectField_2": "0",
        "SelectField_3": "0,0,0",
        "SelectField_5": "0,1,2"
    }
}'

返回

{
    "code": 1000,
    "note_record": {
        "id": 1,
        "content": "修改业务记录",
        "category": "im",
        "custom_fields": {
            "TextField_3": "2017-01-25",
            "TextField_4": "23:58:59",
            "TextField_5": "12313",
            "TextField_6": "2343243",
            "TextField_7": "https://demo.udesk.cn/entry/analysis/im/record",
            "SelectField_2": "0",
            "SelectField_3": "0,0,0",
            "SelectField_5": "0,1,2"
        },
        "created_at": "2017-01-17T14:13:41.000+08:00",
        "customer_id": 1014,
        "customer_nick_name": null,
        "agent_id": 1,
        "agent_nick_name": "alalla",
        "last_editor_id": 1,
        "last_editor_nick_name": "alalla",
        "session_id": 5,
        "session_type": "ImSubSession"
    }
}

业务记录变更

该接口用于创建或修改业务记录

请求方法

post /notes

请求参数

属性 必填 类型 说明 限制
category 字符串 业务记录类型,im/call
session_id 整型    业务记录关联id
note 对象   业务记录内容
属性 必填 类型 说明 限制
agent_id 整型    客服id
customer_id 整型    客户id
session_id 整型    业务记录对应的session_id
session_type 字符串 业务记录对应的类型
content 字符串 业务记录详细内容
last_editor_id 整型 最后编辑者的id
custom_fields 对象 自定义字段

返回数据

属性 类型 说明
code 整型 执行结果码,1000代表成功
note_record 对象 业务记录
属性 类型 说明
id 整型 业务记录id
content 字符串 业务记录主题
agent_id 整型 客服id
agent_nick_name 字符串 客服昵称
customer_id 整型 客户id
customer_nick_name 字符串 客户昵称
custom_fields 数组 自定义字段
created_at 日期时间 业务记录创建时间
last_editor_id 整型 最后编辑者的id
last_editor_nick_name 字符串 最后编辑者的昵称
category 字符串 业务记录类型
session_id 整型 关联id
session_type 字符串 业务记录

示例

请求

curl https://demo.udesk.cn/open_api_v1/notes?email=admin@udesk.cn&timestamp=1504849662&sign=9f9d0857e93158d06ce32857d52401e76167bbe7 \
-X POST \
-H 'content-type:application/json' \
-d '{
    "category": "im",
    "session_id": 5,
    "note": {
        "content": "修改业务记录",
        "agent_id": 1,
        "customer_id": 1014,
        "session_id": 5,
        "session_type": "ImSubSession",
        "last_editor_id": 1,
        "custom_fields": {
            "TextField_3": "2017-01-25",
            "TextField_4": "23:58:59",
            "TextField_5": "12313",
            "TextField_6": "2343243",
            "TextField_7": "https://demo.udesk.cn/entry/analysis/im/record",
            "SelectField_2": "0",
            "SelectField_3": "0,0,0",
            "SelectField_5": "0,1,2"
        }
    }
}'

返回

{
    "code": 1000,
    "note_record": {
        "id": 1,
        "content": "修改业务记录",
        "category": "im",
        "custom_fields": {
            "TextField_3": "2017-01-25",
            "TextField_4": "23:58:59",
            "TextField_5": "12313",
            "TextField_6": "2343243",
            "TextField_7": "https://demo.udesk.cn/entry/analysis/im/record",
            "SelectField_2": "0",
            "SelectField_3": "0,0,0",
            "SelectField_5": "0,1,2"
        },
        "created_at": "2017-01-17T14:13:41.000+08:00",
        "customer_id": 1014,
        "customer_nick_name": null,
        "agent_id": 1,
        "agent_nick_name": "alalla",
        "last_editor_id": 1,
        "last_editor_nick_name": "alalla",
        "session_id": 5,
        "session_type": "ImSubSession"
    }
}