应用群聊消息推送¶
应用群聊消息推送是基于应用(app)创建的群聊实现应用在群聊中的消息推送,目前,其推送的消息只能在企业微信中查看,不会在个人微信中展示。应用群聊消息推送的好处有几点:
- 最少2个人即可建立群聊,企业微信(微信)默认都需要三人以上才能建立群聊,建立群聊后还可以添加群聊机器人(webhook)
- 应用推送的消息在群聊中展示,而不是单个应用交互的方式,每个人与应用的交互在群聊中展示(大家都看得到)
- 相比群聊机器人更丰富的消息推送形式(支持除任务卡片和小程序消息以外的所有应用消息推送)
推送接口演示¶
如果你已经掌握了应用消息推送,那么你只需要在原来推送消息的基础上添加一个参数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
参数可用,更多内容和支持的消息类型参考官方文档