Datalust.Seq.App.Telegram 1.0.0-dev-00097

.NET 6.0 This package targets .NET 6.0. The package is compatible with this framework or higher.
This is a prerelease version of Datalust.Seq.App.Telegram. 
dotnet add package Datalust.Seq.App.Telegram --version 1.0.0-dev-00097
                    


                    

                
NuGet\Install-Package Datalust.Seq.App.Telegram -Version 1.0.0-dev-00097
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Datalust.Seq.App.Telegram" Version="1.0.0-dev-00097" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Datalust.Seq.App.Telegram" Version="1.0.0-dev-00097" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Datalust.Seq.App.Telegram" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add Datalust.Seq.App.Telegram --version 1.0.0-dev-00097
                    


                    

                
#r "nuget: Datalust.Seq.App.Telegram, 1.0.0-dev-00097"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package Datalust.Seq.App.Telegram@1.0.0-dev-00097
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Datalust.Seq.App.Telegram&version=1.0.0-dev-00097&prerelease
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Datalust.Seq.App.Telegram&version=1.0.0-dev-00097&prerelease
                    


                            Install as a Cake Tool

Datalust.Seq.App.Telegram

Send events and notifications from Seq to Telegram via the Bot API.

This codebase is an early preview. It contains code ported generatively from other Seq apps hand-written by Datalust and external contributors. We welcome feedback and bug reports (which we'll always respond to personally!).

Getting started

1. Create a Telegram bot with @BotFather and copy the bot token.

2. Get the chat id for the target chat, group, or channel. For public channels you can use @channelname; for private chats, use the numeric chat id.

3. Install the app in Seq under Settings > Apps, using the Datalust.Seq.App.Telegram package id.

Visit the Seq documentation for detailed information about installing and configuring Seq Apps.

Settings

Property Description Template? Default
Bot token The bot's API token, obtained from @BotFather.
Chat ID The Telegram chat to send messages to — a numeric chat id or @channelname. Yes
Message body The template used to build the message body. If left blank, a default template is used. Yes See below
Parse mode How to format the message body: HTML uses Telegram-supported HTML tags; PlainText sends unformatted text. HTML
Time zone An IANA time zone name used when formatting dates and times, e.g. Australia/Brisbane. Etc/UTC
Date/time format A .NET date/time format string, e.g. yyyy-MM-dd HH:mm:ss. o (ISO-8601)
Silent notification When enabled, messages are delivered silently — recipients receive a notification with no sound.
Message thread ID Unique identifier for the target message thread (topic) of a forum supergroup.

Settings marked Template? support the Seq template language, so event properties and expressions can be included dynamically.

Templates

The default message template formats events in HTML with log level indicators, timestamps, message text, properties, exception details, and a link back to the event in Seq. Alert notifications include result tables and contributing event links.

Custom templates use the Seq template language. Event and notification properties can be inserted by surrounding them with braces:

Error in {Environment}!

Templates support:

  • Built-in Seq event properties including @Level, @Message, @Exception, @Timestamp, and @Id,
  • First-class event properties like Environment in the example above,
  • Seq functions such as ToString(), Coalesce(), Substring(), and IndexOf(),
  • Conditionals with {#if expr}...{#end} and iteration with {#each e in expr}...{#end},
  • InTimeZone() to convert timestamps to the configured time zone,
  • UriEncode() to safely embed values in URLs.

Messages longer than 4096 characters are automatically truncated to fit Telegram's message size limit.

Development

The src/Datalust.Seq.App.Telegram.SmokeTest project is a console application that enables local/interactive app debugging. Configure it using environment variables with the SEQ_APP_SETTING_ prefix, e.g.:

SEQ_APP_SETTING_BOTTOKEN=123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
SEQ_APP_SETTING_CHATID=@mychannel

Tests can be run with:

dotnet test

Acknowledgements

This app is based on https://github.com/datalust/seq-app-mail.

Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.0-dev-00097 116 3/23/2026
1.0.0-dev-00096 56 3/23/2026
1.0.0-dev-00094 52 3/23/2026
1.0.0-dev-00092 64 3/23/2026