eggent/docs/releases/0.1.6-telegram-long-polling.md

Eggent 0.1.6 - Telegram Long Polling

Date: 2026-04-30
Type: Patch release snapshot

Release Name

Telegram Long Polling

This release adds Telegram long polling alongside the existing webhook path, so Telegram integration can run without a public domain or HTTPS endpoint.

What Is Included

1) Telegram Long Polling

• Added a polling service that reads Telegram updates with getUpdates.
• Added API controls for polling status, start, and stop.
• Automatically removes an existing webhook before polling starts.

2) Shared Telegram Message Handling

• Moved Telegram update processing into a shared message handler.
• Kept webhook and polling modes on the same message/session/access-control behavior.
• Preserved file upload handling and Telegram reply support.

3) Connection Mode Settings

• Added auto, webhook, and polling modes for Telegram configuration.
• Auto mode uses polling for local, private, or non-HTTPS URLs, and webhook for public HTTPS URLs.
• Added UI controls for choosing mode and controlling polling.

4) Runtime Reliability

• Starts Telegram lifecycle from server instrumentation instead of page layout rendering.
• Stops polling when Telegram is disconnected.
• Keeps webhook secret generation and mode detection consistent across runtime paths.

5) Installation Docs

• Reworked installation docs around Docker, local Node.js, development, and PM2 deployment paths.

New in 0.1.6

• Telegram long polling mode for installs without public HTTPS.
• Telegram lifecycle startup via Next.js instrumentation.
• Package/app health version bumped to 0.1.6.

Upgrade Notes

• No migration is required.
• Existing webhook setups continue to work.
• For local or VPS installs without HTTPS, set Telegram mode to Auto or Long Polling.