# 发送朋友圈(平台号)

[异步回调]发送朋友圈,仅限平台号

说明:因企业微信朋友圈的呈现目前是依托于微信客户端,所以朋友圈发送完成后会有2次回调。
先接收到推送至企业微信服务端成功的回调(回调码:401001),再接受到推送至微信客户端成功的回调(回调码:401002)。
当接收到第二条回调,才代表推送至客户的微信端成功了,因此企业微信发送后会生成2个编号,执行朋友圈相关操作需传入2个朋友圈编号。平台号“无客户联系使用权限,联系管理员开通”无法发送朋友圈。且遵循微信规则“每位客户的朋友圈每天最多可展示1条你发表的内容”。

请求方式:POST

请求地址:https://api.aquanliang.com/gateway/qopen/PublishMoment

body参数

{
    "robot_id": "机器人id",
    "allowed_type": 1,
    "contact_id_list": ["若可见的客户选择部分可见,则需传入可见的好友编号"],
    "moment_type": 2001,
    "content": "朋友圈文字内容",
    "medias": [
        {
            "href": "图片或视频链接",
            "video_time": 20
        }
    ]
}

文件相关限制

  • 图片:长宽分辨率乘积小于1555200,最大宽度小于1080,小于500K
  • 视频:视频长度小于30秒,视频小于10M
字段 类型 必填 说明
robot_id string 机器人id
allowed_type int 可见的客户: 1 默认全部可见 2 部分可见
contact_id_list array 若可见的客户选择部分可见,则需传入可见的好友编号
moment_type int 朋友圈类型 1. 文字 2001 :只支持纯文字 2. 图片 2002 :支持文字+多张图片或纯图片 3. 视频 2004 :支持文字+视频(视频只支持传入1个)或纯视频
content string 朋友圈文字内容
medias.href string 图片或视频链接
medias.video_time int 视频时长,图片类型可传0

接口返回值:

{
    "errcode": 0,
    "errmsg": "",
    "data": {
        "serial_no": "请求序列号"
    }
}
字段 类型 说明
errcode int 状态码,0为正常,非0代表错误
errmsg string 错误信息
serial_no string 请求序列号

处理结果,异步返回值 1:

{
    "event_type": 401001,
    "err_code": 0,
    "err_msg": "",
	"serial_no": "请求序列号",
    "robot_id": "机器人id",
	"data": {
        "post_id": "推送至企业微信成功返回的朋友圈id",
        "fail_contacts": ["发送失败的客户id"]
    }
}
字段 类型 说明
event_type int 事件类型,401001
err_code int 状态码,0为正常,非0代表错误
err_msg string 错误信息
serial_no string 请求序列号
robot_id string 机器人id
post_id string 推送至企业微信成功返回的朋友圈id
fail_contacts array 发送失败的客户id

处理结果,异步返回值 2:

{
    "event_type": 401002,
    "err_code": 0,
    "err_msg": "",
    "serial_no": "请求序列号",
    "robot_id": "机器人id",
    "data": {
        "post_id": "推送至企业微信成功返回的朋友圈id",
        "moment_id": "推送至微信客户端成功的朋友圈id",
        "fail_contacts": ["发送失败的客户id"]
    }
}
字段 类型 说明
event_type int 事件类型,401002
err_code int 状态码,0为正常,非0代表错误
err_msg string 错误信息
serial_no string 请求序列号
robot_id string 机器人编号
post_id string 推送至企业微信成功返回的朋友圈id
moment_id string 推送至微信客户端成功的朋友圈id
fail_contacts array 发送失败的客户编号

完整请求示例:

curl -X POST \
  https://api.aquanliang.com/gateway/qopen/PublishMoment \
  -H 'Content-Type: application/json; charset=UTF-8' \
  -H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
  -d '{
        "robot_id": "机器人id",
        "allowed_type": 1,
        "contact_id_list": ["若可见的客户选择部分可见,则需传入可见的好友编号"],
        "moment_type": 2001,
        "content": "朋友圈文字内容",
        "medias": [
            {
                "href": "图片或视频链接",
                "video_time": 20
            }
        ]
      }'