mirror of https://github.com/lukaszraczylo/go-telegram.git synced 2026-06-05 22:43:59 +00:00

Files

T

lukaszraczylo ac7cae8fa7 Initial release of go-telegram

A fully-generated, strongly-typed Go client for the Telegram Bot API.

* 176 methods + 301 types generated from Bot API v10.0
* 1408 auto-generated tests (8 scenarios per method)
* Typed unions throughout — no 'any' in the public surface
* Pluggable HTTP transport and JSON codec (default goccy/go-json)
* Built-in retry middleware honouring Telegram's retry_after
* Generic dispatcher with filters and conversation handlers
* Self-verifying codegen pipeline (regen → audit → emit → run tests)
* 14 example bots covering common patterns

2026-05-09 13:09:27 +01:00

839 B

Raw Blame History

welcome

Greet new chat members as they join a group and log member departures.

What it shows

OnMessageFilter matching Message.NewChatMembers to send a welcome message for each joiner
OnMessageFilter matching Message.LeftChatMember to log departures
OnMyChatMember to detect when the bot itself is added to or removed from a group

Required bot permissions

The bot must be an admin in the group (or at minimum have the "Read Messages" permission granted to non-admin bots via setMyDefaultAdminRights). Without this, Telegram does not forward service messages about member joins and leaves.

Running

export TELEGRAM_BOT_TOKEN=123456:ABC...
go run ./examples/welcome

Add the bot to a group, then have another user join or leave — the bot will greet joiners and log departures to stdout.

839 B Raw Blame History

welcome

What it shows

Required bot permissions

Running

839 B

Raw Blame History