更新企业已配置的「联系我」方式

POST

http://127.0.0.1/cgi-bin/externalcontact/update_contact_way

企业内部开发/客户联系/联系我与客户入群方式/客户联系「联系我」管理

最后修改时间：2022-08-30 03:03:37

责任人：未设置

更新企业配置的「联系我」二维码和「联系我」小程序按钮中的信息，如使用人员和备注等。
注意：已失效的临时会话联系方式无法进行编辑
当临时会话模式时（即is_temp为true），联系人仅支持配置为单人，暂不支持多人

请求参数

Query 参数

access_token

string

调用接口凭证

必需

示例值:

ACCESS_TOKEN

Body 参数application/json

config_id

string

必需

企业联系方式的配置id

remark

string

可选

联系方式的备注信息，不超过30个字符，将覆盖之前的备注

skip_verify

boolean

可选

外部客户添加时是否无需验证

style

integer

可选

样式，只针对“在小程序中联系”的配置生效

state

string

可选

企业自定义的state参数，用于区分不同的添加渠道，在调用“获取外部联系人详情”时会返回该参数值

user

array[string]

可选

使用该联系方式的用户列表，将覆盖原有用户列表

party

array[integer]

可选

使用该联系方式的部门列表，将覆盖原有部门列表，只在配置的type为2时有效

expires_in

integer

可选

临时会话二维码有效期，以秒为单位，该参数仅在临时会话模式下有效

chat_expires_in

integer

可选

临时会话有效期，以秒为单位，该参数仅在临时会话模式下有效

unionid

string

可选

可进行临时会话的客户unionid，该参数仅在临时会话模式有效，如不指定则不进行限制

conclusions

object

可选

结束语，会话结束时自动发送给客户，可参考“结束语定义”，仅临时会话模式（is_temp为true）可设置

text

object

必需

image

object

必需

link

object

必需

miniprogram

object

必需

示例

{
  "config_id": "string",
  "remark": "string",
  "skip_verify": true,
  "style": 0,
  "state": "string",
  "user": [
    "string"
  ],
  "party": [
    0
  ],
  "expires_in": 0,
  "chat_expires_in": 0,
  "unionid": "string",
  "conclusions": {
    "text": {
      "content": "string"
    },
    "image": {
      "media_id": "string"
    },
    "link": {
      "title": "string",
      "picurl": "string",
      "desc": "string",
      "url": "string"
    },
    "miniprogram": {
      "title": "string",
      "pic_media_id": "string",
      "appid": "string",
      "page": "string"
    }
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://127.0.0.1/cgi-bin/externalcontact/update_contact_way?access_token=ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
    "config_id": "string",
    "remark": "string",
    "skip_verify": true,
    "style": 0,
    "state": "string",
    "user": [
        "string"
    ],
    "party": [
        0
    ],
    "expires_in": 0,
    "chat_expires_in": 0,
    "unionid": "string",
    "conclusions": {
        "text": {
            "content": "string"
        },
        "image": {
            "media_id": "string"
        },
        "link": {
            "title": "string",
            "picurl": "string",
            "desc": "string",
            "url": "string"
        },
        "miniprogram": {
            "title": "string",
            "pic_media_id": "string",
            "appid": "string",
            "page": "string"
        }
    }
}'

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

示例

{
  "errcode": 0,
  "errmsg": "ok"
}

管理企业规则组下的客户标签-删除指定规则组下的企业客户标签

删除企业已配置的「联系我」方式