From 08bf09030a01807648bacec7f25beb77fb0a44c3 Mon Sep 17 00:00:00 2001 From: ahanoff Date: Fri, 19 Jun 2026 10:59:08 +0800 Subject: [PATCH] docs: point setup steps at the Workflows webhook docs and bump version to 2.1.0 Microsoft has retired the legacy Office 365 connectors / incoming webhooks in Microsoft Teams. The old URLs silently accept POSTs with 2xx but no longer deliver, so the action looks healthy while nothing arrives in the channel. Replace the inline step-by-step instructions with a one-liner that links to the canonical Microsoft Learn walkthrough (Create webhooks using Workflows). The MS docs are the source of truth here and we should not duplicate them; our copy was already drifting (template name changed, sample URL pattern may change again). Add a top-level GitHub admonition (> [!WARNING]) flagging the retirement so users with an existing MS_TEAMS_WEBHOOK_URI secret understand why their notifications silently stopped. Admonitions do not render when nested inside list items, so it sits above the numbered list. Refresh the sample workflow to actions/checkout@v7 (matches the version this repo's CI uses), add a placeholder comment showing where build/test/deploy steps go, and drop the version pin from the Known Issues note so it stops going stale. Bump version to 2.1.0 (minor): the Workflows-webhook requirement is a user-facing change in setup, not just a docs edit. --- README.md | 12 ++++++++---- package-lock.json | 4 ++-- package.json | 2 +- 3 files changed, 11 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 298e5ad..096336b 100644 --- a/README.md +++ b/README.md @@ -2,9 +2,12 @@ ### 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. +> [!WARNING] +> Microsoft has [retired the legacy Office 365 connectors / incoming webhooks](https://devblogs.microsoft.com/microsoft365dev/retirement-of-office-365-connectors-within-microsoft-teams/). URLs that look like `https://*.webhook.office.com/...` or `https://outlook.office.com/webhook/...` are no longer delivered. A Workflows-based webhook (below) is required. -2) Add a new `step` on your workflow code as last step of workflow job: +1. Create a **Workflows-based incoming webhook** in Microsoft Teams and add it as the `MS_TEAMS_WEBHOOK_URI` secret in your repository's **Settings → Secrets and variables → Actions**. See [Create webhooks using Workflows](https://learn.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/how-to/add-incoming-webhook?tabs=dotnet#create-webhooks-using-workflows) in the Microsoft Learn docs for instructions. + +2. Add a new `step` on your workflow code as last step of workflow job: ```yaml name: MS Teams Github Actions integration @@ -16,7 +19,8 @@ jobs: runs-on: ubuntu-latest steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@v7 + # ... your build / test / deploy steps go here ... - uses: opsless/ms-teams-github-actions@main if: always() # to let this step always run even if previous step failed with: @@ -26,7 +30,7 @@ jobs: ### Known Issues -- Always set this step with `if: always()` when there are steps between `actions/checkout@v2` and this step. +- Always set this step with `if: always()` when there are steps between `actions/checkout` and this step. ### Roadmap diff --git a/package-lock.json b/package-lock.json index 8416c66..ddd2ea9 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "@opsless/ms-teams-github-actions", - "version": "2.0.1", + "version": "2.1.0", "lockfileVersion": 2, "requires": true, "packages": { "": { "name": "@opsless/ms-teams-github-actions", - "version": "2.0.1", + "version": "2.1.0", "license": "MIT", "dependencies": { "@actions/core": "^1.10.1", diff --git a/package.json b/package.json index ccb35a5..672c3c1 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@opsless/ms-teams-github-actions", - "version": "2.0.1", + "version": "2.1.0", "private": true, "description": "MS Teams Github Actions integration", "main": "lib/main.js",