telegram_ex

# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## 1.2.1 - 18-05-2026

### Added

- `TelegramEx.Builder.Poll` for sending polls and quizzes
- Proper library documentation

## [1.2.0] - 13-04-2026

### Added

- `TelegramEx.Builder.Sticker` for sending stickers (by id, url, file path)
- `TelegramEx.Builder.Location` for sending geo coordinates
- `TelegramEx.Builder.Video` for sending videos (by id, url, file path) with duration and cover support
- `TelegramEx.Builder.Contact` for sending contacts
- Example project in `example/` folder as quick review of all features
- Sending messages to concrete threads in forum chats via `message_thread_id`
- `TelegramEx.Router` macro to group handlers by logic into routers

### Changed

- All builders now accept `ctx` as the first argument and store payload inside `ctx.payload`
- `API.request/1` accepts full context map instead of separate `token`, `method`, `payload` arguments
- Builders' `send/2` delegates to `API.request/1` through context — no more `Process.get(:token)`

## [1.1.0] - 27-03-2026

### Added

- `TelegramEx.FSM` module with `defstate/2` macro to make stateful handlers
- Multiple bot support via names
- Fallback update handlers

## [1.0.0] - 08-03-2026

### Added

- `TelegramEx` macro for wrapping user module into GenServer
- Polling updates inside `TelegramEx.Server`
- Applying all user-defined handlers inside `TelegramEx` to updates in `TelegramEx.Server`
- Performing actions in declarative way with `Message`, `Photo`, `Document` builders
- Reply markup support via `Message.reply_keyboard`
- Inline markup support via `Message.inline_keyboard`
- Handling callback queries and messages