云真机

API接口文档


极速群发消息给多个客户或客户群

<h5>简要描述</h5> <ul> <li>&lt;font color=&quot;red&quot;&gt;一次批量发送给客户或客户群,群数量一次最多200个(发消息的企微号需要是群主),客户不限。消息结构中只能有1条文本消息并放在第1条,消息总数不超过9条;其它类型的消息, 只支持 图片、视频、文件、小程序、链接、视频号。具体不同类型消息结构和字段参见“&lt;a href=&quot;<a href="https://www.showdoc.com.cn/qybopen/7990161805486320&quot;&gt;说明-聊天消息&lt;/a&gt;”)&lt;/font&gt">https://www.showdoc.com.cn/qybopen/7990161805486320&quot;&gt;说明-聊天消息&lt;/a&gt;”)&lt;/font&gt</a>;</li> <li>&lt;font color=&quot;red&quot;&gt;该功能发送的消息,官方限制,每天每客户仅能收到一次。&lt;/font&gt;</li> </ul> <h5>请求URL</h5> <ul> <li><code>https://oapi-yzj.miaokol.com/wechat/rapidSendMessage</code></li> </ul> <h5>请求方式</h5> <ul> <li>POST </li> </ul> <h5>请求参数</h5> <ul> <li>数据为json字符串,各字段说明如下</li> </ul> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">app_id</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>APP ID</td> </tr> <tr> <td style="text-align: left;">access_token</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>Access Token</td> </tr> <tr> <td style="text-align: left;">wxid</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>企微号wxid</td> </tr> <tr> <td style="text-align: left;">to_contact_wxids</td> <td style="text-align: left;">是</td> <td style="text-align: left;">array</td> <td>客户wxid,示例:[&quot;xxxxx&quot;,&quot;xxxxx&quot;] 或空[],&lt;font color=&quot;red&quot;&gt;to_contact_wxids和to_room_wxids字段,不要同时都传值,否则会只发客户&lt;/font&gt;</td> </tr> <tr> <td style="text-align: left;">to_room_wxids</td> <td style="text-align: left;">是</td> <td style="text-align: left;">array</td> <td>客户群wxid,示例:[&quot;R:xxxxx&quot;,&quot;R:xxxxx&quot;]或空[] ,&lt;font color=&quot;red&quot;&gt;to_contact_wxids和to_room_wxids字段,不要同时都传值,否则会只发客户&lt;/font&gt;</td> </tr> <tr> <td style="text-align: left;">messages</td> <td style="text-align: left;">是</td> <td style="text-align: left;">array</td> <td>消息数组,具体消息格式参见“&lt;a href=&quot;<a href="https://www.showdoc.com.cn/qybopen/7990161805486320&quot;&gt;说明-聊天消息&lt;/a&gt;”章节">https://www.showdoc.com.cn/qybopen/7990161805486320&quot;&gt;说明-聊天消息&lt;/a&gt;”章节</a></td> </tr> <tr> <td style="text-align: left;">delayed_time</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>消息发送时间戳(默认0,需要实现消息间隔时可用该字段,指定某条消息的发送时间,取值如:1641280299,表示该条消息于2022-01-04 15:11:39发送)</td> </tr> </tbody> </table> <h5>请求示例</h5> <pre><code>POST /wechat/sendMessage HTTP/1.1 Host:oapi-yzj.miaokol.com Content-Type: application/json; charset=UTF-8 { &amp;quot;app_id&amp;quot;: &amp;quot;xxx&amp;quot;, &amp;quot;access_token&amp;quot;: &amp;quot;xxx&amp;quot;, &amp;quot;wxid&amp;quot;: &amp;quot;xxx&amp;quot;, &amp;quot;to_contact_wxids&amp;quot;: [&amp;quot;xxx&amp;quot;,&amp;quot;xxx&amp;quot;],//to_contact_wxids和to_room_wxids字段,不要同时都传值,否则会只发客户 &amp;quot;to_room_wxids&amp;quot;: [],//to_contact_wxids和to_room_wxids字段,不要同时都传值,否则会只发客户 &amp;quot;delayed_time&amp;quot;:1641280299, &amp;quot;messages&amp;quot;: [//数组,下面仅为说明发送消息的字段、格式。 { &amp;quot;msg_type&amp;quot;: &amp;quot;text&amp;quot;,//文本,type类型说明,参见参见“说明-聊天消息”部分 &amp;quot;content&amp;quot;: { &amp;quot;items&amp;quot;: [ { &amp;quot;type&amp;quot;: &amp;quot;text&amp;quot;, &amp;quot;text&amp;quot;: &amp;quot;test&amp;quot; } ] } }, { &amp;quot;msg_type&amp;quot;: &amp;quot;picture&amp;quot;,//图片 &amp;quot;content&amp;quot;: { &amp;quot;url&amp;quot;: &amp;quot;xxxxxxxxx&amp;quot; } }, { &amp;quot;msg_type&amp;quot;: &amp;quot;link&amp;quot;,//链接 &amp;quot;content&amp;quot;: { &amp;quot;cover&amp;quot;: &amp;quot;xx&amp;quot;, &amp;quot;desc&amp;quot;: &amp;quot;xxx&amp;quot;, &amp;quot;title&amp;quot;: &amp;quot;xx&amp;quot;, &amp;quot;url&amp;quot;: &amp;quot;xxxx&amp;quot; } }, { &amp;quot;msg_type&amp;quot;: &amp;quot;file&amp;quot;,//文件 &amp;quot;content&amp;quot;: { &amp;quot;title&amp;quot;: &amp;quot;xx&amp;quot;, &amp;quot;url&amp;quot;: &amp;quot;xxxx&amp;quot; } } ] } </code></pre> <h5>响应示例</h5> <pre><code>HTTP/1.1 200 OK Content-Type: application/json; charset=UTF-8 {errcode&amp;quot;:0} </code></pre>

页面列表

ITEM_HTML