Laravel-Admin 消息推送插件 by 企业微信应用消息

Без необходимости в публичном аккаунте, без установки корпоративного клиента WeChat, решение для отправки сообщений с низкими затратами.

Также есть версия Dcat-Admin (https://github.com/asundust/dcat-wechat-work-push).

Введение

Вдохновение от Server酱, это простая реализация.

Заявление

— В настоящее время плагин, похоже, больше не поддерживает получение новых сообщений в WeChat и вызов интерфейса требует IP-белого списка. Он может работать только с приложением корпоративного WeChat. Ограничения очень велики, если только это не старое приложение (заявка была подана давно и уже установлены соответствующие настройки), в противном случае опыт использования этого канала сообщений будет ухудшаться.

Поддержка клиентов

— Версия Laravel: https://github.com/asundust/push-laravel.

Описание функций

Текущая версия поддерживает гибкую настройку:

• Поддержка параметров заголовка, содержимого, ссылки и заголовка ссылки.
• Возможность отправлять сообщения одному пользователю или всем пользователям корпоративного приложения WeChat.
• Отдельные конфигурации для одного пользователя или всех пользователей корпоративного приложения WeChat.

Кроме того:

• Текущая версия не поддерживает форматированный текст, такой как Markdown, только простой текст. Поддержка форматированного текста запланирована на будущее.
• В текущей версии нет функции ведения журнала, она запланирована на будущее.

Скриншоты

Можно напрямую увидеть содержимое сообщения в уведомлении.

Установка

1. Установка:

composer require asundust/wechat-work-push

2. Конфигурационный файл:

'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
],

3. Миграция:

php artisan migrate

4. Меню публикации:

php artisan admin:import wechat-work-push

Будет создано следующее меню:

— Корпоративное сообщение WeChat; — └ Конфигурация пользователя; — └ Базовая конфигурация.

Конфигурация

Общий процесс:

1. Зарегистрировать корпорацию WeChat (без корпоративной сертификации).
2. Создать внутреннее приложение.
3. Настроить соответствующую конфигурацию.
4. Включить плагин WeChat.
5. Получать сообщения в WeChat.

Процесс подачи заявки:

— Подать заявку на корпоративный WeChat: https://work.weixin.qq.com/.

— После успешной регистрации перейдите в «Управление корпорацией» и выберите «[Управление приложениями] — [Самостоятельно созданные] — [Создать приложение]».

— Введите название приложения, загрузите логотип и выберите область видимости как название компании.

— Создайте приложение и скопируйте AgentId и Secret, чтобы перейти к «Корпоративные сообщения WeChat» — «Базовая конфигурация», чтобы заполнить соответствующие поля.

— Перейдите на страницу «Мой корпоративный профиль» и прокрутите вниз до конца, вы увидите корпоративный ID. Скопируйте его и заполните соответствующее поле. Не забудьте сохранить.

Если это пользовательское корпоративное приложение, не забудьте отредактировать пользователя и заполнить три соответствующих поля.

На странице списка можно отправить тестовое сообщение. Если сообщение получено корпоративным WeChat, то оно успешно отправлено.

Перейдите на страницу «Моя корпорация» — «[Плагин WeChat]», прокрутите вниз и отсканируйте QR-код. После подписки вы сможете получать сообщения. Возможно, потребуется сначала загрузить корпоративный клиент WeChat для привязки к WeChat. В это время корпоративный WeChat и WeChat должны иметь возможность получать сообщения одновременно.

Настройка корпоративного WeChat не позволяет получать сообщения, а WeChat может их получать.

«Корпоративный WeChat APP» — «Левая верхняя строка» — «Правая нижняя настройка» — «Новое уведомление о сообщении» — «Получать сообщения только в корпоративном WeChat» — «Сообщение приложения». Закройте.

Если у вас несколько корпоративных удостоверений личности, «Корпоративный WeChat APP» — «Верхняя левая строка» — «Нижняя правая настройка» — «Новые уведомления о сообщениях» — «Уведомления о других корпоративных сообщениях» — выберите имя корпорации, для которой было подано заявление, и измените его на «Получайте только важные уведомления» или «Не получайте уведомления», а затем переключитесь обратно на обычное корпоративное уведомление.

Затем отправьте тестовое уведомление, проблем быть не должно.

В этом руководстве по настройке уведомлений есть ошибки, пожалуйста, свяжитесь со мной, если у вас возникнут проблемы.

Если вы столкнулись с проблемой, вы можете отправить тестовое уведомление в только что созданное приложение («Управление приложениями» — «Самостоятельно созданные» — «Название приложения» — «Функции» — «Отправить сообщение»).

Также, если возникает проблема с интерфейсом запроса в норме, корпоративный WeChat получает сообщение в норме, но личный WeChat не может получить сообщение, выполните следующие действия:

ПК, панель управления: «Моя компания» — «[Плагин WeChat]» — прокрутите вниз, установите флажок «Разрешить членам группы получать и отвечать на сообщения чата в плагине WeChat».

Также проверьте вышеуказанную настройку «Получать сообщения только в корпоративном WeChat».

Использование

По умолчанию поддерживаются маршруты get и post. Не забудьте добавить исключение «push/*» в VerifyCsrfToken, чтобы разрешить запросы post.

Адрес интерфейса — http://{www.abc.com}/push/{ключ отправки}, заголовок — title, не может быть пустым, содержимое — content, может не передаваться, ссылка — url, может не передаваться, заголовок ссылки — url_title, может не передаваться. Пример: get

адрес — http://{www.abc.com}/push/я ключ?title=тестовый заголовок&content=тестовое содержимое&url=https://www.baidu.com&url_title=я являюсь тестовой ссылкой baidu.

Передача недопустимой ссылки может привести к тайм-ауту запроса, причина неизвестна, рекомендуется провести собственное тестирование.

Внутренняя поддержка вызовов:

— Ссылка на этот класс Trait \Asundust\WechatWorkPush\Http\Traits\WechatWorkPushSendMessageTrait. — Используйте конфигурацию по умолчанию для отправки defaultSend(), используйте настраиваемую конфигурацию для отправки send(), конкретные параметры см. в методе.

Поддержка внутренних вызовов:

— Если вы считаете, что этот проект помог вам сэкономить время, рассмотрите возможность поддержки!

[Изображение Alipay] Лицензия

The MIT License (MIT) https://opensource.org/licenses/MIT