企业微信群机器人_Laravel

企业微信群机器人通知的 laravel扩展

安装

配置

修改配置文件

• 在生成的config/workwechatrobot.php配置文件中结合env添加机器人配置，每个机器人项支持配置多个，所以env文件配置num数要和key数量对应

• 最简配置 .env 文件

• 每个key消息频率20次每分钟，消息量大的话尽量多配制几个，防止消息遗漏
• 支持自定义机器人项，现有 default和 other 两项，可根据自己业务自由加项，切换机器人使用with($robot)切换

  使用

切换机器人

1、Text文本

1.1、text文本添加@某人

1.1.1 mentioned模式

• 在 config/workwechatrobot的配置文件的响应的机器人子项（默认default）配置
  • notify_user_ids支持用户id，企业内唯一，可通过企业微信管理后台-通讯录查看，一般为姓名拼音大驼峰，如张三：ZhangSan,多个成员用,隔开
  • notify_mobiles支持手机号，多个用,隔开
• 调用atUserId方法或者atMobiles 与配置文件不冲突会合并
• 调用 mentionedAtUserIds和 mentionedAtMobile方法必须在text方法之后，send方法之前

1.1.2 contentAt模式

• text文本支持<@userid> 语法，不支持手机号，

2. markdown类型

2.1 获取markdown消息实例

2.2 消息内容

2.2.1 无格式的直接调用

2.2.2 内容的特殊格式

2.3 发送消息

2.4 markdown支持contentAt语法，不支持手机号

3 图片消息

3.1 处理图片转base64，

3.2 文件md5

3.3 发送

4 news消息

4.1 添加一条图文消息

4.2 发送

5 文件类型

5.1 文件上传

- 文件素材需要提前上传，上传得到media_id,media_id三天有效
- media_id在同一企业内应用之间可以共享

5.2 文件上传接口

请求方式：POST（HTTPS）
请求地址：https://qyapi.weixin.qq.com/cgi-bin/webhook/upload_media?key=KEY&type=TYPE

使用multipart/form-data POST上传文件， 文件标识名为”media”
参数说明：

参数  必须  说明
key 是   调用接口凭证, 机器人webhookurl中的key参数
type    是   固定传file
POST的请求包中，form-data中媒体文件标识，应包含有 filename、filelength、content-type等信息

filename标识文件展示的名称。比如，使用该media_id发消息时，展示的文件名由该字段控制

• 要求文件大小在5B~20M之间

6 参考文档

企业微信群机器人配置说明

You can contribute in one of three ways:

1. File bug reports using the issue tracker.
2. Answer questions or fix bugs on the issue tracker.
3. Contribute new features or update the wiki.

The code contribution process is not very formal. You just need to make sure that you follow the PSR-0, PSR-1, and PSR-2 coding guidelines. Any new code contributions must be accompanied by unit tests where applicable.

License

MIT