wechat work push

Laravel-Admin message push plug-in by enterprise WeChat application message

No official account required, no need to install enterprise WeChat client, low-cost push message solution

There is also Dcat-Admin version

Preface

Inspired by Server sauce, here is just a simple implementation.

statement

• At present, it seems that receiving new messages in WeChat is no longer supported and the calling interface requires an IP whitelist. It seems that messages can only be received in the enterprise WeChat APP. There are many restrictions, unless it is an old application (applied very early and has set up relevant settings) Otherwise, the experience of this message channel will become worse.

Client support

• Laravel version https://github.com/asundust/push-laravel

Function introduction

The current version supports flexible settings

• Supports input of title, content, link, and link title
• Messages from an [Enterprise WeChat Application] can be pushed to [single account/all personnel])
• [Single account/all personnel] can set up independent [Enterprise WeChat Application] configuration

in addition

• The current version does not support content text markdown and other formats. It only supports simple text and will be developed later.
• The current version does not have a log function and will be developed later.

screenshot

• You can see the message content directly in the notification

Install

Install

 composer require asundust/wechat-work-push

Configuration file

 'wechat-work-push' => [
    'enable' => true,
    // 'config_table' => 'wechat_work_push_configs', // 自定义配置表表名，可不填写，默认wechat_work_push_configs
    // 'user_table' => 'wechat_work_push_users', // 自定义用户表表名，可不填写，默认wechat_work_push_users
    // 'middleware' => 'web', // 自定义中间件组，可不填写，默认web
],

migrate

 php artisan migrate

publish menu

 php artisan admin:import wechat-work-push

The following menu will be generated

• Enterprise WeChat message push
• └User configuration
• └Default configuration

Configuration

General process

• Register a business on Enterprise WeChat (no business certification required)
• Create an internal application
• Configuration related configuration
• Enable WeChat plug-in
• Received a message on WeChat

Application process

• Apply for corporate WeChat https://work.weixin.qq.com/

• After successful registration, click [Manage Enterprise] to enter the management interface, select [Application Management] - [Self-Build] - [Create Application].

• Think of an application name by yourself, upload a picture logo by yourself, and select the company name for the visible range.

• After creation, copy [AgentId] and [Secret] and go to [Enterprise WeChat Application Message] - [Default Configuration] in the background of the website to fill in the corresponding column.

• Enter the [My Business] page, scroll to the bottom, you can see the business ID, copy and fill it in the corresponding column, remember to save.

• If it is a user-defined enterprise, remember to edit the user to fill in the corresponding three columns.

• You can send test messages in the list. If Enterprise WeChat receives the message, it will be successful.

• Enter [My Business] - [WeChat Plug-in], scroll down to scan the QR code, and follow it to receive push messages (you may need to download Enterprise WeChat and bind WeChat first). At this time, Enterprise WeChat and WeChat should messages can be received at the same time.

Set the enterprise WeChat to not receive messages and WeChat to receive messages.

[Enterprise WeChat APP]-[Three horizontal lines in the upper left corner]-[Gear settings in the lower right corner]-[New message notification]-[Only receive messages in Enterprise WeChat]-[App Message] Close

If there are multiple corporate identities, [Enterprise WeChat APP]-[Three horizontal lines in the upper left corner]-[Gear settings in the lower right corner]-[New message notification]-[Other corporate message reminders]-Select the company name you applied for and change it to [ Only receive special reminder messages] or [No reminder] - and then switch back to your commonly used corporate messages.

Then send the test notification, there should be no problem.

The tutorial on setting up message notifications here is wrong. If you have any questions, please contact me.

If you encounter problems, you can send a test message to the application you just created (select [Application Management]-[Self-Build]-[Application Name]-[Function]-[Send Message]).

In addition, if the interface request is normal, the corporate WeChat receives the message normally, but the personal WeChat cannot receive the message.

PC backend management terminal: Go to [My Business] - [WeChat Plug-in], scroll to the bottom, and check [Allow members to receive and reply to chat messages in the WeChat plug-in]

Also check the above-mentioned [Only receive messages in corporate WeChat] related settings

use

• The default route supports get and post . Remember to add push/* in except in VerifyCsrfToken to support post interface requests.

• The interface address is http://{www.abc.com}/push/{推送密钥} , the title is not required to be empty, the content is content does not need to be passed, the link is url is not required to be passed, and the link title is url_title but is not required to be passed. Example: The get address is http://{www.abc.com}/push/我是密钥?title=测试标题&content=测试内容&url=https://www.baidu.com&url_title=我是百度的测试链接

• Passing in an illegal url may cause the sending request to time out. For unknown reasons, it is recommended to test it yourself.

Internal call support

• Reference this Trait class AsundustWechatWorkPushHttpTraitsWechatWorkPushSendMessageTrait .
• Use the default configuration to send defaultSend() , and use the custom configuration to send send() . Please refer to the method for details.

future

• New packages will be developed to support messaging across multiple channels

support

If you think this project has saved you time, you might as well support it!

License

The MIT License (MIT)