# teloxide/teloxide

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/teloxide-teloxide).**

4,166 stars · 299 forks · Rust · MIT

## Links

- GitHub: https://github.com/teloxide/teloxide
- Homepage: https://docs.rs/teloxide/latest/teloxide/
- awesome-repositories: https://awesome-repositories.com/repository/teloxide-teloxide.md

## Topics

`rust` `telegram` `telegram-bot-api` `telegram-bot-framework` `teloxide`

## Description

Teloxide is a Rust application framework and API wrapper designed for building Telegram bots. It provides a programmatic interface for receiving updates and sending messages via the Telegram Bot API, utilizing a declarative pipeline of filters and handlers.

The framework includes a bot dialogue manager that uses a finite-state machine to track user sessions and conversation flows. This state management system supports pluggable persistence backends, including memory, Redis, and Sqlite.

The library covers asynchronous message routing and update reception through either long-polling or webhook transport. It also provides utilities for command parsing, type-safe dependency injection, and handler type validation to detect unreachable code paths.

## Tags

### Networking & Communication

- [Telegram Bot Frameworks](https://awesome-repositories.com/f/networking-communication/telegram-bot-frameworks.md) — A specialized Rust framework for building interactive agents on the Telegram platform.
- [Chat Message Capture Pipelines](https://awesome-repositories.com/f/networking-communication/in-process-message-routing/chat-message-capture-pipelines.md) — Routes incoming chat messages through a declarative pipeline of filters and handlers. ([source](https://cdn.jsdelivr.net/gh/teloxide/teloxide@master/README.md))
- [Update Reception Mechanisms](https://awesome-repositories.com/f/networking-communication/incoming-webhooks/messaging-update-processors/update-reception-mechanisms.md) — Provides support for receiving server updates via both long-polling loops and HTTP webhooks. ([source](https://cdn.jsdelivr.net/gh/teloxide/teloxide@master/README.md))
- [Asynchronous Update Routing](https://awesome-repositories.com/f/networking-communication/message-routing/asynchronous-update-routing.md) — Directs incoming updates through a pipeline of filters and handlers to process user requests.
- [Polling and Webhook Clients](https://awesome-repositories.com/f/networking-communication/polling-and-webhook-clients.md) — Provides a dual-mode transport layer supporting both long-polling and HTTP webhooks for update reception.
- [Telegram API Integrations](https://awesome-repositories.com/f/networking-communication/telegram-api-integrations.md) — Offers a programmatic Rust interface for interacting with the Telegram Bot API.
- [Bot State Management](https://awesome-repositories.com/f/networking-communication/bot-session-protocols/bot-state-management.md) — Manages the persistence of bot session data and conversation flows using Redis and Sqlite.
- [Update Filters](https://awesome-repositories.com/f/networking-communication/incoming-webhooks/messaging-update-processors/update-filters.md) — Provides custom filter logic to evaluate and drop incoming updates before they reach handlers. ([source](https://github.com/teloxide/teloxide/blob/master/DPTREE_GUIDE.md))

### Artificial Intelligence & ML

- [Finite State Machine Managers](https://awesome-repositories.com/f/artificial-intelligence-ml/conversational-state-managers/finite-state-machine-managers.md) — Tracks per-user session state across multi-turn interactions using a finite state machine.

### Development Tools & Productivity

- [Chat Automation](https://awesome-repositories.com/f/development-tools-productivity/event-driven-automation-engines/chat-automation.md) — Enables the creation of bots that respond to triggers and manage conversations via long polling or webhooks.
- [Command Tree Parsing](https://awesome-repositories.com/f/development-tools-productivity/custom-command-execution/configuration-file-command-execution/command-trigger-prefixes/chat-command-triggers/command-tree-parsing.md) — Provides utilities to parse plain text user messages into typed command structures with arguments and options. ([source](https://cdn.jsdelivr.net/gh/teloxide/teloxide@master/README.md))

### Software Engineering & Architecture

- [Combinator-Based Pipeline Processing](https://awesome-repositories.com/f/software-engineering-architecture/combinator-based-pipeline-processing.md) — Defines the flow of updates using a combinator-based approach to chain filters and execution paths.
- [Update Routing Systems](https://awesome-repositories.com/f/software-engineering-architecture/update-routing-systems.md) — Implements a tree-based execution flow to direct incoming API updates to specific handlers using filters. ([source](https://github.com/teloxide/teloxide/blob/master/DPTREE_GUIDE.md))
- [Handler Branching Paths](https://awesome-repositories.com/f/software-engineering-architecture/execution-flow-control/conditional-branching/labeled-branch-paths/handler-branching-paths.md) — Directs update flows into alternative paths to attempt different handlers when branches are filtered out. ([source](https://github.com/teloxide/teloxide/blob/master/DPTREE_GUIDE.md))
- [Route Handler Injection](https://awesome-repositories.com/f/software-engineering-architecture/integration-extensibility/dependency-injection/route-handler-injection.md) — Implements type-safe injection of dependencies directly into bot handler functions. ([source](https://github.com/teloxide/teloxide/blob/master/DPTREE_GUIDE.md))
- [Type-Safe Context Injections](https://awesome-repositories.com/f/software-engineering-architecture/integration-extensibility/dependency-injection/type-safe-context-injections.md) — Supplies dependencies to handlers via a type-safe map to ensure compile-time correctness.

### Programming Languages & Runtimes

- [Rust Backend Frameworks](https://awesome-repositories.com/f/programming-languages-runtimes/rust-backend-frameworks.md) — Provides a type-safe toolkit for developing high-performance backend services and automated bots in Rust.

### Part of an Awesome List

- [Communication and Bots](https://awesome-repositories.com/f/awesome-lists/media/communication-and-bots.md) — Full-featured framework for building Telegram bots.