创建客户动态

开发中

POST

/open-api/customer/behaviour/create-customer-behavior

最后修改时间：2024-10-22 04:46:37

该接口用于通过应用根据企微客户外部联系人 id 或者 unionid 创建客户动态，并通知到指定员工

请求参数

Query 参数

access_token

string

可选

示例值:

Header 参数

Authorization

string

可选

默认值:

Bearer {{auth_token}}

Body 参数application/json

customerOpenid

string

客户的明文customerid

必需

与 unionid 二选一必填

unionid

string

客户的 unionid

必需

与 customerOpenid 二选一必填

behaviourTitle

string

客户动态记录标题

必需

behaviourLog

string

客户动态记录内容

必需

behaviourTime

string

客户动态触发时间

必需

noticeStatus

enum<integer>

客户动态内容是否通知员工

必需

枚举值:

noticeTitle

string

客户动态通知标题

可选

noticeStatus 为 1 时必填

noticeLog

string

客户动态通知内容

可选

noticeStatus 为 1 时必填

示例

{
    "behaviourLog": "自定义动态",
    "behaviourTitle": "动态标题",
    "noticeLog": "自定义通知",
    "noticeTitle": "通知标题",
    "noticeStatus": 1,
    "userOpenid": "simpleNing",
    "customerOpenid": "wmabc",
    "unionid": "",
    "behaviourTime": "2024-09-04 20:30:45"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST '/open-api/customer/behaviour/create-customer-behavior?access_token={{access_token}}' \
--header 'Authorization: Bearer {{auth_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "behaviourLog": "自定义动态",
    "behaviourTitle": "动态标题",
    "noticeLog": "自定义通知",
    "noticeTitle": "通知标题",
    "noticeStatus": 1,
    "userOpenid": "simpleNing",
    "customerOpenid": "wmabc",
    "unionid": "",
    "behaviourTime": "2024-09-04 20:30:45"
}'

返回响应

🟢200成功

application/json

Body

code

integer

状态码

必需

0 表示成功，非 0 表示失败

msg

string

状态码描述

必需

data

boolean | null

操作结果

必需

requestId

string

请求的 traceid

可选

示例

成功示例请求参数非法

{
    "code": 0,
    "data": true,
    "msg": "",
    "requestId": "1123453"
}

更新客户标签

获取客户标签数据