如何高效地将应用通知推送到MicrosoftTeams？使用SymfonyNotifier轻松搞定！

可以通过一下地址学习composer：学习地址

在快节奏的软件开发和运营环境中，团队协作的效率至关重要。想象一下这样的场景：你的 ci/cd 管道完成了新的部署，或者生产环境突然出现了一个关键错误，亦或是即将召开一个重要的项目会议。这些信息都需要第一时间传达给相关的团队成员。

我们遇到的困境

起初，我们尝试过各种传统的通知方式：

1. 邮件通知： 邮件虽然正式，但往往会被淹没在大量的收件箱中，即时性差，不适合需要立即响应的场景。
2. 手动通知： 每次事件发生后，都由人工复制粘贴信息到 Microsoft Teams 频道，这不仅耗时，而且在高峰期容易遗漏或出错。
3. 简单短信/即时消息： 虽然即时，但信息量有限，无法承载复杂的结构化数据，更别提需要用户进行交互操作的场景了。

特别是当我们需要发送的通知不仅仅是纯文本，而是包含标题、不同部分、关键事实，甚至需要团队成员直接在通知中进行确认或填写简单信息时，上述方法就显得力不从心了。我们急需一个能够将应用事件自动化、结构化、甚至可交互地推送到 Microsoft Teams 的解决方案。

Composer 登场：

symfony/microsoft-teams-notifier

就在我们为如何高效地实现这一目标而苦恼时，我们发现了

symfony/microsoft-teams-notifier

它不仅能发送简单的文本消息，更强大的是，它支持 Microsoft Teams 的 MessageCard 格式，允许我们构建视觉丰富、结构清晰，甚至带有交互按钮的通知卡片，极大地提升了信息传递的效率和团队的响应速度。

如何使用 Composer 引入和配置

首先，使用 Composer 安装这个库非常简单：

composer require symfony/microsoft-teams-notifier

安装完成后，你需要配置一个 DSN (Data Source Name) 来告诉 Symfony Notifier 如何连接到你的 Microsoft Teams Webhook。这个 DSN 通常会在你的

.env

# .env
MICROSOFT_TEAMS_DSN=microsoftteams://default/webhookb2/{uuid}@{uuid}/IncomingWebhook/{id}/{uuid}

其中

webhookb2/{uuid}@{uuid}/IncomingWebhook/{id}/{uuid}

实际应用：发送通知到 Microsoft Teams

SCNet智能助手

SCNet超算互联网平台AI智能助手

下载

有了

symfony/microsoft-teams-notifier

1. 发送简单的文本消息

最基本的通知是发送纯文本消息。这适用于简单的状态更新或快速提醒：

transport('microsoftteams');
$chatter->send($chatMessage);

echo "部署完成通知已发送到 Microsoft Teams。\n";

2. 发送富文本和交互式消息 (MessageCard)

这才是

symfony/microsoft-teams-notifier

id('input_title');
$input->isMultiline(true)->maxLength(5)->title('用几个字概括您为何想参加？');

$inputDate = new DateInput();
$inputDate->title('建议日期')->id('input_date');

// 创建 Microsoft Teams MessageCard
$microsoftTeamsOptions = (new MicrosoftTeamsOptions())
    ->title('Symfony 在线会议通知')
    ->text('Symfony 在线会议是顶尖开发者分享经验的盛会...')
    ->summary('会议摘要')
    ->themeColor('#F4D35E') // 设置卡片主题颜色
    ->section((new Section())
        ->title('关于 Symfony 5.3 的讨论 - 您想加入吗？请大声说出来！')
        ->fact((new Fact())
            ->name('主讲人')
            ->value('Fabien Potencier')
        )
        ->fact((new Fact())
            ->name('演讲者')
            ->value('Patricia Smith')
        )
        ->fact((new Fact())
            ->name('时长')
            ->value('90 分钟')
        )
        ->fact((new Fact())
            ->name('日期')
            ->value('待定')
        )
    )
    ->action((new ActionCard())
        ->name('填写报名信息')
        ->input($input)
        ->input($inputDate)
        ->action((new HttpPostAction())
            ->name('提交评论')
            ->target('http://your-app.com/api/submit-meeting-interest') // 提交到你的后端API
        )
    )
;

// 将自定义选项添加到聊天消息并发送
$chatMessage->options($microsoftTeamsOptions);
$chatter->send($chatMessage);

echo "包含交互式 MessageCard 的会议通知已发送到 Microsoft Teams。\n";

上面的例子展示了如何创建一个包含会议详情、演讲者信息，甚至带有一个表单（包含文本输入和日期选择）以及一个提交按钮的通知卡片。用户可以直接在 Teams 客户端中填写信息并提交，极大地提升了用户体验和工作效率。

优势和实际应用效果

使用

symfony/microsoft-teams-notifier

• 统一的通知管理： 作为 Symfony Notifier 组件的一部分，它允许你通过一个统一的接口管理所有通知渠道，无论是邮件、短信还是 Teams，代码更加整洁和可维护。
• 丰富的通知体验： 借助 MessageCard，通知不再是枯燥的文本，而是结构清晰、视觉友好的卡片，能够更有效地传达信息。
• 增强的交互性： ActionCard 使得用户可以直接在 Teams 中进行操作（如确认、填写简短表单），减少了上下文切换，提高了响应速度。
• 自动化与效率： 将应用事件自动转化为 Teams 通知，解放了人工操作，确保了信息的即时性和准确性，尤其适用于监控报警、部署状态、任务提醒等场景。
• 易于集成： 通过 Composer 简单的安装和 DSN 配置，即可快速将现有 PHP 应用与 Microsoft Teams 打通。

通过引入

symfony/microsoft-teams-notifier

总结

symfony/microsoft-teams-notifier