mirror of
https://github.com/crmeb/CRMEB.git
synced 2026-10-28 13:31:04 +00:00
96 lines
3.2 KiB
PHP
96 lines
3.2 KiB
PHP
<?php
|
||
// +----------------------------------------------------------------------
|
||
// | CRMEB [ CRMEB赋能开发者，助力企业发展 ]
|
||
// +----------------------------------------------------------------------
|
||
// | Copyright (c) 2016~2026 https://www.crmeb.com All rights reserved.
|
||
// +----------------------------------------------------------------------
|
||
// | Author: CRMEB Team <admin@crmeb.com>
|
||
// +----------------------------------------------------------------------
|
||
declare(strict_types=1);
|
||
|
||
namespace app\services\message\channel;
|
||
|
||
use crmeb\exceptions\NoticeSendException;
|
||
use crmeb\services\notice\AbstractNoticeChannel;
|
||
use crmeb\services\notice\NoticeMessage;
|
||
use crmeb\utils\Http;
|
||
|
||
/**
|
||
* 企业微信群机器人消息渠道
|
||
*
|
||
* 调用 crmeb\utils\Http 向机器人 webhook 发送 markdown 消息（app 可调 crmeb，合法）。
|
||
* Webhook 地址来自 eb_notice_template.extra.url 字段。
|
||
*/
|
||
class EntWechatChannel extends AbstractNoticeChannel
|
||
{
|
||
public static function channelKey(): string
|
||
{
|
||
return 'is_ent_wechat';
|
||
}
|
||
|
||
public static function channelName(): string
|
||
{
|
||
return '企业微信群机器人';
|
||
}
|
||
|
||
/**
|
||
* 本渠道额外配置字段：机器人 Webhook URL
|
||
* @return array
|
||
*/
|
||
public static function getExtraFields(): array
|
||
{
|
||
return ['url' => ''];
|
||
}
|
||
|
||
/**
|
||
* 仅支持平台端消息：群机器人只能发到企业微信群，无法向具体用户发消息
|
||
* @return array
|
||
*/
|
||
public static function getSupportScope(): array
|
||
{
|
||
return ['support_user' => 0, 'support_platform' => 1];
|
||
}
|
||
|
||
/**
|
||
* @param bool|string $response 企业微信 HTTP 响应
|
||
* @return bool
|
||
*/
|
||
public static function responseSucceeded($response): bool
|
||
{
|
||
if (!is_string($response)) return false;
|
||
$result = json_decode($response, true);
|
||
return is_array($result) && (($result['errcode'] ?? -1) === 0 || ($result['code'] ?? -1) === 0);
|
||
}
|
||
|
||
/**
|
||
* 发送企业微信群机器人消息
|
||
*
|
||
* @param NoticeMessage $message 待投递消息（此渠道为平台通知，uid 固定为 0）
|
||
* @throws NoticeSendException webhook 未配置、模板内容为空或机器人响应失败
|
||
*/
|
||
public function send(NoticeMessage $message): void
|
||
{
|
||
$url = (string)($message->extra['url'] ?? '');
|
||
if ($url === '') {
|
||
throw new NoticeSendException('企业微信机器人 webhook 未配置');
|
||
}
|
||
if ($message->content === '') {
|
||
throw new NoticeSendException('企业微信模板内容为空');
|
||
}
|
||
|
||
// 替换模板变量后转企业微信 markdown 格式（引用块）
|
||
$content = $this->renderPlaceholders($message->content, $message->variables);
|
||
$content = str_replace('\n', "\n>", $content);
|
||
$content = "> {$content}";
|
||
|
||
$response = Http::postRequest($url, json_encode([
|
||
'msgtype' => 'markdown',
|
||
'markdown' => ['content' => $content],
|
||
], JSON_UNESCAPED_UNICODE));
|
||
|
||
if (!self::responseSucceeded($response)) {
|
||
throw new NoticeSendException('企业微信机器人响应失败：' . (is_string($response) ? $response : '空响应'));
|
||
}
|
||
}
|
||
}
|