mirror of
https://github.com/crmeb/CRMEB.git
synced 2026-10-28 13:31:04 +00:00
80 lines
2.6 KiB
PHP
80 lines
2.6 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\bot\Bot;
|
||
use crmeb\services\notice\AbstractNoticeChannel;
|
||
use crmeb\services\notice\NoticeMessage;
|
||
|
||
/**
|
||
* 钉钉机器人消息渠道
|
||
*
|
||
* 调用 crmeb\services\bot\Bot 驱动发送 markdown 消息（app 可调 crmeb，合法）。
|
||
* Webhook 地址来自 eb_notice_template.extra.webhook 字段。
|
||
*/
|
||
class DingTalkChannel extends AbstractNoticeChannel
|
||
{
|
||
public static function channelKey(): string
|
||
{
|
||
return 'is_dingtalk';
|
||
}
|
||
|
||
public static function channelName(): string
|
||
{
|
||
return '钉钉';
|
||
}
|
||
|
||
/**
|
||
* 本渠道额外配置字段：Webhook 地址
|
||
* @return array
|
||
*/
|
||
public static function getExtraFields(): array
|
||
{
|
||
return ['webhook' => ''];
|
||
}
|
||
|
||
/**
|
||
* 仅支持平台端消息：群机器人只能发到钉钉群，无法向具体用户发消息
|
||
* @return array
|
||
*/
|
||
public static function getSupportScope(): array
|
||
{
|
||
return ['support_user' => 0, 'support_platform' => 1];
|
||
}
|
||
|
||
/**
|
||
* 发送钉钉机器人消息
|
||
*
|
||
* @param NoticeMessage $message 待投递消息（此渠道为平台通知，uid 固定为 0）
|
||
* @throws NoticeSendException webhook 未配置、模板内容为空或机器人返回失败
|
||
*/
|
||
public function send(NoticeMessage $message): void
|
||
{
|
||
// webhook 来自该通知在该渠道的 extra 配置
|
||
$webhook = (string)($message->extra['webhook'] ?? '');
|
||
if ($webhook === '') {
|
||
throw new NoticeSendException('钉钉 webhook 未配置');
|
||
}
|
||
if ($message->content === '') {
|
||
throw new NoticeSendException('钉钉模板内容为空');
|
||
}
|
||
|
||
// 模板变量替换
|
||
$title = $this->renderPlaceholders($message->title !== '' ? $message->title : '系统通知', $message->variables);
|
||
$content = $this->renderPlaceholders($message->content, $message->variables);
|
||
|
||
if (!Bot::sendMarkdown('ding_talk', $webhook, $title, $content)) {
|
||
throw new NoticeSendException('钉钉机器人返回发送失败');
|
||
}
|
||
}
|
||
}
|