telegram-bot-sdk

用 PHP 快速构建 Telegram 机器人，Laravel 开箱即用

telegram-bot-sdk 是一个用 PHP 编写的 Telegram Bot API 开发工具包，旨在让开发者用 PHP 快速构建 Telegram 机器人。它封装了 Telegram Bot API 的绝大部分接口，提供了简洁流畅的调用方式，并原生支持 Laravel 框架，可通过服务提供者和门面（Facade）无缝集成。该 SDK 解决了 PHP 开发者对接 Telegram Bot API 时需手动处理 HTTP 请求、参数格式化和响应解析的痛点，内置了键盘、内联模式、文件上传等高级功能，并支持 Webhook 和长轮询两种更新获取方式。其核心能力包括：完整的 API 方法覆盖、类型安全的响应对象、事件驱动处理更新、以及丰富的文档和示例，让开发者能专注于业务逻辑而非底层通信细节。无论是简单通知机器人还是复杂交互式助手，该 SDK 都能显著降低开发门槛。

开源 free 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 3299

维护状态维护中

是否开源是

定价模式 free

项目数据

分类对话助手

开发团队irazasyed

所属国家

官网地址https://telegram-bot-sdk.com

GitHubhttps://github.com/irazasyed/telegram-bot-sdk

定价模式free

价格说明开源PHP SDK，完全免费，无付费版本。

访问状态

是否开源是

开源协议BSD-3-Clause

主要语言PHP

技术栈/模型bot,bot-framework,botkit,chatbot,composer-packages,laravel,laravel-package,laravel-telegram,php,php-sdk,telegram,telegram-bot,telegram-bot-api,telegram-bot-sdk

GitHub 星标★ 3299

30天Star增速

HF 下载量

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

最近更新2026-09-23 00:00:00

维护状态维护中

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

使用教程

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

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

环境要求

PHP 运行环境（该 SDK 为 PHP 语言开发）
Composer 依赖管理工具（项目以 Packagist 包形式发布）
一个 Telegram 机器人及其 Token（需通过 Telegram Bot API 创建）
Laravel 项目（可选，README 说明开箱即支持 Laravel）

安装与启动步骤

1确认 PHP 环境

该 SDK 是用 PHP 编写的 Telegram Bot API 工具包，先确认本机已安装 PHP 并可正常执行。
```
php -v
```
2确认 Composer

项目通过 Packagist 以 Composer 包形式分发，需先安装 Composer 才能引入依赖。
```
composer -V
```
3查阅官方安装文档

README 节选未包含 Installation 章节，请先打开官网与仓库 README 获取准确的安装方式与版本要求。
4在项目中引入 SDK

按官方文档说明，将 Packagist 上的包 irazasyed/telegram-bot-sdk 作为依赖安装到你的 PHP 项目。
```
composer require irazasyed/telegram-bot-sdk
```
5创建并配置机器人

前往 Telegram 按 Bot API 与 Bot FAQ 的说明创建机器人，拿到访问 Token 后写入项目配置。

关键配置

配置项	必填	说明	示例
`TELEGRAM_BOT_TOKEN`	是	机器人访问令牌，调用 Telegram Bot API 时用于鉴权，在机器人创建流程中获取	`123456789:AAxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`

如何确认成功

安装完成后能在项目中正常加载并调用该 SDK 的类即视为引入成功；README 未给出启动命令，请以官方文档为准。

常见问题

Q：这个 SDK 支持 Laravel 吗？

A：支持。README 明确说明 Supports Laravel out of the box，可通过服务提供者与门面方式集成到 Laravel 项目中。

Q：安装命令在哪里看？

A：本次 README 节选只包含项目简介，未包含 Installation 章节。请访问官网 telegram-bot-sdk.com 或 GitHub 仓库 README 查看当前版本的安装说明。

Q：需要自己去申请机器人吗？

A：需要。README 指引参考 Telegram 官方的 Introduction to Bots 与 Bot FAQ 创建机器人并获取 Token，SDK 只负责封装 API 调用。

Q：支持哪些获取更新的方式？

A：项目简介显示同时支持 Webhook 与长轮询两种方式，可按部署环境选择。

注意事项

本教程基于 README 节选整理，节选中没有安装章节，安装命令与版本要求请以官网 telegram-bot-sdk.com 和仓库 README 为准。
引入 SDK 的具体命令与最低 PHP 版本可能随版本变化，执行前请核对官方文档。
切勿把机器人 Token 硬编码提交到公开仓库，建议放在环境变量或配置文件中。
该 SDK 是代码库而非独立服务，本身没有端口和启动进程，需在你的 PHP/Laravel 项目中调用。

核心亮点

完整封装 Telegram Bot API，方法覆盖全面，调用简单
原生 Laravel 集成，提供门面和服务提供者，配置便捷
支持 Webhook 和长轮询，更新处理灵活

不足之处

仅支持 PHP 和 Laravel，不适用于其他语言或框架
文档/社区待观察：部分高级 API 示例较少，需查阅源码

适用场景

构建 Telegram 客服或通知机器人，自动回复用户消息
在 Laravel 应用中集成 Telegram 消息推送，如订单状态更新
开发交互式 Telegram 小游戏或投票机器人，利用内联键盘

替代项目

irazasyed/telegram-bot-sdk、telegram-bot/api、php-telegram-bot/core

项目介绍

telegram-bot-sdk 是对话助手领域的开源项目，由 irazasyed 开发，2015 年首次发布。

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

项目仍在小幅维护中，最近一次代码更新于 2026-09-23。开源PHP SDK，完全免费，无付费版本。

它主要面向的使用场景是：构建Telegram客服或通知机器人，自动回复用户消息。同类可对比的替代方案包括 irazasyed/telegram-bot-sdk、telegram-bot/api、php-telegram-bot/core。

上一篇：Sidekick

下一篇：errbot