sebbmeyer/laravel-teams-connector

Microsoft Teams Connector for Laravel 5/6

0.6.3 2023-02-26 19:08 UTC

This package is auto-updated.

Last update: 2024-03-26 21:29:34 UTC


README

A Laravel 5/6 package to send notifications to Microsoft Teams by using "Incoming Webhook". This package also contains a card to send a Laravel Forge deployment notification, because Microsoft Teams notification is not supported at the moment.

If you are using Laravel 5.4 or older versions of laravel, please use the version 0.3.x of this package.

Forge card

Package Installation - Composer

You can install the package via composer:

composer require sebbmeyer/laravel-teams-connector

Laravel

If you are using Laravel 5.5 and up, the service provider will automatically get registered.

For older versions of Laravel (<5.5), you have to add the service provider and alias to config/app.php:

Sebbmyr\LaravelTeams\TeamsConnectorServiceProvider::class,

You can optionally use the facade for shorter code. Add this to your facades:

'TeamsConnector' => Sebbmyr\LaravelTeams\Facades\TeamsConnector::class,

Lumen

For Lumen usage, the service provider should be registered manually by adding the following line in bootstrap/app.php:

$app->register(Sebbmyr\LaravelTeams\TeamsConnectorServiceProvider::class);

Configuration

For this package to work, you need to configure an "Incomming Webhook" connector in your targeted Teams channel and copy the url into a config file that you can publish like this:

php artisan vendor:publish --provider="Sebbmyr\LaravelTeams\TeamsConnectorServiceProvider"

... or you simple add the following to your .env file:

MICROSOFT_TEAMS_WEBHOOK=<incoming_webhook_url>

Usage

How to send simple notification look at the readme of this package sebbmeyer/php-microsoft-teams-connector

Custom card - ForgeCard

You can create your own cards for every purpose you need, just extend the AbstractCard class and implement the getMessage() function.

\\ Sebbmyr\LaravelTeams\Cards\ForgeCard.php
public function getMessage()
{
    return [
        "@type" => "MessageCard",
        "@context" => "http://schema.org/extensions",
        "summary" => "Forge Card",
        "themeColor" => ($this->data["status"] === 'success') ? self::STATUS_SUCCESS : self::STATUS_ERROR,
        "title" => "Forge deployment message",
        "sections" => [
            [
                "activityTitle" => "",
                "activitySubtitle" => "",
                "activityImage" => "",
                "facts" => [
                    [
                        "name" => "Server:",
                        "value" => $this->data["server"]['name']
                    ],
                    [
                        "name" => "Site",
                        "value" => "[". $this->data["site"]["name"] ."](http://". $this->data["site"]["name"] .")"
                    ],                        [
                        "name" => "Commit hash:",
                        "value" => "[". $this->data["commit_hash"] ."](". $this->data["commit_url"] .")"
                    ],
                    [
                        "name" => "Commit message",
                        "value" => $this->data["commit_message"]
                    ]
                ],
                "text" => ($this->data["status"] === 'success') ? $this->data["commit_author"] ." deployed some fresh code!" : "Something went wrong :/"
            ]
        ]
    ];
}

Custom Card

You can use the CustomCard class and dynamically build out our card. Based on Microsoft Legacy Card

Available Methods

  • addTitle
  • addText
  • addColor
  • addActivity
  • addFacts
  • addFactsText
  • addImage
  • addImages
  • addAction
$card = New Sebbmyr\LaravelTeams\Cards\CustomCard('Title Test','Text Test');
$card->addColor('800080')
    ->addFactsText('Supported Laravel Versions',['5.x','6.x'])
    ->addFactsText('Unsupported Laravel Versions',['Before Version 5'])
    ->addAction('Laravel Website','http://www.laravel.com')
    ->addFacts('Facts Section',['Fact Name 1' => 'Fact Value 1','Fact Name 2' => 'Fact Value 2']);
app('TeamsConnector')->send($card);

Adaptive Card

To use an adaptive card see the documentation here. Better support will coming soon.

License

This Microsoft Teams connector for Laravel is open-sourced software licensed under the MIT license