一、核心 API 接口与请求结构实现向外部群客户群发送消息的核心接口是API 接口POST /cgi-bin/appchat/send用途应用向群聊发送消息。身份消息以应用的身份发送。请求主体 (Payload) 结构必须是JSON 格式。1.1 基础 JSON Payload 结构所有发送给群聊的消息 JSON 必须包含以下基础字段字段名类型描述chatidstring目标群聊的 ID。msgtypestring消息类型如text、image、file、link等。safeint是否是保密消息0(否) 或1(是)。建议保持0。消息内容对象object根据msgtype命名的对象包含消息的具体内容。二、Payload 构造详解主流消息类型根据msgtype的不同消息的具体内容对象如text,image,link的结构也不同。2.1 文本消息 (msgtype: text)这是最简单也是最常用的消息类型。字段名类型描述text.contentstring消息文本。支持 2048 字节超过会被截断。JSON 示例 (文本消息):JSON{ chatid: wrU123456789, msgtype: text, text: { content: 尊敬的客户本周特惠产品已更新请点击链接查看详情 } }2.2 图片消息 (msgtype: image)用于发送图片。消息主体中不能直接发送图片文件必须提供一个已上传至企业微信的媒体 ID。字段名类型描述image.media_idstring图片的临时素材 ID。必须通过媒体上传接口事先获取。JSON 示例 (图片消息):{ chatid: wrU123456789, msgtype: image, image: { media_id: 3M0uW32r2_P6_v4V04_X5u6F7I8T9N0K1L2J3H4G5F6E } }2.3 文件消息 (msgtype: file)用于发送 PDF、Excel 等文件。与图片消息类似需要提供媒体 ID。字段名类型描述file.media_idstring文件的临时素材 ID。通过媒体上传接口获取。JSON 示例 (文件消息):{ chatid: wrU123456789, msgtype: file, file: { media_id: 1V3uW12r2_P6_v4V04_X5u6F7I8T9N0K1L2J3H4G5F6E } }2.4 图文链接卡片消息 (msgtype: link)用于发送带有标题、描述和封面的外部链接以卡片形式展示。字段名类型描述link.titlestring链接标题必填。link.textstring链接描述。link.picurlstring封面图片 URL。link.messageurlstring点击后跳转的 URL必填。JSON 示例 (链接卡片):{ chatid: wrU123456789, msgtype: link, link: { title: 2024 年终大促活动详情, text: 点击查看所有产品的折扣力度和限时抢购时间表。, picurl: http://example.com/cover_image.jpg, messageurl: http://example.com/sale_details } }三、Payload 构造的注意事项媒体 ID 的时效性图片和文件使用的media_id有效期为 3 天72 小时。必须在有效期内使用。如果 ID 过期需要重新上传获取新的 ID。JSON 编码整个 Payload 必须进行正确的JSON 编码。任何特殊字符如换行符、引号必须被转义。URL 编码在链接卡片中messageurl字段的 URL 需确保已进行URL 编码以防包含特殊字符。字段校验严格遵循企业微信 API 文档中对每个字段的长度和格式要求缺失必填字段或字段格式错误会导致 API 返回错误。例如文本内容不能超过 2048 字节。实施建议客户联系功能启用步骤操作步骤权限申请请通过QiWe开放平台管理后台提交“客户联系”功能的使用权限申请。获取访问凭证请使用企业corpidcorpid企业ID和corpsecretcorpsecret应用密钥作为参数调用相应接口以获取access_tokenaccess_token访问令牌。目的完成上述轻量级开发部署后即可启用通过接口进行客户联系管理的能力。
一、核心 API 接口与请求结构实现向外部群客户群发送消息的核心接口是API 接口POST /cgi-bin/appchat/send用途应用向群聊发送消息。身份消息以应用的身份发送。请求主体 (Payload) 结构必须是JSON 格式。1.1 基础 JSON Payload 结构所有发送给群聊的消息 JSON 必须包含以下基础字段字段名类型描述chatidstring目标群聊的 ID。msgtypestring消息类型如text、image、file、link等。safeint是否是保密消息0(否) 或1(是)。建议保持0。消息内容对象object根据msgtype命名的对象包含消息的具体内容。二、Payload 构造详解主流消息类型根据msgtype的不同消息的具体内容对象如text,image,link的结构也不同。2.1 文本消息 (msgtype: text)这是最简单也是最常用的消息类型。字段名类型描述text.contentstring消息文本。支持 2048 字节超过会被截断。JSON 示例 (文本消息):JSON{ chatid: wrU123456789, msgtype: text, text: { content: 尊敬的客户本周特惠产品已更新请点击链接查看详情 } }2.2 图片消息 (msgtype: image)用于发送图片。消息主体中不能直接发送图片文件必须提供一个已上传至企业微信的媒体 ID。字段名类型描述image.media_idstring图片的临时素材 ID。必须通过媒体上传接口事先获取。JSON 示例 (图片消息):{ chatid: wrU123456789, msgtype: image, image: { media_id: 3M0uW32r2_P6_v4V04_X5u6F7I8T9N0K1L2J3H4G5F6E } }2.3 文件消息 (msgtype: file)用于发送 PDF、Excel 等文件。与图片消息类似需要提供媒体 ID。字段名类型描述file.media_idstring文件的临时素材 ID。通过媒体上传接口获取。JSON 示例 (文件消息):{ chatid: wrU123456789, msgtype: file, file: { media_id: 1V3uW12r2_P6_v4V04_X5u6F7I8T9N0K1L2J3H4G5F6E } }2.4 图文链接卡片消息 (msgtype: link)用于发送带有标题、描述和封面的外部链接以卡片形式展示。字段名类型描述link.titlestring链接标题必填。link.textstring链接描述。link.picurlstring封面图片 URL。link.messageurlstring点击后跳转的 URL必填。JSON 示例 (链接卡片):{ chatid: wrU123456789, msgtype: link, link: { title: 2024 年终大促活动详情, text: 点击查看所有产品的折扣力度和限时抢购时间表。, picurl: http://example.com/cover_image.jpg, messageurl: http://example.com/sale_details } }三、Payload 构造的注意事项媒体 ID 的时效性图片和文件使用的media_id有效期为 3 天72 小时。必须在有效期内使用。如果 ID 过期需要重新上传获取新的 ID。JSON 编码整个 Payload 必须进行正确的JSON 编码。任何特殊字符如换行符、引号必须被转义。URL 编码在链接卡片中messageurl字段的 URL 需确保已进行URL 编码以防包含特殊字符。字段校验严格遵循企业微信 API 文档中对每个字段的长度和格式要求缺失必填字段或字段格式错误会导致 API 返回错误。例如文本内容不能超过 2048 字节。实施建议客户联系功能启用步骤操作步骤权限申请请通过QiWe开放平台管理后台提交“客户联系”功能的使用权限申请。获取访问凭证请使用企业corpidcorpid企业ID和corpsecretcorpsecret应用密钥作为参数调用相应接口以获取access_tokenaccess_token访问令牌。目的完成上述轻量级开发部署后即可启用通过接口进行客户联系管理的能力。
)
