TGN

Three ways in

Wire it in however your service already talks.

Shell out from a script, call the HTTP API directly, or drop in a typed client. Same dispatch service underneath.

deploy.sh UTF-8

# pipe any command's output straight to Telegram
npm run build 2>&1 | tgn --title CI --level info

# or watch a long-running process and notify on exit
tgn --exec "./deploy.sh" --watch-pid --title deploy

curl -X POST https://tgn.ashrhmn.com/v1/notify \
  -H "Authorization: Bearer $TGN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"message":"Deploy finished","level":"info"}'

import { createTgnClient, tgnToken } from "tgn-client";

const tgn = createTgnClient(tgnToken(process.env.TGN_TOKEN));

await tgn.notify("Payment webhook failed", {
  level: "error",
  title: "billing-service",
});

// or wait on a human's tap instead of a blind timeout
const answer = await tgn.promptAndWait({
  message: "Deploy to production?",
  buttons: ["yes", "no"],
});

use tgn::{Client, MessageOptions, Level};

let client = Client::from_token(env::var("TGN_TOKEN")?);

client
    .send_message("Backup completed", MessageOptions::new().with_level(Level::Info))
    .await?;

token, err := tgn.NewToken(os.Getenv("TGN_TOKEN"))

client := tgn.NewClientWithToken(token)

client.Notify("Build finished", &tgn.NotifyOptions{
    Title: "CI",
    Level: tgn.LevelInfo,
})

Why teams reach for it

Built for the alerts you'd otherwise miss.

No signup

Start from a Telegram chat

Message @tgnnnn_bot and send /start — you're already talking to TGN. Add a named service when you're ready for a token of its own.

Instant

Push, not polling

Telegram delivers to your phone the moment a message is sent — no app to open, no inbox to check.

Language-agnostic

Works with anything that can POST

Bash, Python, Node, Rust, Go, or a curl one-liner in a crontab. The API doesn't care what called it.

What you can send

Four dispatch types, one token.

DISPATCH TYPEPROMPT

01 — INTERACTIVE

Ask a question, get an answer back

Send a message with buttons — "Deploy to production?" — and poll for the reply. Scripts can wait on a human's tap instead of a blind timeout.

DISPATCH TYPENOTIFY

02 — MESSAGE

Titled, leveled notifications

Attach a title and severity (info, warn, error) so alerts are scannable at a glance.

DISPATCH TYPEFILE

03 — ATTACHMENT

Ship files up to 50MB

Logs, backups, reports, screenshots — send the artifact along with the alert, not just a link to it.

DISPATCH TYPEWATCH

04 — CLI MODE

Watch a process, not just call an API

Tail logs for a pattern, or hold on a PID until it exits, then fire the notification automatically.

Not just for scripts

Another channel, not a replacement.

A point-of-sale app can message the floor the moment a sale closes. A dashboard can alert an admin the moment something big changes. TGN slots in as another channel next to email, SMS, and mobile push — usually the one that gets seen first.

pos-notifier.tsSNIPPET

await Promise.all([
  email.send(receipt),
  sms.send(receipt),
  push.send(receipt),
  tgn.notify(`Sale closed: $${sale.total}`, { title: "pos-app" }), // usually first to arrive
]);

Email~ minutes

SMS~ seconds

Mobile push~ seconds

Telegram · via TGN~ 0.3s

How it works

Three hops, no middleman.

Any source

A script, a pipeline, or your product

Personal machines, CI pipelines, or an app notifying on its own events

→

Dispatch

Validates, rate-limits, and delivers your message

→

Delivered

Your Telegram chat

Via @tgnnnn_bot, straight to your phone

Quickstart

Running in under two minutes.

Add a service on Telegram

Message @tgnnnn_bot and create a service to get a token.

/start
/add laptop

Install the CLI

curl -fsSL tgn.ashrhmn.com/install.sh | sh
tgn login

Send your first dispatch

tgn "hello from your server"

Or use the HTTP API / SDK with the same token — no reconfiguration needed.