Trigger Microsoft Teams alert

Send a Microsoft Teams message when a trigger condition is met.

Overview

This node sends a Microsoft Teams message when a trigger condition is met. It can include a snapshot image and a link to a video clip produced by another node.

Inputs & Outputs

  • Inputs : 1, Media Format : Raw Video
  • Outputs : 1, Media Format: Raw Video
  • Output Metadata : None

Properties

PropertyValue
triggerSend the message once this trigger condition is met.
teams_webhook_urlIncoming webhook URL for the Teams channel.
subjectTitle of the Teams message. Supports template variables such as {{ source_name }} and {{ event_name }}.
bodyBody of the message. Supports template variables such as {{ event_description }}.
include_snapshotInclude a snapshot image from the trigger time.
media_nodeAttach a link to the most recent media file from this node (for example, a Save Clip node).
livestream_nodeInclude the live stream URL from a Stream WebRTC node.
intervalMin time (seconds) between consecutive notifications.
max_media_wait_timeMaximum time to wait for a media clip to become available.

Template Syntax

The following Template variables are available to use in Subject and Body. The templates can be built using Jinja2 Template Syntax.

Variables available to the template:

VariableDescription
metaFrame metadata. Contains keys like nodes, objects, and other custom metadata inserted by Custom function node.
application_idThe application ID of the deployment that produced this metadata.
application_nameThe application name of the deployment that produced this metadata.
deployment_idThe deployment ID of the deployment that produced this metadata.
deployment_nameThe deployment name of the deployment that produced this metadata.
source_nameThe name of the source that produced this metadata.
livestream_urlThe URL of the livestream.
event_nameName of event(s) contained in this frame.
event_descriptionDescription of events contained in this frame.

Example templates

Static text content:

Text content

Reference specific metadata:

Person detected on {{ source_name }}. View live stream at {{ livestream_url }}

Metadata reinserted as is:

{{ meta | tojson }}

Metadata

Metadata PropertyDescription
NoneNone

Microsoft Teams Webhook Setup

  1. Open Microsoft Teams and navigate to the channel where you want Lumeo notifications.
  2. Select ••• next to the channel name and choose Connectors (or Apps depending on your Teams version).
  3. Add an Incoming Webhook and give it a name (for example, "Lumeo Alerts").
  4. Copy the webhook URL and paste it into the teams_webhook_url property for this node.

Note: Some Microsoft Teams tenants require enabling incoming webhooks in tenant settings. If you cannot add a webhook, contact your Teams admin.