mirror of https://github.com/lukaszraczylo/go-telegram.git synced 2026-06-06 22:49:32 +00:00

Files

T

lukaszraczylo 9072e9eafb 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

main.go

Initial release of go-telegram

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

README.md

Initial release of go-telegram

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

README.md

moderation

Group moderation commands: /kick, /ban, /mute, /warn, /unwarn.

What it shows

OnCommand for each moderation action
api.BanChatMember / api.UnbanChatMember for kick and ban
api.RestrictChatMember with ChatPermissions for muting
errors.Is(err, client.ErrForbidden) to surface missing-permissions errors cleanly
In-memory warn counter via sync.Map (auto-bans at 3 warnings)

Required bot permissions

The bot must be an admin in the group with "can ban users" and "can restrict members" permissions. Without those rights, commands will reply with a friendly error message instead of crashing.

Usage

All commands work by replying to a target user's message:

/kick   — remove from group (can rejoin)
/ban    — permanent ban
/mute   — silence for 1 hour
/warn   — issue a warning (3 warnings = auto-ban)
/unwarn — remove the last warning

Production notes

The warn counter is in-memory and lost on restart. For production, back it with Redis or a database.
Consider adding an admin check (see examples/admin) so only group admins can invoke these commands.

Running

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