Telegram.Bot

用 C# 快速构建功能完整的 Telegram 机器人

Telegram.Bot 是 .NET 生态中一个成熟稳定的 Telegram Bot API 客户端库，为 C# 开发者提供完整的 Bot 开发支持。它封装了 Telegram Bot API 的所有核心功能，包括发送/接收消息、管理群组与频道、处理回调查询、文件上传下载等，并提供了强类型模型和异步编程模型，让开发者能够用简洁的代码快速构建功能丰富的聊天机器人。该库解决了从零对接 Telegram API 的繁琐问题，如请求签名、错误处理、更新轮询等，并支持 Webhook 和长轮询两种更新获取方式。其核心能力包括：全面的 API 覆盖、流畅的 API 设计、对 .NET 标准 2.0 的支持（可跨平台使用）、以及活跃的社区维护。无论是简单的自动回复机器人，还是复杂的业务集成应用，Telegram.Bot 都能显著提升开发效率，是 .NET 开发者构建 Telegram 机器人的首选库。

开源 free 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 3645

维护状态活跃

是否开源是

定价模式 free

项目预览

项目数据

分类对话助手

开发团队TelegramBots

所属国家

官网地址https://telegrambots.github.io/book

GitHubhttps://github.com/TelegramBots/Telegram.Bot

定价模式free

价格说明开源项目，MIT许可证，完全免费，无付费版本。

访问状态

是否开源是

开源协议MIT

主要语言C#

技术栈/模型bot,chatbot,telegram,telegram-bot,telegram-bot-api

GitHub 星标★ 3645

30天Star增速

HF 下载量

上线时间2015-06-28 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：入门约 10 分钟部署方式：库/依赖 4 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

具备 .NET 开发环境（README 说明这是 .NET Client 库）
网络可访问 nuget.org，用于获取 Telegram.Bot 包
建议先阅读官方 Quickstart 指南与 Bot 概念介绍

安装与启动步骤

1阅读入门指南

README 的 Getting Started 只给出一个指向官方 Quickstart 指南的链接，先按该指南了解完整用法。
2安装 NuGet 包

在已有的 .NET 项目中添加 Telegram.Bot 包，README 仅提供了 nuget.org 包源，未给出具体安装命令。
```
dotnet add package Telegram.Bot
```
3查阅官方书籍

官方书籍网站包含教程与示例，README 推荐用其学习客户端 API 的调用方式。
4加入社区求助

遇到问题可加入官方 Telegram 群组，或订阅新闻频道获取版本更新信息。

如何确认成功

README 未给出运行验证方式；包安装无报错即视为成功，功能验证请按官方 Quickstart 指南运行示例。

常见问题

Q：Bot API 不够用怎么办？

A：README 建议改用 100% 用 C# 编写的 Telegram Client API 实现 WTelegramClient：https://github.com/wiz0u/WTelegramClient

Q：遇到问题去哪里求助？

A：可加入官方群组 https://t.me/tgbot_chat；订阅新闻频道 https://t.me/s/tgbot_net 获取最新动态。

Q：有完整的中文/在线文档吗？

A：官方书籍地址为 https://telegrambots.github.io/book/，README 的 Quickstart 指南也指向该站点。

注意事项

README 节选中没有安装命令、端口、路径等细节，本教程据其链接与包名推断，实际请以官方 Quickstart 指南为准。
这是 .NET 客户端库而非可独立运行的服务，需要自行编写宿主程序调用。
项目团队主要通过 NuGet 发布多个包，包列表见 nuget.org 上的 Telegram.Bot。

核心亮点

完整封装 Telegram Bot API，覆盖消息、群组、支付等全部功能，无需手动拼接 HTTP 请求
提供强类型模型和异步 API，代码清晰且符合 .NET 开发习惯，易于维护
支持 Webhook 和长轮询两种模式，并内置错误处理和重试机制，稳定性高

不足之处

文档相对简略，部分高级用法需参考源码或社区讨论
API 更新可能滞后于 Telegram 官方新特性，需要关注版本迭代

适用场景

开发客服机器人，自动回复用户消息并接入工单系统
构建群组管理工具，实现入群欢迎、关键词过滤、定时公告等功能
集成业务通知，将系统事件实时推送到 Telegram 频道或用户

替代项目

Telegram.Bot.Framework、TLSharp、WTelegramClient

项目介绍

Telegram.Bot 是对话助手领域的开源项目，由 TelegramBots 开发，2015 年首次发布。

在全站 13,635 个收录项目中，它的 GitHub 星标数（3,645）位列前 30%，在对话助手分类的 917 个项目里位列前 8%。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-28。MIT许可证，完全免费，无付费版本。从国内网络环境看，可直接访问。

它主要面向的使用场景是：开发客服机器人，自动回复用户消息并接入工单系统。同类可对比的替代方案包括 Telegram.Bot.Framework、TLSharp、WTelegramClient。

上一篇：qqbot

下一篇：kelivo