docs.md

name	Microsoft Teams Notification
author	mobydeck
icon	https://raw.githubusercontent.com/mobydeck/ci-teams-notification/refs/heads/main/assets/ms-teams-logo.png
description	Plugin to send pipeline notifications to Microsoft Teams using Adaptive Cards
tags	notifications chat
containerImage	mobydeck/ci-teams-notification
containerImageUrl	https://hub.docker.com/r/mobydeck/ci-teams-notification
url	https://github.com/mobydeck/ci-teams-notification

Teams Notification Plugin

CI plugin to send pipeline notifications to Microsoft Teams using Adaptive Cards.

For creating a Teams Webhook, follow this guide.

Settings

Setting Name	Description	Default
webhook_url	Teams Webhook URL (required)	none
facts	Comma-separated list of facts to display (project,message,version)	all
buttons	Comma-separated list of buttons (pipeline,commit,release)	all
variables	Comma-separated list of environment variables to display	none
debug	Enable debug output of the card JSON	false

Basic Usage

steps:
  - name: notify-teams
    image: mobydeck/ci-teams-notification
    settings:
      webhook_url: https://outlook.office.com/webhook/...
    when:
      - status: [success, failure]
        event: [manual, push, tag]

Advanced Usage

steps:
  - name: notify-teams
    image: mobydeck/ci-teams-notification
    settings:
      webhook_url:
        from_secret: teams_webhook_url
      facts: project,version
      buttons: pipeline,commit
      variables: MY_VAR1,MY_VAR2
      debug: true
    when:
      - status: [success, failure]
        event: [manual, push, tag]

Features

• Customizable notification card with:
  • Pipeline status (success/failure)
  • Author information with avatar
  • Commit/build details
  • Configurable fact sections
  • Optional variables table
  • Customizable action buttons
• Base64-encoded avatar images

Notification Examples

Success Notification

Failure Notification