Plugin: hook-teams

Dieser Inhalt ist noch nicht in deiner Sprache verfügbar.

Sends release notifications to Microsoft Teams via Incoming Webhooks. Use it to share new versions and changelog highlights with your team in a Teams channel.

Installation

go install github.com/SemRels/hook-teams@latest

Each plugin is a standalone Go binary. Keep it on your PATH or reference it with path: in .semrel.yaml. If you keep secrets in a .env file, load them with semrel --env-file .env release.

Configuration

plugins:
  - uses: hook-teams
    args:
      webhook_url: "https://your-tenant.webhook.office.com/webhookb2/..."
      title: "ðŸš€ New Release"      # optional
      theme_color: "0078D7"         # optional, hex without #
      mention: "user@example.com"   # optional, Teams user to @mention

Environment Variables

Name	Required	Default	Description
`SEMREL_PLUGIN_WEBHOOK_URL`	yes	`—`	Microsoft Teams Incoming Webhook URL.
`SEMREL_PLUGIN_TITLE`	no	`ðŸš€ New Release`	Card title shown in the Teams message.
`SEMREL_PLUGIN_THEME_COLOR`	no	`0078D7`	Hex colour (without `#`) for the card accent.
`SEMREL_PLUGIN_MENTION`	no	`—`	Email address of a Teams user to @mention.

Getting a Webhook URL

In Teams, open the target channel → ··· → Connectors
Search for Incoming Webhook → Configure
Give it a name (e.g. semrel) and optionally upload an icon
Copy the generated webhook URL and store it as a secret

Release Context Variables

SEMREL_VERSION
SEMREL_TAG_NAME
SEMREL_NEXT_VERSION
SEMREL_CHANGELOG
SEMREL_DRY_RUN

Dry-Run Behaviour

When SEMREL_DRY_RUN=true, the plugin prints what it would send and exits 0 without making any HTTP calls:

hook-teams: [dry-run] would send Teams notification for v1.4.0

Example Output

A successful release posts an adaptive card to your Teams channel showing the version number, release branch, and the generated changelog.

Source

SemRels/hook-teams