跳转至

应用群聊消息推送

应用群聊消息推送是基于应用(app)创建的群聊实现应用在群聊中的消息推送,目前,其推送的消息只能在企业微信中查看,不会在个人微信中展示。应用群聊消息推送的好处有几点:

  1. 最少2个人即可建立群聊,企业微信(微信)默认都需要三人以上才能建立群聊,建立群聊后还可以添加群聊机器人(webhook)
  2. 应用推送的消息在群聊中展示,而不是单个应用交互的方式,每个人与应用的交互在群聊中展示(大家都看得到)
  3. 相比群聊机器人更丰富的消息推送形式(支持除任务卡片和小程序消息以外的所有应用消息推送)

推送接口演示

如果你已经掌握了应用消息推送,那么你只需要在原来推送消息的基础上添加一个参数chatid(群聊id)即可发送对应消息到群聊,在推送消息之前,需要先创建一个群聊。

⚠️请先确保加入群聊的用户都在应用的可见范围之内!!!

群聊创建

from corpwechatbot import AppMsgSender

app = AppMsgSender()
res = app.create_chat(users=['zhangsan', 'lisi'], owner='zhangsan', name="test", chatid="123", show_chat=True)
print(res)

⚠️注意此时在企业微信中还是看不到群聊的,但群聊已经创建了,需要发送一条消息,让群聊显示出来,请务必保存好返回得到的chatid,这是后面消息推送的主要参数

😏 v0.6.2以后在创建群聊的时候可以指定show_chat参数(默认为True),表示是否在群聊创建后发送一条消息到创建的群聊,让其在会话列表中显示出来,消息会包含群聊的id信息

消息推送

from corpwechatbot import AppMsgSender

app = AppMsgSender()
app.send_text("hello world", chatid="123") 
将应用消息发送到群聊中非常简便,只需要在原来应用消息推送的基础上,添加一个chatid即可。

其他消息的推送同理,需要注意的一点是更多的可传入参数touser,toparty,totag在群聊中不可用,safe参数可用,更多内容和支持的消息类型参考官方文档