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

Property	Description	Type	Default	Required
`trigger_source`	Send notifications from events generated by other nodes or a custom defined trigger. Options: Events from previous nodes (`built_in`); Custom Trigger (`custom`).	`enum`	`custom`	Yes
`trigger`	Send an alert when this condition evaluates to true. Conditional on `trigger_source` being `custom`.	trigger-condition	`null`	Yes
`enabled`	Notifications Enabled	`bool`	`true`	No
`teams_webhook_url`	Incoming webhook URL for the Teams channel.	`string`	`null`	Yes
`subject`	Title of the Teams message. See node documentation for template variables.	`string`	`{{ source_name }} : {{ event_name }}`	Yes
`body`	Body of the Teams message. See node documentation for template variables.	`string`	`{{ event_description }}`	No
`include_snapshot`	Include a snapshot from the trigger time.	`bool`	`true`	No
`snapshot_object_types`	Select the object types to include in the snapshot. If not specified, entire frame will be sent. Conditional on `include_snapshot` being `true`.	model-labels	`null`	No
`media_node`	Attaches media from the specified node with the message. Specifying a Save Clip node will include the most recent clip from the node. The node must be configured to store clips locally.	`string`	`null`	No
`livestream_node`	Enables including the live stream URL from the named WebRTC node with the message. Accepted node type: `stream_webrtc_out`.	`string`	`null`	No
`interval`	Min. time between consecutive notifications. Unit: seconds.	`float`	`10`	No
`max_media_wait_time`	Max. time to wait until a media clip is available. Unit: seconds.	`float`	`10`	No
`media_extensions`	Comma separated list of media extensions to attach when a Media node is specified. For example, 'mp4,jpg,png,gif'.	`string`	`mp4`	No
`use_camera_as_source`	Enable to report a linked camera as the source for camera streams and Universal bridge clips.	`bool`	`false`	No

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:

Variable	Description
`meta`	Frame metadata. Contains keys like `nodes`, `objects`, and other custom metadata inserted by Custom function node.
`application_id`	The application ID of the deployment that produced this metadata.
`application_name`	The application name of the deployment that produced this metadata.
`deployment_id`	The deployment ID of the deployment that produced this metadata.
`deployment_name`	The deployment name of the deployment that produced this metadata.
`source_name`	The name of the source that produced this metadata.
`livestream_url`	The URL of the livestream.
`event_name`	Name of event(s) contained in this frame.
`event_description`	Description 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 }}

Output Metadata

Node does not insert any output metadata; upstream metadata continues through the pipeline

Microsoft Teams Webhook Setup

Open Microsoft Teams and navigate to the channel where you want Lumeo notifications.
Select ••• next to the channel name and choose Connectors (or Apps depending on your Teams version).
Add an Incoming Webhook and give it a name (for example, "Lumeo Alerts").
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.