Notifying Microsoft Teams with GitHub Actions

• In Microsoft Teams
• In GitHub Actions
• Notes

There are various options for notifying Microsoft Teams when using GitHub Actions.

GitHub App for Microsoft Teams is nice for handling the whole GitHub experience and workflow in Microsoft Teams.

For build notifications, we are prefering a combination of Microsoft Teams Actions and Microsoft Teams Deploy Card.

In Microsoft Teams

1. In Microsoft Teams, select the channel to be notified and then Connectors

   

2. Search for Incoming Webhook and click Add

   

3. After that, configure the connector by giving it a unique name.
4. Copy the Webhook URI.
5. Click on Done

In GitHub Actions

Either in your organization or repository add a new secret named MICROSOFT_TEAMS_WEBHOOK_URI and paste in the value of the copied Webhook URI:

In your GitHub Actions workflow.yml you can use the following cominbation:

name: Microsoft Teams notification
on:
  push:
    branches:
      - main
      - develop
      - master

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v2
    
    # notify on each build event like starting and finishing a build
    - uses: toko-bifrost/ms-teams-deploy-card@master
      if: always()
      with:
        github-token: ${{ github.token }}
        webhook-uri: ${{ secrets.MICROSOFT_TEAMS_WEBHOOK_URI }}

    # notify Microsoft Teams channel with a custom message
    - uses: aliencube/microsoft-teams-actions@v0.8.0
      with:
        webhook_uri: ${{ secrets.MICROSOFT_TEAMS_WEBHOOK_URI }}
        title: This is a custom message
        summary: This is a message summary

After running this GitHub Action workflow, your Microsoft Teams channel will be notified:

Notes

• Additional sections and actions for a custom notification can be added by using the sections and actions JSON key. See #1 and #2