在开发一个 laravel 项目时，我遇到了一个需求：需要将系统中的重要通知发送到 microsoft teams 团队频道中。起初，我尝试了多种方法，但都未能成功实现这个功能。直到我发现了 laravel-notification-channels/microsoft-teams 这个库，它让我轻松解决了这个问题。
首先，我通过 composer 安装了这个库：
composer require laravel-notification-channels/microsoft-teams
安装完成后，如果你的 Laravel 项目没有启用自动发现功能，你需要在 config/app.php 文件中手动添加服务提供者：
'providers' => [ // ... NotificationChannelsMicrosoftTeamsMicrosoftTeamsServiceProvider::class, ],
接下来，我需要设置 Microsoft Teams 的 webhook 连接器。你可以参考 Microsoft 的官方文档来设置 webhook 连接器，并将 webhook URL 添加到 config/services.php 文件中：
// config/services.php ... 'microsoft_teams' => [ 'webhook_url' => env('TEAMS_WEBHOOK_URL'), ], ...
如果你有多个团队或频道，可以添加多个 webhook URL：
// config/services.php ... 'microsoft_teams' => [ 'sales_url' => env('TEAMS_SALES_WEBHOOK_URL'), 'dev_url' => env('TEAMS_DEV_WEBHOOK_URL'), ], ...
然后，我在通知类中使用这个通道：
use IlluminateNotificationsNotification; use NotificationChannelsMicrosoftTeamsMicrosoftTeamsChannel; use NotificationChannelsMicrosoftTeamsMicrosoftTeamsMessage; class SubscriptionCreated extends Notification { public function via($notifiable) { return [MicrosoftTeamsChannel::class]; } public function toMicrosoftTeams($notifiable) { return MicrosoftTeamsMessage::create() ->to(config('services.microsoft_teams.sales_url')) ->type('success') ->title('Subscription Created') ->content('Yey, you got a **new subscription**. Maybe you want to contact him if he needs any support?') ->button('Check User', 'https://foo.bar/users/123'); } }
你也可以在 Notifiable 模型中添加 routeNotificationForMicrosoftTeams 方法来指定 webhook URL：
public function routeNotificationForMicrosoftTeams(Notification $notification) { return config('services.microsoft_teams.sales_url'); }
如果需要即时发送通知，可以使用 Notification facade 的 route 方法：
Notification::route(MicrosoftTeamsChannel::class, null) ->notify(new SubscriptionCreated());
这个库提供了多种方法来定制消息，例如设置标题、内容、按钮等。同时，你还可以创建多个 section 来组织消息内容，使通知更加清晰和有条理。
使用 laravel-notification-channels/microsoft-teams 库后，我成功地将 Laravel 项目中的通知发送到了 Microsoft Teams 中。这个库不仅简化了开发过程，还提供了丰富的定制选项，使得通知更加灵活和实用。通过 Composer 安装和管理依赖包，极大地提高了开发效率和项目的可维护性。
