聚合聊天openAPI文档

使用说明

API鉴权

💡需要在header中传入apikey参数，apikey获取方式如下：
step1：打开浏览器输入网址：https://account.gnlab.com/auth
step2：选择使用光年主账号登录（apikey只有登录光年主账号才能获取到）
step3：导航至“基本信息”--点击“通过短信发送”（apikey将会发送至绑定的手机号）

请求示例

curl --location --request GET 'http://localhost/gnapi/open/inner/user/wx/list' \
--header 'apikey: xxxxxxx' \

API调用示例

💡为方便读者快速掌握Quntool openAPI 调用方法，我们提供了各个API 接口的Postman调用示例，下载下方的json文件，导入postman。 将服务器地址和相关参数进行替换，即可进行调用。

quntool_openAPI.postman_collection.json

回调消息

💡发送消息如果是通过openAPI发送的，那么返回字段就会有"isOpenApi":true
通过quntool或者openapi发送消息时，如果发送失败，则字段中的error_code不为0，目前已知会造成失败的情况是发送频率超过企微官方限制

需要提前在网页端配置好回调地址。
（管理员访问网页端 - 左下角“系统管理” - 沟通中台 API）

回调参数：
- source string 容器id
- userId string quntool登录用户id（即光年账号id）
- wxid string 企业微信id（即登录quntool系统的企业微信id）
- timestamp string 发起回调时间
- type string 消息类型
- data object 消息体
- sendMsgId string 通过发消息接口发送的消息会有此字段，对应发送接口返回的msgId

登录二维码状态

type为 qrcode_status_msg

{
 "msgId":"3c2bbad6-2766-4d3c-a8d5-f9a7e352d24e",
 "source":"17eeb4b5a466",//就是hostname
 "userId":null,
 "wxid":"",
 "timestamp":1697793173604,
 "type":"qrcode_status_msg",//消息类型
 "data":{
         "auth_deviceid":"baab90ef80ca9f2f",
         "corpid":"1970325032041886",//这个企业微信的企业主体id
         "gid":"2251802343725191",
         "icon_url":"https:\/\/[wework.qpic.cn](http://wework.qpic.cn/)\/wwpic\/432747_J-GmtzgQQ02OMfv_1650209771\/0",
         "is_bind_wx":true,
         "keep_sec":600,
         "lang_type":1,
         "logo":"https:\/\/[p.qlogo.cn](http://p.qlogo.cn/)\/bizmail\/1icHEZ7ow1wlxR3ic8d5PQsYBjI6YtiaMz3qP2JUfiafn3ORu9yfQNa4sg\/0",
         "nick_name":"helloni4栋",//这个企业微信在app页面上的‘姓名’字段
         "qrcode_key":"6E16C7042D0A4E832114E839EB1694CE",
         "status":10,//标识着二维码的状态
         "vid":"1688850535328682"//这个企业微信的wxid
}

其中 status 值标识着二维码的状态 ，值如下:

enum QrcodeStatus {
    QRCODE_LOGIN_NEVER = 0;
    QRCODE_LOGIN_ING = 1;
    QRCODE_LOGIN_SUCC = 2;
    QRCODE_LOGIN_FAIL = 3;
    QRCODE_LOGIN_REFUSE = 4;
    QRCODE_LOGIN_ING_WX = 5;
    QRCODE_LOGIN_SUCC_WX = 6;
    QRCODE_LOGIN_FAIL_WX = 7;
    QRCODE_LOGIN_REFUSE_WX = 8;
    QRCODE_WX_AUTH_OK = 9;
    QRCODE_REQUIRE_VERIFY = 10;
}

当 status == QRCODE_REQUIRE_VERIFY(10) 时， 也就是需要登录验证码了，在业务前端让用户输入验证码

扫码安全验证

经测试发现，部分企业微信在该服务器上是第一次登录，那么在25分钟左右会推送新设备安全验证二维码

type为 safe_validate

{ 
"msgId":"3c2bbad6-2766-4d3c-a8d5-f9a7e352d24e",
"source":"17eeb4b5a466",//就是hostname
"userId":"apps-1",//光年账号id 
"wxid":"168885056393XXXX",//登录的企业微信id
"timestamp":1697793173604,
"type":"safe_validate",//消息类型
"data":{ 
   "Qrcode":"/gnapi/files/cache/xxxxxx.jpg",//待扫描的二维码图片地址 （有效期5分钟）
   "UserName":"企业微信名称"   
       } 
}

文字消息

type为 text_msg

• quntool端接收消息的回调如下：
  

  javascripttypescripthtmlcssshellpythongolangjavacc++c#phprubyswiftkotlinscalarustdartelixirhaskellluaperlrsql

  {
    "msgId":"fecd1bdc-0924-4fde-b1a6-7f9adb0ebc44",
    "source":"40c10a375784",
    "userId":"apps-1",//光年账号id
    "wxid":"168885056393XXXX",//登录的企业微信id
    "timestamp":1686708147954,
    "type":"text_msg",//消息类型
    "data":{
      "appinfo":"5079167612398453673",
      "at_list":[],//群聊@某人
      "content":"呼啦",
      "content_type":2,
      "conversation_id":"S:168885056393XXXX_788130083907XXXX",//若是群聊则是R:群聊id
      "is_pc":0,
      "local_id":"1363",
      "receiver":"168885056393XXXX",//登录的企业微信id（接收消息方）
      "send_time":"1686708146",
      "sender":"788130083907XXXX",//客户的微信id（发送消息方）
      "sender_name":"左脚",//客户的微信昵称（发送消息方）
      "server_id":"1012206"//企业微信服务端消息id
    },
    "sendMsgId":null
  }

  
  

• quntool端发出消息的回调如下：
  

  javascripttypescripthtmlcssshellpythongolangjavacc++c#phprubyswiftkotlinscalarustdartelixirhaskellluaperlrsql

  {
    "msgId":"1f87e08a-9d7e-48ce-9ebe-0c4bd09c88ef",
    "source":"40c10a375784",
    "userId":"apps-1",//光年账号id
    "wxid":"168885056393XXXX",//登录的企业微信id
    "timestamp":1686708431977,
    "type":"text_msg",//消息类型
    "data":{
      "at_list":[],//群聊@某人
      "content":"早晨阳光里！",
      "content_type":0,
      "conversation_id":"S:16888505639XXXX_788130083907XXXX",//若是群聊则是R:群聊id
      "is_pc":1,
      "receiver":"788130083907XXXX",//客户的微信id（接收消息方）
      "send_time":1686708431,
      "sender":"168885056393XXXX",//登录的企业微信id（发送消息方）
      "server_id":"1012209",//企业微信服务端消息id
      "sendUserId":"apps-1",//光年账号id
      "sendUserName":"眠羊",//光年账号昵称
      "error_code":-1000999,//发送失败错误码，0表示发送成功
      "error_message":"Abnormal request frequency"//发送失败错误原因
    },
    "sendMsgId":"a142fe5f-0220-4084-931c-1206987fbae1"
  }

  
  

图片消息

type为 image_msg

💡file_path为服务器图片相对路径，前面需要带上quntool的域名才能访问，例如：http://192.168.1.1/gnapi/files/Cache/20230614/43aee759371c4216b26340ce41d618c4/e445ae6b-8f90-4619-8c79-a1ee09552610.jpg

• quntool端接收消息的回调如下：
  

  javascripttypescripthtmlcssshellpythongolangjavacc++c#phprubyswiftkotlinscalarustdartelixirhaskellluaperlrsql

  {
    "msgId":"00cdea10-ad7c-4c19-b7d4-65815ce0e7af",
    "source":"28cca2a4c405",
    "userId":"apps-1",//光年账号id
    "wxid":"168885435526XXXX",//登录的企业微信id
    "timestamp":1686709131877,
    "type":"image_msg",//消息类型
    "data":
    {
      "appinfo":"6655054962426530162",
      "cdn":{
        "aes_key":"f4fc952536b0206aa21d382e1833c42f",
        "auth_key":
        "v1_40ce011f2f6fe517f543b5d7ae25fdd67189ab73ea0d1ff379b07cadd716ecc3f17254570244c03b61b579b7d7475c107c7a7d126d4e729eedb9c777a5caf89f",
        "file_name":"",
        "height":120,
        "ld_size":4148,
        "ld_url":"https://imunion.weixin.qq.com/cgi-bin/mmae-bin/tpdownloadmedia?param=v1_40ce011f2f6fe517f543b5d7ae25fdd67189ab73ea0d1ff379b07cadd716ecc3a9685f5db331124e64948a443d41beff1c3a1f62a8d0c4cec9bffdaf74d195a0bacc3f26566be46416b46ee5fb7eda9b3f6b583325610ea4fe14abfa988d4fda0f633f59c4028ba7518011ef3f22885ef4552b2240a73f4403263b35c9094523842e1463eca50bfa025a728e95c38c548623aee4639293fbd60ef7c5f728b3aecc9cc11ef78cfcadf25a7f5904b2b274b578adb62cdc5e71cbedbfcc8143d9a5a5079bc30364dc4d1d7104c70fca2b04853cc9b66146e504a53300bb862d4d50570f10f37a73e7bb4d8b9f38578feacf723252d040f22ff431e3997fdaaa34b1",
        "md5":"9537ed76b4731c211e863dac2c9cffb0",
        "md_size":149248,
        "md_url":"https://imunion.weixin.qq.com/cgi-bin/mmae-bin/tpdownloadmedia?param=v1_40ce011f2f6fe517f543b5d7ae25fdd67189ab73ea0d1ff379b07cadd716ecc3f8e713d5219cc4f6b82ec9712863d045bb9929145bb15c25ebee35156c125ed69b073f9c255515b28a7e4fbb0f2afae996a048ea7f035fae8c7304c780a34f81faef4ddb845ed56746db209144295be37d3d18bbfeb2df44b3e403403b0ddd57ed25f962b282e06ebed15e7a5c2aec63700e36435e8ed7587e71941bc6f5c0ff00a3e3d4cbdcd76e28c949c03716bdac83417b989ac21fe3eb37129e1c891812c1346225f13e0b76c2cc2b38e33866ddf317a69a6425daaf114ec224facac7f138ed8c6df9ab46b624ce2a2c0cbdb3bf3fd08447dbbe118577db1605ccff24fa",
        "size":149248,
        "url":"https://imunion.weixin.qq.com/cgi-bin/mmae-bin/tpdownloadmedia?param=v1_40ce011f2f6fe517f543b5d7ae25fdd67189ab73ea0d1ff379b07cadd716ecc3f8e713d5219cc4f6b82ec9712863d045bb9929145bb15c25ebee35156c125ed69b073f9c255515b28a7e4fbb0f2afae996a048ea7f035fae8c7304c780a34f81faef4ddb845ed56746db209144295be37d3d18bbfeb2df44b3e403403b0ddd57ed25f962b282e06ebed15e7a5c2aec63700e36435e8ed7587e71941bc6f5c0ff00a3e3d4cbdcd76e28c949c03716bdac83417b989ac21fe3eb37129e1c891812c1346225f13e0b76c2cc2b38e33866ddf317a69a6425daaf114ec224facac7f138ed8c6df9ab46b624ce2a2c0cbdb3bf3fd08447dbbe118577db1605ccff24fa",
        "width":89
      },
      "cdn_type":1,
      "content_type":101,
      "conversation_id":"S:168885435526XXXX_788130083907XXXX",//若是群聊则是R:群聊id
      "is_pc":0,
      "local_id":"1116",
      "receiver":"168885435526XXXX",//登录的企业微信id（接收消息方）
      "send_time":"1686709128",
      "sender":"788130083907XXXX",//客户的微信id（发送消息方）
      "sender_name":"左脚",//客户的微信昵称（发送消息方）
      "server_id":"1046994",//企业微信服务端消息id
      "imgWidth":1279,
      "imgHeight":1706,
      "file_path":
      "/gnapi/files/Cache/20230614/43aee759371c4216b26340ce41d618c4/e445ae6b-8f90-4619-8c79-a1ee09552610.jpg"//服务器图片相对路径
    },
      "sendMsgId":null
    }

  
  

• quntool端发出消息的回调如下：
  

  javascripttypescripthtmlcssshellpythongolangjavacc++c#phprubyswiftkotlinscalarustdartelixirhaskellluaperlrsql

  {
  "msgId":"b33417f3-7187-4fb1-993b-16aca04bf8dd",
  "source":"28cca2a4c405",
  "userId":"apps-1",//光年账号id
  "wxid":"168885435526XXXX",//登录的企业微信id
  "timestamp":1686709315597,
  "type":"image_msg",//消息类型
  "data":
        {
        "content_type":0,
        "conversation_id":"S:168885435526XXXX_788130083907XXXX",//若是群聊则是R:群聊id
        "is_pc":1,
        "receiver":"788130083907XXXX",//客户的微信id（接收消息方）
        "send_time":1686709315,
        "sender":"168885435526XXXX",//登录的企业微信id（发送消息方）
        "server_id":"1046999",//企业微信服务端消息id
        "file_path":
        "/gnapi/files/Storage/20230614/39855b938f6b54afee4697cc7e36f6aa/test1026.png",//服务器图片相对路径
        "imgWidth":200,
        "imgHeight":200,
        "cdn_type":0,
        "sendUserId":"apps-1",//光年账号id
        "sendUserName":"眠羊",//光年账号昵称
        "width":200,
        "height":200,
        "error_code":-1000999,//发送失败错误码，0表示发送成功
        "error_message":"Abnormal request frequency"//发送失败错误原因
        },
  "sendMsgId":"ed36b78b-e565-4cbe-bcc8-24b0b53241cd"
  }

  
  

视频消息

type为 video_msg

• quntool端接收消息的回调如下：
  

  javascripttypescripthtmlcssshellpythongolangjavacc++c#phprubyswiftkotlinscalarustdartelixirhaskellluaperlrsql

  {
    "msgId":"d1cc11ae-ee66-415e-aa3c-eea5d461135a",
    "source":"c0b764946118",
    "userId":"apps-1",//光年账号id
    "wxid":"168885435526XXXX",//登录的企业微信id
    "timestamp":1686724100774,
    "type":"video_msg",//消息类型
    "data":
    {
      "appinfo":"3131433406605729559",
      "cdn":{
        "aes_key":"1cf0aa5caafe41331897680c7e086058",
        "auth_key":
        "v1_40ce011f2f6fe517f543b5d7ae25fdd67189ab73ea0d1ff379b07cadd716ecc358f04aedda6838826986764b9c5276d2b059aadd8d1f4c9e4516395fd6d249e1",
        "file_name":"",
        "md5":"3b842926bdf06a9711c7e7dc38438368",
        "preview_img_size":2689,
        "preview_img_url":"https://imunion.weixin.qq.com/cgi-bin/mmae-bin/tpdownloadmedia?param=v1_40ce011f2f6fe517f543b5d7ae25fdd67189ab73ea0d1ff379b07cadd716ecc31057769457cf220231163801da407c859d6cfb1629a318111ab402ebe0edccdd0000d23a7bd278fd882d124c1a10dcb5843d3b45d9d4117c1b6381588969dfbae938e48f843144ec67e720ae4194c388f04f1a2caac88e08c798117265612fd6400c2713065c18e5c53533421fce96e015b70a65c19fa4079efaaefb1e05dec8a648c6a21b81c2592ad79fb35c6b3491c16a7f1ea9d1c2aaf1275d8261d7cdb5c96515fcc276716fbe1386625b7dac40740ab550c27876c6157d9e0dbdedcc401f569972349cc03fd1667ebc943b14f9500ddb418fa79f682ed782c026d05a161",
        "size":2051752,
        "url":"https://imunion.weixin.qq.com/cgi-bin/mmae-bin/tpdownloadmedia?param=v1_40ce011f2f6fe517f543b5d7ae25fdd67189ab73ea0d1ff379b07cadd716ecc3b3e90730a0481a2be958759200768cc59c33df59080a4a9f1d5d270191ad48cc30b1a416388e4793de91201d8b8243a1ecdb30305827548581fc73c0e130eb4c5e196a3d9d0effa7488765f750826214121ae5d62cd9b674c1a3b9978bb2d0956aaaa3f8d4c798dee9f010405bf846c3e4f57e67dfce198303b37495ae9bd1737650676d8c656af167186a164a9216953555d8867f48a7b08e6cc8987ebc962aee243e6f495892474ee51bcd3b1f27cc5b62158c347066511f456e025d0566321b932e772055dc99dcd6667279dc63910c4fcb868251e825f81ba57e051fffca"
      },
      "cdn_type":1,
      "content_type":103,
      "conversation_id":"S:168885435526XXXX_788130083907XXXX",//若是群聊则是R:群聊id
      "duration":29,//视频时长
      "height":0,
      "is_pc":0,
      "local_id":"1046",
      "receiver":"168885435526XXXX",//登录的企业微信id（接收消息方）
      "send_time":"1686724097",
      "sender":"788130083907XXXX",//客户的微信id（发送消息方）
      "sender_name":"左脚",//客户的微信昵称（发送消息方）
      "server_id":"1047044",//企业微信服务端消息id
      "width":0,
      "videoWidth":368,
      "videoHeight":640,
      "file_path":
      "/gnapi/files/Cache/20230614/e76f4818406b4313847b29d35e0c2ec1/448140b5-5f28-45ce-a7d2-ea04ba58b32b.mp4"//服务器图片相对路径
    },
    "sendMsgId":null
  }

  
  

• quntool端发出消息的回调如下：
  

  javascripttypescripthtmlcssshellpythongolangjavacc++c#phprubyswiftkotlinscalarustdartelixirhaskellluaperlrsql

  {
    "msgId":"2e4794f6-69e9-4af6-8669-05bdbc64a0dc",
    "source":"c0b764946118",
    "userId":"apps-1",//光年账号id
    "wxid":"168885435526XXXX",//登录的企业微信id
    "timestamp":1686723774583,
    "type":"video_msg",//消息类型
    "data":
    {
      "content_type":0,
      "conversation_id":"S:168885435526XXXX_788130083907XXXX",//若是群聊则是R:群聊id
      "is_pc":1,
      "receiver":"788130083907XXXX",//客户的微信id（接收消息方）
      "send_time":1686723774,
      "sender":"168885435526XXXX",//登录的企业微信id（发送消息方）
      "server_id":"1047042",//企业微信服务端消息id
      "file_path":"/gnapi/files/Storage/20230614/a14c1969b8ae605754fa655d512c2547/视频压缩后.mp4",//服务器图片相对路径
      "videoWidth":720,
      "videoHeight":1280,
      "cdn_type":0,
      "sendUserId":"apps-1",//光年账号id
      "sendUserName":"眠羊",//光年账号昵称
      "error_code":-1000999,//发送失败错误码，0表示发送成功
      "error_message":"Abnormal request frequency"//发送失败错误原因
    },
    "sendMsgId":"efe88c09-bdb4-4e25-9740-2d8de7a74b1e"
  }

  
  

语音消息

type为 voice_msg

• quntool端接收消息的回调如下：
  

  javascripttypescripthtmlcssshellpythongolangjavacc++c#phprubyswiftkotlinscalarustdartelixirhaskellluaperlrsql

  {
    "msgId":"01c0b166-4dfb-4239-bcf9-1765d7c45f92",
    "source":"28cca2a4c405",
    "userId":"apps-1",//光年账号id
    "wxid":"168885435526XXXX",//登录的企业微信id
    "timestamp":1686709999697,
    "type":"voice_msg",//消息类型
    "data":
    {
      "appinfo":"3232881452555685120",
      "cdn":{
        "aes_key":"7065676876747A786178757967757674",
        "file_id":
        "30818002010204793077020100020458e1a00602031e903802042ac6f46d0204648926ee044c313439313138313537345f37303635363736383736373437413738363137383735373936373735373637345f3261323862366436373031373665346564653633623466663430373036643331020100020214b004000201050201000400",
        "file_name":"",
        "md5":"2a28b6d670176e4ede63b4ff40706d31",
        "size":5282
      },
      "cdn_type":2,
      "content_type":16,
      "conversation_id":"S:168885435526XXXX_788130083907XXXX",//若是群聊则是R:群聊id
      "duration":3,//语音时长
      "is_pc":0,
      "local_id":"1118",
      "receiver":"168885435526XXXX",//登录的企业微信id（接收消息方）
      "send_time":"1686709997",
      "sender":"788130083907XXXX",//客户的微信id（发送消息方）
      "sender_name":"左脚",//客户的微信昵称（发送消息方）
      "server_id":"1047001",//企业微信服务端消息id
      "file_path":
      "/gnapi/files/Cache/20230614/d10147b54e2c40f6833b6cfef7843d26/07ec105e-31ed-4d88-9526-bde57ee95833.aac"//服务器图片相对路径
    },
    "sendMsgId":null
  }

  
  

• quntool端发出消息的回调如下：
  

  javascripttypescripthtmlcssshellpythongolangjavacc++c#phprubyswiftkotlinscalarustdartelixirhaskellluaperlrsql

  {
  "msgId":"757820de-f426-4644-bd00-9c073ddc7365",
  "source":"28cca2a4c405",
  "userId":"apps-1",//光年账号id
  "wxid":"168885435526XXXX",//登录的企业微信id
  "timestamp":1686710201713,
  "type":"voice_msg",//消息类型
  "data":
        {
        "content_type":0,
        "conversation_id":"S:168885435526XXXX_788130083907XXXX",//若是群聊则是R:群聊id
        "is_pc":1,
        "receiver":"788130083907XXXX",//客户的微信id（接收消息方）
        "send_time":1686710201,
        "sender":"168885435526XXXX",//登录的企业微信id（发送消息方）
        "server_id":"1047004",//企业微信服务端消息id
        "duration":4,//语音时长
        "file_path":
  "/gnapi/files/Storage/20230614/3e82185b4771597662c2532150d6522e/local_audio_1686710199.0.aac",//服务器图片相对路径
        "cdn_type":0,
        "sendUserId":"apps-1",//光年账号id
        "sendUserName":"眠羊",//光年账号昵称
        "error_code":-1000999,//发送失败错误码，0表示发送成功
        "error_message":"Abnormal request frequency"//发送失败错误原因
        },
  "sendMsgId":"2362ff74-0b26-4491-819a-784f716f0869"
  }

  
  

文件消息

type为 file_msg

• quntool端接收消息的回调如下：
  

  javascripttypescripthtmlcssshellpythongolangjavacc++c#phprubyswiftkotlinscalarustdartelixirhaskellluaperlrsql

  {
    "msgId":"b5e1b295-7b98-43fa-b9df-cff72b79eafb",
    "source":"28cca2a4c405",
    "userId":"apps-1",//光年账号id
    "wxid":"168885435526XXXX",//登录的企业微信id
    "timestamp":1686715302251,
    "type":"file_msg",//消息类型
    "data":
    {
      "appinfo":"3981951480332555928",
      "cdn":
      {
        "aes_key":"edef928c0f6c3cf25d788f46218f8ac8",
        "auth_key":
        "v1_40ce011f2f6fe517f543b5d7ae25fdd67189ab73ea0d1ff379b07cadd716ecc32d9cb999605c1613892e4b0be8ec733e7dc7ecfba10b86d784ef4879d8408e4a",
        "file_name":"Setup.log",
        "md5":"67717327f234ccdaf083b132e66341f3",
        "size":3375050,
        "url":
        "https://imunion.weixin.qq.com/cgi-bin/mmae-bin/tpdownloadmedia?param=v1_40ce011f2f6fe517f543b5d7ae25fdd67189ab73ea0d1ff379b07cadd716ecc3c5cae9f74fb14f4e5a4a833bb26174fc5fde347b9219ca90c236685a5665f7c872a1374e073a09b562596a5790b3fe598e66369939956de2ff0633769037b65df5e214e8505d6f5eb191489d57cd2b87172406acf7bb3761c63a9482bdf22fc80ea7bfa8f66c3f63e2a472ba6b7f60e4ddfc8bda3449b9b67721796d5e6dd37ef42199da1c06cf73bf8be619159cf117de88759260ed352796a793788d02b5711f641929040637ecd5830f6735e1a36b9aa0b784bd099986826382a4c383b3a7d07ee3807aea4fff7f753b2fa0e29548d754c6d92a325ab60a0187fbe3afa65a"
      },
      "cdn_type":1,
      "content_type":102,
      "conversation_id":"S:168885435526XXXX_788130083907XXXX",//若是群聊则是R:群聊id
      "is_pc":0,
      "local_id":"1123",
      "receiver":"168885435526XXXX",//登录的企业微信id（接收消息方）
      "send_time":"1686715299",
      "sender":"788130083907XXXX",//客户的微信id（发送消息方）
      "sender_name":"左脚",//客户的微信昵称（发送消息方）
      "server_id":"1047022",//企业微信服务端消息id
      "file_path":
      "/gnapi/files/Cache/20230614/047a42f078dc49429b1b10ab3d81566e/Setup.log",//服务器图片相对路径
      "file_size":3375050
    },
    "sendMsgId":null
  }

  
  

• quntool端发出消息的回调如下：
  

  javascripttypescripthtmlcssshellpythongolangjavacc++c#phprubyswiftkotlinscalarustdartelixirhaskellluaperlrsql

  {
    "msgId":"56354d83-47a3-4dd3-9c7f-93d63c69a3d3",
    "source":"c0b764946118",
    "userId":"apps-1",//光年账号id
    "wxid":"168885435526XXXX",//登录的企业微信id
    "timestamp":1686723241859,
    "type":"file_msg",//消息类型
    "data":
    {
      "content_type":0,
      "conversation_id":"S:168885435526XXXX_788130083907XXXX",//若是群聊则是R:群聊id
      "is_pc":1,
      "receiver":"788130083907XXXX",//客户的微信id（接收消息方）
      "send_time":1686723241,
      "sender":"168885435526XXXX",//登录的企业微信id（发送消息方）
      "server_id":"1047040",//企业微信服务端消息id
      "file_path":
      "/gnapi/files/Storage/20230614/c91a30553e0deb32214f24a5e32fded0/AItest.txt",//服务器图片相对路径
      "cdn_type":0,
      "cdn":
      {
        "aes_key":"65666266393962316265306639336538",
        "file_id":
        "3052020102044b304902010002040bec56c302030f42410204bf795875020464895aa9040d31363836373233323430393335020100020300d2800410c91a30553e0deb32214f24a5e32fded00201050201000400",
        "file_name":"AItest.txt",
        "ld_size":0,
        "md5":"c91a30553e0deb32214f24a5e32fded0",
        "md_size":0,
        "size":53886
      },
      "sendUserId":"apps-1",//光年账号id
      "sendUserName":"眠羊",//光年账号昵称
      "error_code":-1000999,//发送失败错误码，0表示发送成功
      "error_message":"Abnormal request frequency"//发送失败错误原因 
    },
    "sendMsgId":"884ff834-3cec-492b-a318-9b6371f58de8"
  }

  
  

位置消息

type为 location_msg

• quntool端接收消息的回调如下：
  

  javascripttypescripthtmlcssshellpythongolangjavacc++c#phprubyswiftkotlinscalarustdartelixirhaskellluaperlrsql

  {//此消息由微信用户发送
    "msgId":"0257e9c3-3569-4ab1-972c-71784f5c9af3",
    "source":"c0b764946118",
    "userId":"apps-1",//光年账号id
    "wxid":"168885435526xxxx",//登录的企业微信id
    "timestamp":1686732606756,
    "type":"location_msg",//消息类型
    "data":
    {
      "address":"浙江省杭州市西湖区余杭塘路866号",
      "appinfo":"1438640993989321696",
      "content_type":6,
      "conversation_id":"S:168885435526xxxx_788130083907xxxx",//若是群聊则是R:群聊id
      "is_pc":0,
      "latitude":30.30261,
      "local_id":"1055",
      "longitude":120.08213,
      "receiver":"168885435526xxxx",//登录的企业微信id（接收消息方）
      "send_time":"1686732604",
      "sender":"788130083907xxxx",//发送方（客户）的微信id
      "sender_name":"左脚",//发送方（客户）的微信昵称
      "server_id":"1047075",//企业微信服务端消息id
      "title":"浙江大学(紫金港校区)",
      "zoom":15
    },
    "sendMsgId":null
  }

  
  

链接卡片消息

type为 link_card_msg

• quntool端接收消息的回调如下：
  

  javascripttypescripthtmlcssshellpythongolangjavacc++c#phprubyswiftkotlinscalarustdartelixirhaskellluaperlrsql

  {
    "msgId":"6cb1f18b-fda9-4b85-be08-82983cc8835f",
    "source":"c0b764946118",
    "userId":"apps-1",//光年账户id
    "wxid":"168885435526XXXX",//登录的企业微信id
    "timestamp":1686724245564,
    "type":"link_card_msg",//消息类型
    "data":
    {
      "appinfo":"8893562549067337205",
      "cdn":
      {
        "aes_key":"7761616e6f766f61657876636f716578",
        "auth_key":
        "v1_40ce011f2f6fe517f543b5d7ae25fdd67189ab73ea0d1ff379b07cadd716ecc35d28542488c26a0f2a76974fd7974650db6be94197c8c56bed6c73f29810b14f",
        "size":84662,
        "url":
        "https://imunion.weixin.qq.com/cgi-bin/mmae-bin/tpdownloadmedia?param=v1_40ce011f2f6fe517f543b5d7ae25fdd67189ab73ea0d1ff379b07cadd716ecc3af39385ae55f442ba563b496f2ce55a2a93efd5d305130d4778a9b548f5b37fbc8c80e448d9fbacf804445004b3b5019dbc8a2387ec38d10937fd13d39bc2a19a3baa668f2f66655719958e2d913ad504739c21f9da431fac75c2c7840544e713810f4d2ac8c0e3e11bb51d9804732ed4520842cdde314ed91517338ae71d2608e29cfaf857735c8d57ec96df2c69a1c355977913277658dce270eb8fb3c4fd6b4c7e3f70ea757091cea4eb22ae78918f842cca167ed280c4bc13acededfa88898282ffefd76212bbb688ea038ed77b1"
      },
      "cdn_type":1,
      "content_type":13,
      "conversation_id":"S:168885435526XXXX_788130083907XXXX",//若是群聊则是R:群聊id
      "desc":"真正的流量增长专家！",
      "image_url":"",
      "is_pc":0,
      "local_id":"1048",
      "receiver":"168885435526XXXX",//登录的企业微信id（接收消息方）
      "send_time":"1686724243",
      "sender":"788130083907XXXX",//客户的微信id（发送消息方）
      "sender_name":"左脚",//客户的微信昵称（发送消息方）
      "server_id":"1047049",//企业微信服务端消息id
      "title":"光年实验室",
      "url":"https://www.gnlab.com"
    },
    "sendMsgId":null
  }

  
  

• quntool端发出消息的回调如下：
  

  javascripttypescripthtmlcssshellpythongolangjavacc++c#phprubyswiftkotlinscalarustdartelixirhaskellluaperlrsql

  {
    "msgId":"8dcce7fd-b8fd-43ad-8935-b7368ddbcbbc",
    "source":"c0b764946118",
    "userId":"apps-1",//光年账号id
    "wxid":"168885435526XXXX",//登录的企业微信id
    "timestamp":1686724196284,
    "type":"link_card_msg",//消息类型
    "data":
    {
      "desc":"真正的流量增长专家！",
      "image_url":     "http://software.gnlab.com/quntool/files/20221028/663eaa1e1cbd032f7ae6defed5a00720/0a9caa3fbfcf9186cad4a30c0eda0df.jpg",
      "title":"光年实验室",
      "url":"https://www.gnlab.com",
      "content_type":0,
      "conversation_id": "S:168885435526XXXX_788130083907XXXX",//若是群聊则是R:群聊id
      "is_pc":1,
      "receiver":"788130083907XXXX",//客户的微信id（接收消息方）
      "send_time":1686724196,
      "sender":"168885435526XXXX",//登录的企业微信id（发送消息方）
      "server_id":"1047047",//企业微信服务端消息id
      "sendUserId":"apps-1",//光年账号id
      "sendUserName":"眠羊",//光年账号昵称
      "isOpenApi":true,//若不是通过openAPI发送，就不会有这个字段
      "error_code":-1000999,//发送失败错误码，0表示发送成功
      "error_message":"Abnormal request frequency"//发送失败错误原因
    },
    "sendMsgId":"90fe74c0-7488-474a-892a-e2698ddc0191"
  }

  
  

表情消息

type为 emoticon_msg

• quntool端接收消息的回调如下：
  

  javascripttypescripthtmlcssshellpythongolangjavacc++c#phprubyswiftkotlinscalarustdartelixirhaskellluaperlrsql

  {
    "msgId":"6b17115d-8d01-47e2-b466-fa2c1f722e30",
    "source":"c0b764946118",
    "userId":"apps-1",//光年账号id
    "wxid":"168885435526XXXX",//登录的企业微信id
    "timestamp":1686731856310,
    "type":"emoticon_msg",//消息类型
    "data":
    {
      "appinfo":"7945599339216066811",
      "cdn":{
        "aes_key":"",
        "file_id":"",
        "md5":"ac39c925acba989e615653dfcbe04398",
        "size":0
      },
      "cdn_type":1,
      "content_type":29,
      "conversation_id":"S:168885435526XXXX_788130083907XXXX",//若是群聊则是R:群聊id
      "height":240,
      "is_pc":0,
      "local_id":"1054",
      "name":"动画表情",
      "receiver":"168885435526XXXX",//登录的企业微信id（接收消息方）
      "send_time":"1686731854",
      "sender":"788130083907XXXX",//客户的微信id（发送消息方）
      "sender_name":"左脚",//客人的微信昵称（发送消息方）
      "server_id":"1047072",//企业微信服务端消息id
      "source_type":101,
      "type":2,
      "url":
      "https://wework.qpic.cn/wwpic/wwwx_ac39c925acba989e615653dfcbe04398/0",
      "width":240
    },
    "sendMsgId":null
  }

  
  

• quntool端发出消息的回调如下：
  

  javascripttypescripthtmlcssshellpythongolangjavacc++c#phprubyswiftkotlinscalarustdartelixirhaskellluaperlrsql

  {
    "msgId":"9fd299a8-f72d-44dc-8094-40dcc30bd177",
    "source":"c0b764946118",
    "userId":"apps-1",//光年账号id
    "wxid":"168885435526XXXX",//登录的企业微信id
    "timestamp":1686731710625,
    "type":"emoticon_msg",//消息类型
    "data":
    {
      "content_type":0,
      "conversation_id":"S:168885435526XXXX_788130083907XXXX",//若是群聊则是R:群聊id
      "is_pc":1,
      "local_id":"0",
      "receiver":"788130083907XXXX",//客户的微信id（接收消息方）
      "send_time":"1686731710",
      "sender":"168885435526XXXX",//登录的企业微信id（发送消息方）
      "server_id":"1047070",//企业微信服务端消息id
      "url":"https://wework.qpic.cn/wwpic/wwwx_178ab4d7100d8cf51f736f55109b70a7/0",
      "width":240,
      "height":240,
      "error_code":-1000999,//发送失败错误码，0表示发送成功
      "error_message":"Abnormal request frequency"//发送失败错误原因
    },
    "sendMsgId":"1dc24cc9-c874-4097-bab7-aeea2790a680"
  }

  
  

红包消息

type为 red_packet_msg

• quntool端接收消息的回调如下：
  

  javascripttypescripthtmlcssshellpythongolangjavacc++c#phprubyswiftkotlinscalarustdartelixirhaskellluaperlrsql

  {//此消息由微信用户发送
    "msgId":"8c78eef0-0017-41b5-9c05-b9bbb2a014ba",
    "source":"c0b764946118",
    "userId":"apps-1",//光年的账号id
    "wxid":"168885435526XXXX",//登录的企业微信id
    "timestamp":1686732884811,
    "type":"red_packet_msg",//消息类型
    "data":
    {
      "appinfo":"hongbao_788130083907XXXX_1800008896202306147404849530015",
      "content_type":26,
      "conversation_id":"S:168885435526XXXX_788130083907XXXX",//若是群聊则是R:群聊id
      "desc":"来自左脚的红包，请进入手机版企业微信查看",
      "is_pc":0,
      "local_id":"1056",
      "money":1,
      "packet_id":"1800008896202306147404849530015",
      "receiver":"168885435526XXXX",//登录的企业微信id（接收消息方）
      "remark":"",
      "send_time":"1686732884",
      "sender":"788130083907XXXX",//发送方（客户）的微信id
      "sender_name":"左脚",//发送方（客户）的微信昵称
      "server_id":"1047078"//企业微信服务端消息id
    },
    "sendMsgId":null
  }

  
  

个人名片消息

type为 person_card_msg

• quntool端接收消息的回调如下：
  

  javascripttypescripthtmlcssshellpythongolangjavacc++c#phprubyswiftkotlinscalarustdartelixirhaskellluaperlrsql

  {
  "msgId":"ec38aece-07fb-4688-95aa-8f90c739dd34",
  "source":"6676423bf911",
  "userId":"apps-2",//光年账号id
  "wxid":"168885435526XXXX",//登录的企业微信id
  "timestamp":1686746944365,
  "type":"person_card_msg",//消息类型
  "data":{
         "appinfo":"7325909076836555726",
         "avatar"://名片好友的头像
  "http://wx.qlogo.cn/mmhead/Q3auHgzwzM5dmJtMIxtVPhHmw57Xfw2FvEfuBwon7RMOEYa2sSnEuA/0",
         "content_type":41,
         "conversation_id":"S:168885435526XXXX_788130083907XXXX",//若是群聊则是R:群聊id
         "corp_id":0,
         "corp_name":"微信",
         "is_pc":0,
         "local_id":"1062",
         "nickname":"峰哥",//名片好友的微信昵称
         "receiver":"168885435526XXXX",//登录的企业微信id（接收名片消息方）
         "send_time":"1686746942",
         "sender":"788130083907XXXX",//客户的微信id（发送名片消息方）
         "sender_name":"左脚",//客户的微信昵称（发送名片消息方）
         "server_id":"1047189",//企业微信服务端消息id
         "source":"微信",
         "user_id":"788130195497XXXX"//名片好友的微信id
         },
  "sendMsgId":null
  }

  
  

• quntool端发出消息的回调如下：
  

  javascripttypescripthtmlcssshellpythongolangjavacc++c#phprubyswiftkotlinscalarustdartelixirhaskellluaperlrsql

  {
    "msgId":"180d9180-3a65-448d-9c4d-518740b46c42",
    "source":"6676423bf911",
    "userId":"apps-2",//光年账号id
    "wxid":"168885435526XXXX",//登录的企业微信id
    "timestamp":1686746504905,
    "type":"person_card_msg",//消息类型
    "data":
    {
      "avatar"://名片好友的头像
      "http://wx.qlogo.cn/mmhead/Q3auHgzwzM7iacKVM6aze3F0SPkpLmibaxwff0CfE338L6PzpHoZ2rxw/0",
      "nickname":"C奕",//名片好友的微信昵称
      "user_id":"788130132420XXXX",//名片好友的微信id
      "content_type":0,
      "conversation_id":"S:168885435526XXXX_788130083907XXXX",//若是群聊则是R:群聊id
      "is_pc":1,
      "local_id":"0",
      "receiver":"788130083907XXXX",//接收名片消息方（客户）的微信id
      "send_time":"1686746504",
      "sender":"168885435526XXXX",//发送名片消息方（登录企业微信）的企业微信id
      "server_id":"1047184",//企业微信服务端消息id
      "sendUserId":"apps-2",//光年账号id
      "sendUserName":"小小",//光年账号昵称
      "isOpenApi":true,//若不是通过openAPI发送，就不会有这个字段
      "error_code":-1000999,//发送失败错误码，0表示发送成功
      "error_message":"Abnormal request frequency"//发送失败错误原因
    },
    "sendMsgId":"3e0a1e87-838d-4ec3-870f-3c685432edb5"
  }

  
  

小程序消息

type为 mini_program_msg

• quntool端接收消息的回调如下：
  

  javascripttypescripthtmlcssshellpythongolangjavacc++c#phprubyswiftkotlinscalarustdartelixirhaskellluaperlrsql

  {
    "msgId":"13d3f9b0-3e9d-4e49-87db-b2e0b32ced49",
    "source":"c0b764946118",
    "userId":"apps-1",//光年账号id
    "wxid":"168885435526XXXX",//登录的企业微信id
    "timestamp":1686724492202,
    "type":"mini_program_msg",//消息类型
    "data":{
      "appicon":
      "http://mmbiz.qpic.cn/mmbiz_png/SGiaydYUe1zLtdMgrAcV9eon11wLWiaKVXCc4or8hLUDDpFGJDON50hYbPOs3UKHnDTnkePKBsbkeSicHAwIxu2Qg/640?wx_fmt=png&wxfrom=200",
      "appid":"wx8f98d076d3459dd6",
      "appinfo":"6801064353112384757",
      "appname":"雪球 App",
      "cdn":
      {
        "aes_key":"63616478726B75686B73746D6E657A70",
        "file_id":
        "306a02010204633061020100020458e1a00602031e90380204e7df892b020464895f8b0435313439313138313537345f3532383035303834325f62303336633563303434626537343664376137376364383838666232643036300201000203013ba004000201010201000400",
        "size":80799
      },
      "cdn_type":2,
      "content_type":78,
      "conversation_id":"S:168885435526XXXX_788130083907XXXX",//若是群聊则是R:群聊id
      "is_pc":0,
      "local_id":"1050",
      "page_path":"pages/fundIndex/public.html?sourceFrom=share",
      "receiver":"168885435526XXXX",//登录的企业微信id（接收消息方）
      "send_time":"1686724489",
      "sender":"788130083907XXXX",//客户的微信id（发送消息方）
      "sender_name":"左脚",//客户的微信昵称（发送消息方）
      "server_id":"1047057",//企业微信服务端消息id
      "thumb_height":504,
      "thumb_width":630,
      "title":"Hi 聪明的投资者，点击查看小雪今天为你精挑细选的基金内容",
      "username":"gh_7a080f2e543d@app",//小程序账号原始ID
      "cover_path":
      "/gnapi/files/Cache/20230614/4c9553c3046842a9a27307c02ebf771b/4fef8b63-1463-4a0d-a2de-6a75bbe1ec90.png"
    },
    "sendMsgId":null
  }

  
  

• quntool端发出消息的回调如下：
  

  javascripttypescripthtmlcssshellpythongolangjavacc++c#phprubyswiftkotlinscalarustdartelixirhaskellluaperlrsql

  {
    "msgId":"7eec1bb2-7bf5-41b6-b5c1-d897313345d3",
    "source":"c0b764946118",
    "userId":"apps-1",//光年账号id
    "wxid":"168885435526XXXX",//登录的企业微信id
    "timestamp":1686724403033,
    "type":"mini_program_msg",//消息类型
    "data":
    {
      "content_type":0,
      "conversation_id":"S:168885435526XXXX_788130083907XXXX",//若是群聊则是R:群聊id
      "is_pc":1,
      "receiver":"788130083907XXXX",//客户的微信id（接收消息方）
      "send_time":1686724402,
      "sender":"168885435526XXXX",//登录的企业微信id（发送消息方）
      "server_id":"1047054",//企业微信服务端消息id
      "appicon":      "http://mmbiz.qpic.cn/mmbiz_png/SGiaydYUe1zLtdMgrAcV9eon11wLWiaKVXCc4or8hLUDDpFGJDON50hYbPOs3UKHnDTnkePKBsbkeSicHAwIxu2Qg/640?wx_fmt=png&wxfrom=200",
      "appid":"wx8f98d076d3459dd6",
      "appname":"雪球基金",
      "page_path":"pages/fundIndex/public.html?sourceFrom=share",
      "title":"Hi 聪明的投资者，点击查看小雪今天为你精挑细选的基金内容",
      "username":"gh_7a080f2e543d@app",//小程序账号原始ID
      "cover_path":"/gnapi/files/Storage/20230612/c76f3023d5534b91b2d809501b926f7c/6019ab5a-af91-430f-9e92-03f84cb1f84a.png",
      "cdn_type":0,
      "sendUserId":"apps-1",//光年账号id
      "sendUserName":"眠羊",//光年账号昵称
      "error_code":-1000999,//发送失败错误码，0表示发送成功
      "error_message":"Abnormal request frequency"//发送失败错误原因
    },
    "sendMsgId":"52e840a3-7376-44c1-8d70-019af2c2fd91"
  }

  
  

视频号消息

type为 video_num_msg

• quntool端接收消息的回调如下：
  

  javascripttypescripthtmlcssshellpythongolangjavacc++c#phprubyswiftkotlinscalarustdartelixirhaskellluaperlrsql

  {
    "msgId":"8f888f04-24e0-4fb3-8f23-3b26acaf29fd",
    "source":"c0b764946118",
    "userId":"apps-1",//光年账号id
    "wxid":"168885435526XXXX",//登录的企业微信id
    "timestamp":1686731274251,
    "type":"video_num_msg",//消息类型
    "data":
    {
      "appinfo":"1729041739997290048",
      "avatar":
      "http://wx.qlogo.cn/finderhead/ver_1/MWlx8P1sq5RWaFRw0U5ZNC9bQNiarzMoa1GlC4LZm8PkYxhnHaVEl67ph9Hib8ibQ0X6DgoicjnD785L7GpC0Vj7Eqdovia2wKCTl7TrrtqAlkLE/0",
      "content_type":141,
      "conversation_id":"S:168885435526XXXX_788130083907XXXX",//若是群聊则是R:群聊id
      "cover_url":
      "/gnapi/files/Cache/20230614/d3188abfe3494227ba5941674b5375b6/38684061-b380-40a3-9f47-25245d355b79",
      "desc":
      "三个男生在食堂吃饭的时候说猫拉屎太臭，隔壁桌女生一盘烤鸭饭盖头上，你怎么看？#不文明行为 #大学校园\n",   
      "extras":
      "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",
      "feed_type":4,
      "is_pc":0,
      "local_id":"1052",
      "nickname":"民生频道",//视频号博主的账号昵称
      "object_id":"14149299402708355092",
      "object_nonce_id":"14419861684357443117_0_0_0_0_0",
      "receiver":"168885435526XXXX",//登录的企业微信id（接收消息方）
      "send_time":"1686731271",
      "sender":"788130083907XXXX",//客户的微信id（发送消息方）
      "sender_name":"左脚",//客户的微信昵称（发送消息方）
      "server_id":"1047067",//企业微信服务端消息id
      "thumb_url":
      "http://wxapp.tc.qq.com/251/20304/stodownload?encfilekey=rjD5jyTuFrIpZ2ibE8T7YmwgiahniaXswqzhVUZ7gvVz0gtzrbEWZSHVb4mwrTL8icEic5icpDjDFJxZ0b4nnibmlfJJuLVePeJtA3GfsJus2IN5XUokRVRWLLlAQ&bizid=1023&dotrans=0&hy=SH&idx=1&m=&scene=0&token=x5Y29zUxcibCojS6Q4K8RhX4AG0ibhk0ma2jHDmIfJs8bQRyZvDWSNuZ7ibm1yicaaUuJTl1rP0siaWc&finder_expire_time=1687336072&finder_eid=export%2FUzFfAgtgekIEAQAAAAAAC8wCjV7dzwAAAAstQy6ubaLX4KHWvLEZgBPEwKMgRmJ2QMuHzNPgMILdmSSrRvHB3zTAfUJAF0Cb",
      "url":
      "https://channels.weixin.qq.com/web/pages/feed?eid=export%2FUzFfAgtgekIEAQAAAAAAC8wCjV7dzwAAAAstQy6ubaLX4KHWvLEZgBPEwKMgRmJ2QMuHzNPgMILdmSSrRvHB3zTAfUJAF0Cb"
    },
      "sendMsgId":null
    }

  
  

• quntool端发出消息的回调如下：
  

  javascripttypescripthtmlcssshellpythongolangjavacc++c#phprubyswiftkotlinscalarustdartelixirhaskellluaperlrsql

  {
    "msgId":"35819d5c-4913-4fa0-9466-3a508dd968bb",
    "source":"c0b764946118",
    "userId":"apps-1",//光年账号id
    "wxid":"168885435526XXXX",//登录的企业微信id
    "timestamp":1686724715559,
    "type":"video_num_msg",//消息类型
    "data":
    {
      "content_type":0,
      "conversation_id":"S:168885435526XXXX_788130083907XXXX",//若是群聊则是R:群聊id
      "is_pc":1,
      "receiver":"788130083907XXXX",//客户的微信id（接收消息方）
      "send_time":1686724715,
      "sender":"168885435526XXXX",//登录的企业微信id（发送消息方）
      "server_id":"1047060",//企业微信服务端消息id
      "cover_url":
      "http://wxapp.tc.qq.com/251/20304/stodownload?encfilekey=rjD5jyTuFrIpZ2ibE8T7YmwgiahniaXswqzCgcgMgZB0jHoROIofx1xpKTuKzP0diaYhbibt4b0FNbbXncLXX9EJsic1azZMp5FehtXDWlvdjNqCTzBu40jfFAvg&bizid=1023&dotrans=0&hy=SH&idx=1&m=&scene=0&token=x5Y29zUxcibAUsQC4VxOxdOMNfxcHkpUa0qW9edVvDribjDibzzeZlmrJxLRIp7T6ibuTPWa1MN2SVY&finder_expire_time=1684979674&finder_eid=export%2FUzFfAgtgekIEAQAAAAAANnUhyfVVbAAAAAstQy6ubaLX4KHWvLEZgBPE26NAdxBQfu-HzNPgMIKNzt_6bZd-mnaV_qwM7Kh0",
      "desc":"生于1992年，刘芳秀被查，参加工作不到9年，半年前刚刚履新",
      "feed_type":4,
      "nickname":"白鹭洲知政",//视频号博主的账号昵称
      "thumb_url":
      "http://wxapp.tc.qq.com/251/20304/stodownload?encfilekey=rjD5jyTuFrIpZ2ibE8T7YmwgiahniaXswqzCgcgMgZB0jHoROIofx1xpKTuKzP0diaYhbibt4b0FNbbXncLXX9EJsic1azZMp5FehtXDWlvdjNqCTzBu40jfFAvg&bizid=1023&dotrans=0&hy=SH&idx=1&m=&scene=0&token=x5Y29zUxcibAUsQC4VxOxdOMNfxcHkpUa0qW9edVvDribjDibzzeZlmrJxLRIp7T6ibuTPWa1MN2SVY&finder_expire_time=1684979674&finder_eid=export%2FUzFfAgtgekIEAQAAAAAANnUhyfVVbAAAAAstQy6ubaLX4KHWvLEZgBPE26NAdxBQfu-HzNPgMIKNzt_6bZd-mnaV_qwM7Kh0",
      "url":
      "https://channels.weixin.qq.com/web/pages/feed?eid=export%2FUzFfAgtgekIEAQAAAAAANnUhyfVVbAAAAAstQy6ubaLX4KHWvLEZgBPE26NAdxBQfu-HzNPgMIKNzt_6bZd-mnaV_qwM7Kh0",
      "extras":
      "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","avatar":"http://wx.qlogo.cn/finderhead/ver_1/DleFWMGHW8JD69j5r5icATCYHibROSKPSTWVJhomDGTWu3YniaEyOaP81Nl1iaN2SafCs31AprQQQeVibFmOM1T75o1EVlK9O3EPjTP4kW9qNiajQ/0",
      "sendUserId":"apps-1",//光年账号id
      "sendUserName":"眠羊",//光年账号昵称
      "error_code":-1000999,//发送失败错误码，0表示发送成功
      "error_message":"Abnormal request frequency"//发送失败错误原因
    },
      "sendMsgId":"8a5b70ea-130b-4c9f-9c2e-ec5f22801d6c"
    }

  
  

有新的联系人被添加

💡有个别情况添加好友时不会有此回调：
1、客户没开启联系人验证时添加好友，
2、客户已经是企微的好友，但是企微不是客户的好友，此时添加好友，这些情况如果业务上需要处理，可以通过灰色字体消息进行判断

type为 notify_type_contact_add

{
  "msgId":"a5ff6553-0312-41ec-beca-45a529cc31a4",
  "source":"19c302e842b7",
  "userId":"apps-2",
  "wxid":"168885435526XXXX",
  "timestamp":1686810153601,
  "type":"notify_type_contact_add",
  "data":
  {
    "acctid":"",
    "avatar":
    "http://wx.qlogo.cn/mmhead/Q3auHgzwzM6XL416LZxSicbiaL1DSbBt5ppAPFAsDiaz9OMKYcKZB0ia5A/0",
    "conversation_id":"S:168885435526XXXX_788130083907XXXX",
    "corp_id":"1970325134026788",//（注意）这个是微信公司自己的corp_id（因为好友是微信用户，因此这个字段就是返回微信自己的）
    "mobile":"",
    "nickname":"",
    "position":"",
    "realname":"",
    "remark":"",
    "sex":1,
    "unionid":"ozynqsoD1_oPAqiZn-aPxONW----",
    "user_id":"788130083907XXXX",////微信好友的微信id
    "username":"左脚"//微信好友的昵称
  },
  "sendMsgId":null
}

群成员新增通知

type为 notify_type_room_add_member

{
  "msgId":"c74d3c89-5d09-4f46-bfad-d52b9d2a8d6f",
  "source":"387c543b0c2e",
  "userId":"apps-18776",
  "wxid":"168885040790XXXX",
  "timestamp":1686643115608,
  "type":"notify_type_room_add_member",
  "data":
  {
    "member_list":
    [{"name":"卡卡","user_id":"788130083019XXXX"}],
    "op_user_id":"168885040790XXXX",
    "op_user_name":"XF",
    "room_conversation_id":"R:1089670317297XXXX",
    "room_name":"XF、卡卡、峰哥"
  },
  "sendMsgId":null
}

移除群成员通知

type为 notify_type_room_del_member

{
  "msgId":"50374fdf-1bb5-4a2b-9c81-cd5bb0100b39",
  "source":"387c543b0c2e",
  "userId":"apps-18776",
  "wxid":"168885040790XXXX",
  "timestamp":1686643128643,
  "type":"notify_type_room_del_member",
  "data":
  {
    "member_list":
    [{"name":"卡卡","user_id":"788130083019XXXX"}],
    "op_user_id":"168885040790XXXX",
    "op_user_name":"XF",
    "room_conversation_id":"R:1089670317297XXXX",
    "room_name":"XF、峰哥"
  },
  "sendMsgId":null
}

新群通知

type为 notify_type_room_create

{
  "msgId":"aa1d3f19-1724-43ab-98ad-7b7929bff8e0",
  "source":"28cca2a4c405",
  "userId":"apps-1",
  "wxid":"168885435526XXXX",
  "timestamp":1686639336084,
  "type":"notify_type_room_create",
  "data":
  {
    "member_list":[
      {"name":"依然","user_id":"788130125713XXXX"},
      {"name":"左脚","user_id":"788130083907XXXX"}
    ],
    "op_user_id":"168885435526XXXX",
    "op_user_name":"YG",
    "room_conversation_id":"R:1084994280507XXXX",
    "room_name":"YG、左脚、依然"
  },
  "sendMsgId":null
}

群成员主动退群通知

type为 notify_type_room_member_quit

{
  "msgId":"e3580af1-0e3b-42c5-8826-7bfe501ca6a9",
  "source":"28cca2a4c405",
  "userId":"apps-1",
  "wxid":"168885435526XXXX",
  "timestamp":1686642402411,
  "type":"notify_type_room_member_quit",
  "data":
  {
    "op_user_id":"168885040790XXXX",
    "op_user_name":"XF",
    "room_conversation_id":"R:1089075089950XXXX",
    "room_name":"ASBG"
  },
  "sendMsgId":null
}

修改群名称通知

type 为 room_name_changed

{
  "msgId":"c324524c-0ea1-4963-8c5a-decf74fe17c6",
  "source":"6f2d8092bc47",
  "userId":"apps-2",
  "wxid":"168885435526XXXX",
  "timestamp":1688985033339,
  "type":"room_name_changed",
  "data":
  {
    "op_user_id":"168885435526XXXX",
    "room_conversation_id":"R:1070054722539XXXX",
    "room_name":"井上拟声"//修改后的群名称
  },
  "sendMsgId":null
}

灰色字体消息

type 为 chat_gray_msg

💡 聊天消息中的灰色字体消息(如，被好友删除）

{
  "msgId":"34a5b393-572e-49a6-a6af-6e49f73315d3",
  "source":"19c302e842b7",
  "userId":"apps-2",
  "wxid":"168885435526XXXX",
  "timestamp":1686801776923,
  "type":"chat_gray_msg",
  "data":
  {
    "appinfo":"CAUQo5ABGOLw4emLMSAC_need_verify",
    "content":"左脚开启了联系人验证，你还不是他（她）的联系人。请先发送联系人验证请求，对方验证通过后，才能聊天。 发送联系人验证",
    "content_type":1011,
    "conversation_id":"S:168885435526XXXX_788130083907XXXX",
    "is_pc":0,
    "receiver":"788130083907XXXX",
    "send_time":"1686801776",
    "sender":"168885435526XXXX",
    "sender_name":"",
    "server_id":"1047330"
  },
  "sendMsgId":null
}

企微登录回调

type 为 user_login

{
  "msgId":"5d37ca1c-e09c-45f0-9d22-1549d15ef402",
  "source":"c0b764946118",
  "userId":"apps-1",
  "wxid":"168885435526XXXX",
  "timestamp":1686725141632,
  "type":"user_login",
  "data":{
    "account":"yG@gnlab.com",
    "acctid":"yG",
    "avatar":"https://wework.qpic.cn/wwpic/875997_ZDuwMIeVQreLNqd_1685519387/0",
    "corp_id":"197032505708XXXX",
    "document_root":
    "C:\\Users\\ContainerAdministrator\\Documents\\WXWork\\168885435526XXXX",
    "email":"",
    "job_name":"",
    "mobile":"1825825XXXX",
    "nickname":"",
    "pid":36632,
    "position":"",
    "sex":1,
    "user_id":"168885435526XXXX",
    "username":"YNG"
  },
  "sendMsgId":null
}

企微离线回调

type 为 user_offline

💡当企业微信账号注销、用户在其他地方登录、异常退出时将收到此回调

{
  "msgId":"28280d90-95fc-4292-8869-754a0b0111cf",
  "source":"c0b764946118",
  "userId":"apps-1",
  "wxid":"168885435526XXXX",
  "timestamp":1686725114075,
  "type":"user_offline",
  "data":null,
  "sendMsgId":null
}

群发确认消息

type 为 batch_msg_confirm

💡收到群发确认消息后可以调用群发确认接口进行自动确认

{
  "msgId":"34a5b393-572e-49a6-a6af-6e49f73315d3",
  "source":"19c302e842b7",
  "userId":"apps-2",
  "wxid":"168885435526XXXX",
  "timestamp":1686801776923,
  "type":"batch_msg_confirm",
  "data":
  {
    "appinfo": "KHGSC_1688850407900545_110739833202391153_n",
    "content": "{\"main_title\":{\"title\":\"谢xx通知你群发消息给客户\"},\"button_list\":[{\"title\":\"发送\",\"interaction\":{\"type\":1002,\"url\":\"https://work.weixin.qq.com/wework_admin/common/uploadWework\",\"schema_desc\":{\"pc_schema_url\":\"wxwork://jump?target=jump_to_tool&toolid=10167007&msg_id=110739833202391153&send_type=0&conversation_type=0&isAllowSelect=0&refreshData=1\",\"mobile_schema_url\":\"wxwork://jump?target=jump_to_tool&toolid=10167007&msg_id=110739833202391153&send_type=0&conversation_type=0&isAllowSelect=0&refreshData=1\",\"min_version_mac\":\"4.0.12\",\"min_version_ios\":\"4.0.12\"}},\"is_link\":true,\"style\":33555256}],\"button_column\":1,\"card_action\":{\"type\":1002,\"url\":\"https://work.weixin.qq.com/wework_admin/common/uploadWework\",\"schema_desc\":{\"pc_schema_url\":\"wxwork://jump?target=jump_to_tool&toolid=10167006&msg_id=110739833202391153&send_type=0&send_customer_cnt=2&conversation_type=0&refreshData=1\",\"mobile_schema_url\":\"wxwork://jump?target=jump_to_tool&toolid=10167006&msg_id=110739833202391153&send_type=0&send_customer_cnt=2&conversation_type=0&refreshData=1\",\"min_version_mac\":\"4.0.12\",\"min_version_ios\":\"4.0.12\"}},\"quote_message\":{\"quote_list\":[\"你好\"]},\"data_refresh_action\":{\"refresh_interval\":3,\"data\":\"Chdncm91cF9zZW5kX2NhcmRfcmVmcmVzaBIVCPHwjqSqqdvEARCBi5GFgoCAAxgA\",\"cmd_id\":6238}}",
    "sendtime": 1689755757,
    "title": "谢XX通知你群发消息给客户"
  },
  "sendMsgId":null
}

接口调用

💡主动调用的API的地址统一为：http://{{聚合聊天访问地址}}/gnapi/open/{{path}}，接口请求参数不区分大小写，注意路径中一定要有/open（太容易漏掉了）

登录

输入登录验证码

💡只有当回调消息类型qrcode_status_msg中data.status为10时才会用到此接口

• POST /container/verify

请求例示：

{
 "hostname":"12341241"//来自回调消息类型qrcode_status_msg中source字段
 "key":"6E16C7042D0A4E832114E839EB1694CE",//来自回调消息类型qrcode_status_msg中data.qrcode_key字段
 "code":"386317"//从手机企业微信官方app上获取，示例图如下
}

返回例示：

{
 "data":{
         "errcode":0,//若`errcode`小于0，就是用户输入有错 ，就需要重新输入正确验证码
         "errmsg":"ok"
        },
"code":0
  }

登录企业微信

💡此接口会创建一个全新的企微登录环境，如果是下线后重新登录，请使用/container/start接口

• POST /container/create

请求例示：

{
  "userId": "apps-1"//通过获取流量超市账号列表接口获取
}

返回例示：

{
  "msg": "",
  "code": 0,
  "data": {
    "qrcode": "/gnapi/files/20220812/8bdbdd6087f0463db0494704f719bc47/88046e97-fef5-4db1-8804-7bd8dbb53658.jpg",
    "hostname": "62a1263f977c",
    "version": "1.3.0.13",
    "createtime": "2022-08-12 15:56:14",
    "wxPid": 57264
  }

下线企业微信

💡下线后会释放企微所占用的内存及CPU资源占用，但不会删除硬盘上的企微缓存文件，下线后可以通过上线接口重新登录，不需要重新扫码

• POST /container/stop

请求例示：

{
  "hostname": ["23fewerf23d"]
}

返回例示：

{
  "msg": "",
  "code": 0,
  "data": null
}

上线企业微信

💡用于上线登出状态的企业微信

• POST /container/start

请求例示：

{
  "hostname": ["23fewerf23d"]
}

返回例示：

{
  "msg": "",
  "code": 0,
  "data": null
}

登出企业微信

💡登出会释放企微所占用的内存及CPU资源占用，且会删除硬盘上的企微缓存文件，需要重新扫码登录

• POST /container/remove

请求例示：

{
  "hostname": ["23fewerf23d"]
}

返回例示：

{
  "msg": "",
  "code": 0,
  "data": null
}

重启企业微信

💡重启后会释放企微所占用的内存及CPU资源占用

• POST /container/restart

请求例示：

{
  "hostname": ["23fewerf23d"]
}

返回例示：

{
  "msg": "",
  "code": 0,
  "data": null
}

获取企业微信列表

• GET /inner/user/wx/list
  

  请求参数：
  - userId string quntool里登录的用户的id，用于筛选
  - IsOnline bool 是否在线，默认为true，当传false时会返回系统中所有的企微，包括在线，离线和登出等状态
  - HostName array 用于筛选

返回参数：
- Status int [0:在线] [1:离线] [2:登出] [3:正在登录] [4:登录失败，请重新扫码] [5:登录失败，请联系光年技术支持]
- QrCode string status为4时返回，用于重新扫码登录，通过此二维码登录，可以重用企微缓存文件，避免重新扫码登录时出现无法获取到个别很久没聊天的群列表等问题

返回例示：

{
  "msg": "",
  "code": 0,
  "data": [
    {
      "hostname": "PC-20200805GOPM",   
      "wxId": "1688850407900545",
      "userId": "internal-6",
      "username": "xxx",
      "nickname": "",
      "avatar": "http://wework.qpic.cn/bizmail/fON3uGHibKLBoWGmHTtDZ1icIJiboib76VRSLrQQo7f3Nm2dSqvS7q3zXA/0",
      "corp_id": "1970325057080574",
      "corp_name": "",
      "mobile": "18222222222",
      "position": "",
      "corp_short_name": "光年实验室",
      "job_name": "",
      "account": "",
      "acctid": "XiedaFeng"   //该企业微信的userid，与通过企业微信开放API获取的相同。
      "Status": 0,
      "QrCode":null
    }
  ]
}

联系人

获取外部联系人列表

• GET /contact/external/list
  

  请求参数：
  - wxId string 企业微信id

返回例示：

 {
   "code": 0,
   "msg": "",
   "data": [
     {
       "avatar": "http://wx.qlogo.cn/mmhead/Q3auHgzwzM4QzCpELF16JuPpMBAD3rhcqyAuhfJAKx7OKN73tib7e1g/0",
       "conversation_id": "S:16888888888_16888888888",
       "corp_id": "111",
       "nickname": "",//只有企业微信用户才有的，别名
       "position": "",
       "realname": "",//只有企业微信用户才有的，实名认证的名字
       "remark": "",//自己给好友备注的名字
       "sex": 1,
       "user_id": "168888",//微信用户78开头、企业微信用户16开头
       "username": "xxx",//微信用户的微信昵称、or企业微信用户的姓名
       "external_user_id":"",
       "is_delete": true, // 是否删除了此联系人或被联系人删除
       "delete_time": "2024-01-08 13:51:22", // 联系人删除的时间，未删除或不确定时间时为 null。
     }
   ]
 }

获取外部联系人的扩展信息

• GET /contact/extendinfo
  

  请求参数：
  - wxId string 企业微信id
  - ContactId string 客户id

返回例示：

{
  "msg": "",
  "code": 0,
  "data": {
    "corp_remark": "",//公司名称
    "desc": "哈哈",  //描述
    "phone_list": [  //手机号列表
      "235"
    ],
    "remark": "",
    "status": 1,
    "user_id": "788130083019XXXX"
  }
}

获取内部联系人列表

• GET /contact/inner/list
  

  请求参数：
  - wxId string 企业微信id

返回例示：

{
  "msg": "",
  "code": 0,
  "data": [
    {
      "avatar": "https://wework.qpic.cn/wwhead/duc2TvpEgSTPk74IwG7BsibtM6hc3nmj8e8o5Chc9G1kTYLBenKs6icmVlsLelFAsBJLyo0mIzPxY/0",
      "conversation_id": "S:16888888888_16888888888",
      "corp_id": "111",
      "nickname": "xxx",
      "position": "",
      "realname": "xxx",
      "remark": "",
      "sex": 2,
      "user_id": "16888888888",
      "username": "xxx"
    },
    {
      "avatar": "http://wework.qpic.cn/wwhead/duc2TvpEgSTPk74IwG7BszEC1NNLbZ0ht1icA9ewbZJJsA5jKsOuxT5uyjs8Mia6SibGJRCmdp01nQ/0",
      "conversation_id": "S:16888888888_16888888888",
      "corp_id": "111",
      "nickname": "xxx",
      "position": "",
      "realname": "xxx",
      "remark": "",
      "sex": 2,
      "user_id": "16888888888",
      "username": "xxx"
    }
  ]
}
}

修改内/外部联系人的备注

• PUT /contact/remark

请求例示：

{
  "wxId": "168888",
  "contactId": "1688800000000",
  "remark": "备注"
}

返回例示：

{
  "msg": "",
  "code": 0,
  "data": null
}

修改内/外部联系人的描述

• PUT /contact/desc

请求例示：

{
  "wxId": "168888",
  "contactId": "1688800000000",
  "desc": "描述"
}

返回例示：

{
  "msg": "",
  "code": 0,
  "data": null
}

修改内/外部联系人的电话

• PUT /contact/phone

请求例示：

{
  "wxId": "168888",
  "contactId": "1688800000000",
  "phones": ["18268181111","18268182222"]
}

返回例示：

{
  "msg": "",
  "code": 0,
  "data": null
}

删除好友

• POST /contact/remove

请求例示：

{
  "wxId": "168888",
  "ContactUserId": "788xxxxxxxxx"
}

返回例示：

{
  "msg": "",
  "code": 0,
  "data": null
}

查询客户

• POST /contact/external/query

请求例示：

{
    "ContactInfos": [
        {
            "WxId": "{{WxId}}",
            "ContactUserId": "{{ContactUserId}}"
        }
    ]
}

返回例示：

{
    "msg": "",
    "code": 0,
    "data": [
        {
            "avatar": "http://wx.qlogo.cn/mmhead/Q3auHgzwzM7GCgXgwoEBzQLkqugbbIphRgAPXBXIdNZN221AYMia6wA/0",
            "conversation_id": "S:1688850407900545_7881300830190773",
            "corp_id": "1970325134026788",
            "nickname": "",
            "position": "",
            "realname": "",
            "remark": "测试",
            "sex": 2,
            "user_id": "7881300830190773",
            "username": "卡卡",
            "external_user_id": null,
            "is_delete": false,
            "delete_time": "2023-08-09 18:41:57"
        }
    ]
}

消息

💡企微官方对发送消息有频率限制，批量发送消息时需要控制好发送频率，否则消息会发送失败
- 每个企微发送消息间隔控制在500ms
- 每个企业一小时内所有企微发送消息数总和控制在50000条

发送文字消息

• POST /msg/text
  

  请求参数：
  - wxId string 企业微信id
  - conversationId string 接收者的会话ID，个人会话以S:开头，由企业微信id和接收人拼接而成，id小的排在前面，群聊会话以R:开头
  - content string 发送内容

请求例示：

{
  "wxId":"168885435526XXXX",
  "conversationId":"S:168885435526XXXX_788130083907XXXX",
  "content":"你真的是又美又仙啊"
}

返回例示：

{
  "msg": "",
  "code": 0,
  "data": {
    "msgId": "ed1ba6c2-bbe1-4ec9-acd9-019533bb5b93"
  }
}

发送群@消息

• POST /msg/roomAt
  

  💡只支持文本消息哦~

请求参数：
- wxId string 企业微信id
- conversationId string 群聊会话id
- content string 发送的内容
- atList array 用户id列表

请求例示：

{
  "wxId": "16885343",
  "conversationId": "R:11111111111",
  "content": "你好，世界",//若指定位置@某人，如："你好，世界{$@}、{$@}" 实际输出结果：你好，世界@微信昵称（168877的）、@微信昵称（168866的）
  "atList": ["168877xxxxxx", "168866xxxxxx]//@所有人传["0"]
}

返回例示：

{
  "msg": "",
  "code": 0,
  "data": {
    "msgId": "98f10652-001d-4a37-9b7a-c610c082eac5"
  }

发送图片消息

• POST /msg/image
  

  请求参数：
  - fileUrl string 要发送的图片地址，可直接传http开头的地址或通过文件上传接口获取
  - wxId string 企业微信id
  - conversationId string 接收者的会话ID，个人会话以S:开头，由企业微信id和接收人拼接而成，id小的排在前面，群聊会话以R:开头

请求例示：

{
  "fileUrl":"http://software.gnlab.com/quntool/files/20221028/663eaa1e1cbd032f7ae6defed5a00720/0a9caa3fbfcf9186cad4a30c0eda0df.jpg",
  "wxId":"168885435526XXXX",
  "conversationId":"S:168885435526XXXX_788130083907XXXX"
}

返回例示：

{
  "msg": "",
  "code": 0,
  "data": {
    "msgId": "d45a7b3b-5b93-4f83-b3e4-ec77acfbb091"
  }
}

发送文件消息

• POST /msg/file
  

  请求参数：
  - fileUrl string 要发送的文件地址，可直接传http开头的地址或通过文件上传接口获取
  - wxId string 企业微信id
  - conversationId string 接收者的会话ID，个人会话以S:开头，由企业微信id和接收人拼接而成，id小的排在前面，群聊会话以R:开头

请求例示：

{
  "fileUrl":"http://software.gnlab.com/quntool/files/20221028/663eaa1e1cbd032f7ae6defed5a00720/0a9caa3fbfcf9186cad4a30c0eda0df.csv",
  "wxId":"168885435526XXXX",
  "conversationId":"S:168885435526XXXX_788130083907XXXX"
}

返回例示：