node-red-contrib-intersvyaz

[RU] | [EN]

A set of Node-RED nodes for interacting with the Intersvyaz smart home API.

This package uses the intersvyaz library to provide tools for intercom control, camera feeds, IPTV streaming, balance monitoring, and event history.

Features

• Intercom Control: List intercoms, open doors, receive incoming calls.
• Camera Feeds: Access live HLS streams and snapshots.
• IPTV: Channel playlists (M3U8) and program guide (XMLTV) with caching.
• Monitoring: Balance with payment status and event history with pagination.
• SIP Integration: Receive intercom calls and control them (open, answer, reject) directly from a flow.

Installation

Install via the Node-RED Manage Palette or run the following command in your Node-RED user directory:

npm install node-red-contrib-intersvyaz

Nodes

Configuration (intersvyaz-config)

Configures the connection (Login, Password). Supports secure credential storage and optional debug logging.

Balance (intersvyaz-balance)

Fetches account balance information.

• Returns formatted balance string and payment status.
• Shows balance in node status with color indicator (green = no debt, yellow = payment due).

History (intersvyaz-history)

Retrieves event history (door opens, intercom calls).

• Supports date range filtering and pagination.
• Returns events with page metadata (page, perPage, count).

Domofon (intersvyaz-domofon)

Manages intercoms with three actions:

• List: Get all available intercoms.
• Get: Get a specific intercom by relay ID.
• Open: Open the door.
• Built-in caching (5-minute TTL) with forced refresh support.

Cams (intersvyaz-cams)

Retrieves camera information for an entrance.

• Array format: Detailed camera objects with stream URLs.
• String format: HLS playlist with CORS headers for direct playback.

IPTV (intersvyaz-iptv)

Fetches IPTV channels and electronic program guide.

• Channels: Full list or filtered by ID/category. M3U8 output with catchup attributes for archive-enabled channels.
• EPG: Program guide in XMLTV format. Configurable forecast duration and automatic background refresh.
• Auto mode: Detects action from HTTP request path (.m3u8 -> channels, .xml -> epg).
• Built-in caching (channels: 24h, EPG: configurable).

Invite (intersvyaz-invite)

Receives incoming intercom calls via SIP.

• Outputs parsed call data: address, entrance ID, snapshot URL.
• Provides control functions: msg.open(), msg.answer(), msg.reject().
• Shows SIP registration status in node status.

Migration

Upgrading from v1? Check the Migration Guide for details on breaking changes and new features.