客户信息变更回调

POST

/v1/notify/change/customer/info

功能说明：

本接口需要提前安装自建应用或待开发应用才可以进行回调！

当客户核心信息发生改变时、本接口会将信息回调给接收方

变更信息包括：客户昵称、头像、标签等

请求参数

Query 参数

token

string

调用接口凭证

可选

Body 参数application/json

type

string

必需

event

object

必需

ToUserName

string

企业微信qiyeid -cropid

必需

FromUserName

string

固定sys

必需

CreateTime

string

添加时间（秒）

必需

MsgType

string

固定event

必需

Event

string

固定change_external_contact

必需

ChangeType

string

固定edit_external_contact

必需

UserID

string

企业微信员工id

必需

ExternalUserID

string

企业微信外部联系人id

必需

State

string

添加此用户的渠道活码方式配置的state参数，可用于识别添加此用户的渠道

可选

data

object

必需

unionId

string

客户的开放平台id

必需

name

string

客户姓名

必需

avatar

string

客户头像

可选

externalUserId

string

客户的外部联系人id

必需

gender

number

客户性别 0 -未知 1 -男性 2 -女性

必需

type

number

客户的类型

必需

1 表示该客户是微信用户，2 表示该客户是企业微信用户

followUser

array [object {7}]

必需

timestamp

integer

时间戳（毫秒）

必需

示例

{
    "type": "string",
    "event": {
        "ToUserName": "string",
        "FromUserName": "string",
        "CreateTime": "string",
        "MsgType": "string",
        "Event": "string",
        "ChangeType": "string",
        "UserID": "string",
        "ExternalUserID": "string",
        "State": "string"
    },
    "data": {
        "unionId": "string",
        "name": "string",
        "avatar": "string",
        "externalUserId": "string",
        "gender": 0,
        "type": 0,
        "followUser": [
            {
                "userId": "string",
                "name": "string",
                "remark": "string",
                "avatar": "string",
                "createTimestamp": 0,
                "tags": [
                    {
                        "groupName": "string",
                        "tagName": "string",
                        "type": "string",
                        "tagId": "string"
                    }
                ],
                "remarkMobiles": [
                    "string"
                ]
            }
        ]
    },
    "timestamp": 0
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v1/notify/change/customer/info?token=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": "string",
    "event": {
        "ToUserName": "string",
        "FromUserName": "string",
        "CreateTime": "string",
        "MsgType": "string",
        "Event": "string",
        "ChangeType": "string",
        "UserID": "string",
        "ExternalUserID": "string",
        "State": "string"
    },
    "data": {
        "unionId": "string",
        "name": "string",
        "avatar": "string",
        "externalUserId": "string",
        "gender": 0,
        "type": 0,
        "followUser": [
            {
                "userId": "string",
                "name": "string",
                "remark": "string",
                "avatar": "string",
                "createTimestamp": 0,
                "tags": [
                    {
                        "groupName": "string",
                        "tagName": "string",
                        "type": "string",
                        "tagId": "string"
                    }
                ],
                "remarkMobiles": [
                    "string"
                ]
            }
        ]
    },
    "timestamp": 0
}'

返回响应

🟢200成功

application/json

Body

errCode

number

返回码

必需

示例

{
    "errCode": 0
}

修改于 2024-09-06 12:17:44

新增客户回调—RPA

删除客户或者被客户删除回调