https://github.com/opsless/ms-teams-github-actions

Github Action to send workflow status notification to Microsoft Teams
https://github.com/opsless/ms-teams-github-actions

github-actions integration ms-teams notifications

Last synced: 2 months ago
JSON representation

Github Action to send workflow status notification to Microsoft Teams

• Host: GitHub
• URL: https://github.com/opsless/ms-teams-github-actions
• Owner: opsless
• License: mit
• Created: 2020-08-29T18:45:42.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2024-10-23T14:46:49.000Z (3 months ago)
• Last Synced: 2024-10-23T21:41:38.434Z (3 months ago)
• Topics: github-actions, integration, ms-teams, notifications
• Language: TypeScript
• Homepage: https://github.com/marketplace/actions/opsless-ms-teams-github-actions
• Size: 1.34 MB
• Stars: 36
• Watchers: 4
• Forks: 8
• Open Issues: 14
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-actions - Send Microsoft Teams Notification
• fucking-awesome-actions - Send Microsoft Teams Notification
• awesome-workflows - Send Microsoft Teams Notification

README

        
# MS Team Github Actions integration

### Usage

1. Add `MS_TEAMS_WEBHOOK_URI` on your repository's configs on Settings > Secrets. It is the [webhook URI](https://docs.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/how-to/add-incoming-webhook) of the dedicated Microsoft Teams channel for notification.

2) Add a new `step` on your workflow code as last step of workflow job:

```yaml

name: MS Teams Github Actions integration

on: [push]

jobs:

  build:

    runs-on: ubuntu-latest

    steps:

      - uses: actions/checkout@v4

      - uses: opsless/ms-teams-github-actions@main

        if: always() # to let this step always run even if previous step failed

        with:

          github-token: ${{ github.token }}

          webhook-uri: ${{ secrets.MS_TEAMS_WEBHOOK_URI }}

```

### Known Issues

- Always set this step with `if: always()` when there are steps between `actions/checkout@v2` and this step.

### Roadmap

- add error message if workflow failed

- add files changed list

- add workflow run duration

Feel free to create issue if you have an idea in mind