在开发一个 laravel 项目时,我遇到了一个需求:需要将系统中的重要通知发送到 microsoft teams 团队频道中。起初,我尝试了多种方法,但都未能成功实现这个功能。直到我发现了 laravel-notification-channels/microsoft-teams 这个库,它让我轻松解决了这个问题。
首先,我通过 Composer 安装了这个库:
composer require laravel-notification-channels/microsoft-teams
安装完成后,如果你的 Laravel 项目没有启用自动发现功能,你需要在 config/app.php 文件中手动添加服务提供者:
'providers' => [
// ...
NotificationChannels\MicrosoftTeams\MicrosoftTeamsServiceProvider::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 Illuminate\Notifications\Notification;
use NotificationChannels\MicrosoftTeams\MicrosoftTeamsChannel;
use NotificationChannels\MicrosoftTeams\MicrosoftTeamsMessage;
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 安装和管理依赖包,极大地提高了开发效率和项目的可维护性。










