Telegram Gateway

A lightweight API that forwards structured notifications to Telegram.

This is a private API for personal use only. It is not open for external consumers. Unauthorized requests will be rejected.

What is this?

A stateless proxy that accepts JSON payloads and delivers them as formatted messages to a Telegram chat via the Bot API. Built for automated services, scripts, and LLM agents that need a simple way to push alerts.

Endpoints

POST /notify

Send a notification to Telegram.

GET /manifest

Machine-readable API description for agents and automated clients.

GET /health

Health check.

Payload

tool — name of the calling service
title — short event title
content — event description
level — severity level
emoji optional — extra emoji
timestamp optional — ISO 8601 datetime
duration_ms optional — operation duration
extras optional — key/value metadata
ping optional — mention the owner

info warning error critical

Example

{
  "tool": "Bitwarden Backup",
  "title": "Backup degraded",
  "content": "Uploaded but checksum mismatch on 2 files.",
  "level": "warning",
  "emoji": "🦷",
  "duration_ms": 4312,
  "extras": {
    "bucket": "bw-backup",
    "files_affected": "2"
  }
}

Authentication

All endpoints require a Bearer token passed in the Authorization header.