LogoLogo
  • Duplicati Documentation
  • Getting Started
    • Installation
    • Set up a backup in the UI
    • Running a backup
    • Restoring files
  • Detailed descriptions
    • Choosing Duplicati Type
    • Using the secret provider
      • Local providers
      • Cloud providers
      • Advanced configurations
    • Using remote management
      • Using remote control with agent
    • Migrating Duplicati to a new machine
    • Scripts
    • Sending reports
      • Monitoring with Duplicati Console
      • Sending reports with email
      • Sending Jabber/XMPP notifications
      • Sending HTTP notifications
      • Sending Telegram notifications
      • Custom message content
    • Duplicati Access Password
    • Import and export backup configurations
    • Filters in Duplicati
    • The local database
    • The server database
    • Preload settings
    • Retention settings
    • Using Duplicati with Linux
    • Using Duplicati from Docker
    • Using Duplicati with MacOS
    • Using Duplicati with Windows
    • Running a self-hosted OAuth Server
  • Using tools
    • Encrypting and decrypting files
    • Using Duplicati from the Command Line
    • Recovering from failure
    • Disaster recovery
  • Backup destinations
    • Destination overview
    • Standard based destinations
      • File Destination
      • S3-compatible Destination
      • FTP Destination
      • SFTP (SSH) Destination
      • WebDAV Destination
      • OpenStack Destination
      • Rclone Destination
      • CIFS (aka SMB) Destination
    • Provider specific destinations
      • Backblaze B2 Destination
      • Box.com Destination
      • Rackspace CloudFiles Destination
      • IDrive e2 Destination
      • Mega.nz Destination
      • Aliyun OSS Destination
      • Tencent COS Destination
      • Jottacloud Destination
      • pCloud Destination
      • Azure Blob Storage Destination
      • Google Cloud Storage Destination
      • Microsoft Group Destination
      • SharePoint Destination
      • SharePoint v2 (Graph API)
      • Amazon S3 destination
    • File synchronization providers
      • Dropbox Destination
      • Google Drive Destination
      • OneDrive Destination
      • OneDrive For Business Destination
    • Decentralized providers
      • Sia Destination
      • Storj Destination
      • TahoeLAFS destination
  • Duplicati Programs
    • TrayIcon
    • Server
    • Command Line Interface CLI
    • Service and WindowsService
    • Command Line Tools
      • AutoUpdater
      • BackendTester
      • BackendTool
      • RecoveryTool
      • SecretTool
      • SharpAESCrypt
      • Snapshots
      • ServerUtil
    • Agent
    • LICENSE
      • Duplicati Inc & Open Source
      • License Agreement
    • OAuth Server
  • SUPPORT
  • Installation details
    • Release channels and versions
      • Upgrading and downgrading
      • Downgrade from 2.1.0.2 to 2.0.8.1
    • Package options
    • Developer
  • TECHNICAL DETAILS
    • Architecture Premises
    • Understanding Backup
      • How Backup Works
      • Encryption Algorithms
      • Backup size parameters
    • Understanding Restore
      • How Restore Works
      • Disaster Recovery
    • Database versions
    • Server authentication model
    • Option formats
Powered by GitBook
On this page

Was this helpful?

Export as PDF
  1. Detailed descriptions
  2. Sending reports

Sending Telegram notifications

Describes the how to configure sending notifications via Telegram

PreviousSending HTTP notificationsNextCustom message content

Last updated 1 month ago

Was this helpful?

To send a notification via Telegram you need to supply a channel id, a bot token and a an api key.

To obtain the bot token (aka bot id), message the @BotFather bot. After creating the bot, send a message to the bot, so it can reply. For more details on Telegram bots, see the .

After obtaining the bot token you can obtain the channel id with a cURL script:

BOT_TOKEN="YOURBOTTOKEN" curl -s "https://api.telegram.org/bot$BOT_TOKEN/getUpdates" \
  | grep -o '"id":[0-9]*' | head -1 | cut -d':' -f2

To obtain the API key, follow the .

With all required values obtained, you can set up the Telegram notifications in the general settings:

You can toggle between the two views using the "Edit as list" and "Edit as text" links.

Besides the mandatory options, it is also possible to configure:

  • The notification message and format

  • Conditions on when to send emails

  • Conditions on what log elements to include

Telegram Notification Options

Bot Configuration

--send-telegram-bot-id (String) - The Telegram bot ID that will send messages

--send-telegram-api-key (String) - The API key for authenticating your Telegram bot

Message Destination

--send-telegram-channel-id (String) - The channel ID where messages will be sent

--send-telegram-topid-id (String) - Topic ID for posting in specific topics within Telegram groups

Notification Content

--send-telegram-message (String) - Template for message content with support for variables like %OPERATIONNAME%, %REMOTEURL%, %LOCALPATH%, and %PARSEDRESULT%

--send-telegram-result-output-format (format) - Format for presenting operation results

  • Duplicati

  • Json

Notification Filtering

--send-telegram-level (level) - Controls which result types trigger notifications:

  • Success - Only successful operations

  • Warning - Operations that completed with warnings

  • Error - Operations that failed with recoverable errors

  • Fatal - Operations that failed with critical errors

  • All - All operation results regardless of status

--send-telegram-any-operation (Boolean) - When enabled, sends notifications for all operations, not just backups

--send-telegram-log-level (Enumeration) - Sets minimum severity level for included log entries:

  • ExplicitOnly - Show only explicitly requested messages

  • Profiling - Include performance measurement data

  • Verbose - Include detailed diagnostic information

  • Retry - Include information about retry attempts

  • Information - Include general status messages

  • DryRun - Include simulation mode outputs

  • Warning - Include potential issues that didn't prevent completion

  • Error - Include critical failures that require attention

--send-telegram-log-filter (String) - Filters log entries based on specified patterns

--send-telegram-max-log-lines (Integer) - Limits the number of log lines included in notifications

For details on how to customize the notification message, see the .

section on customizing message content
Telegram bot documentation
Telegram guide to creating an application
Set up Telegram notifications with the default options editor
Set up Telegram option with a text field