入群欢迎语素材管理-编辑

POST

http://127.0.0.1/cgi-bin/externalcontact/group_welcome_template/edit

第三方应用开发/客户联系/消息推送

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

责任人：未设置

文档ID: 19635
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/92366
https://open.work.weixin.qq.com/api/doc/90001/90143/93438

请求参数

Query 参数

access_token

string

调用接口凭证

必需

示例值:

Body 参数application/json

image

object (image)

可选

media_id

string

可选

图片的media_id，可以通过素材管理接口获得

pic_url

string

可选

图片的链接，仅可使用上传图片接口得到的链接

agentid

integer <int32>

可选

授权方安装的应用agentid。仅旧的第三方多应用套件需要填此参数

file

object (file)

可选

media_id

string

必需

文件id，可以通过素材管理接口获得

link

object (link)

可选

picurl

string

可选

图文消息封面的url 图文消息封面的url

title

string

必需

图文消息标题，最长为128字节

url

string

图文消息的链接

必需

desc

string

可选

图文消息的描述，最长为512字节

template_id

string

欢迎语素材id

必需

text

object (text)

可选

media_id

string

必需

文件id，可以通过素材管理接口获得

video

object (video)

可选

media_id

string

必需

视频媒体文件id，可以通过素材管理接口获得

miniprogram

object (miniprogram)

可选

appid

string

必需

小程序appid，必须是关联到企业的小程序应用

pic_media_id

string

必需

小程序消息封面的mediaid，封面图建议尺寸为520*416

page

string

小程序page路径

必需

title

string

必需

小程序消息标题，最长为64字节

示例

{
  "template_id": "msgXXXXXXX",
  "text": {
    "content": "文本消息内容"
  },
  "image": {
    "media_id": "MEDIA_ID",
    "pic_url": "http://p.qpic.cn/pic_wework/3474110808/7a6344sdadfwehe42060/0"
  },
  "link": {
    "title": "消息标题",
    "picurl": "https://example.pic.com/path",
    "desc": "消息描述",
    "url": "https://example.link.com/path"
  },
  "miniprogram": {
    "title": "消息标题",
    "pic_media_id": "MEDIA_ID",
    "appid": "wx8bd80126147df384",
    "page": "/path/index"
  },
  "file": {
    "media_id": "1Yv-zXfHjSjU-7LH-GwtYqDGS-zz6w22KmWAT5COgP7o"
  },
  "video": {
    "media_id": "MEDIA_ID"
  },
  "agentid": 1000014
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'http://127.0.0.1/cgi-bin/externalcontact/group_welcome_template/edit?access_token={{accesstoken}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "template_id": "msgXXXXXXX",
    "text": {
        "content": "文本消息内容"
    },
    "image": {
        "media_id": "MEDIA_ID",
        "pic_url": "http://p.qpic.cn/pic_wework/3474110808/7a6344sdadfwehe42060/0"
    },
    "link": {
        "title": "消息标题",
        "picurl": "https://example.pic.com/path",
        "desc": "消息描述",
        "url": "https://example.link.com/path"
    },
    "miniprogram": {
        "title": "消息标题",
        "pic_media_id": "MEDIA_ID",
        "appid": "wx8bd80126147df384",
        "page": "/path/index"
    },
    "file": {
        "media_id": "1Yv-zXfHjSjU-7LH-GwtYqDGS-zz6w22KmWAT5COgP7o"
    },
    "video": {
        "media_id": "MEDIA_ID"
    },
    "agentid": 1000014
}'

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

errmsg

string

可选

对返回码的文本描述内容

示例

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

入群欢迎语素材管理-添加

入群欢迎语素材管理-获取