基于 Telegram Bot API 的 PHP 开发工具包,内置 Laravel 支持,便于构建 Telegram 机器人。
laravel-notification-channels/telegram
为 Laravel 添加 Telegram 通知渠道,通过 Telegram Bot API 发送消息。
- Star
- 1,120
- Fork
- 173
- 未关闭 Issue
- 0
- 最近提交
- 2个月前
这是什么?
这是一个 Laravel 扩展包,让应用可以通过 Telegram Bot API 向用户、群组和频道发送通知。在通知类的 via() 方法中返回 telegram 渠道,再用 TelegramMessage、TelegramFile、TelegramPoll 等链式构建器组装消息即可。
除纯文本外,还支持键盘和内联按钮,以及图片、文档、音频、视频、贴纸、位置、场所、联系人、骰子、投票和媒体组。文件可以使用 URL、本地路径、Telegram file ID 或原始内容。包内还提供 TelegramUpdates 用于获取 chat ID,并可通过 NotificationFailed 事件或 onError 回调处理发送失败。请求可经代理或自建 Bot API 服务器转发。
核心功能
- 01为文本、文件、投票、骰子、位置、联系人和媒体组提供链式构建器
- 02支持内联按钮、回复键盘以及 Markdown/HTML 格式
- 03附件可使用本地文件、远程 URL、file ID 或原始内容
- 04提供获取更新和查找 chat ID 的辅助类
- 05可通过 NotificationFailed 事件或 onError 回调处理失败
- 06支持代理和自建 Bot API 服务器
适用场景
- 从 Laravel 应用向客户的 Telegram 账号发送订单或账单提醒
- 将服务器或监控告警推送到团队的 Telegram 群组
- 基于应用事件发起投票或问答
- 向大量订阅者群发公告并遵守 Telegram 频率限制
快速上手
- 1
使用 Composer 安装该包
composer require laravel-notification-channels/telegram - 2
通过 @BotFather 创建机器人,并在 config/services.php 中配置 TELEGRAM_BOT_TOKEN
- 3
在通知的 via() 方法中返回 'telegram' 并实现 toTelegram()
使用前须知
- 需要 Telegram 机器人令牌和聊天 ID,且用户必须先与机器人发起对话。
标签
常见问题
- telegram 是什么?
- 为 Laravel 添加 Telegram 通知渠道,通过 Telegram Bot API 发送消息。 这是一个 Laravel 扩展包,让应用可以通过 Telegram Bot API 向用户、群组和频道发送通知。在通知类的 via() 方法中返回 telegram 渠道,再用 TelegramMessage、TelegramFile、TelegramPoll 等链式构建器组装消息即可。
- telegram 可以免费使用吗?用的什么许可证?
- telegram 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
- telegram 还在维护吗?
- 半年内有更新。telegram 最近一次提交是在 2026年9月4日。
- telegram 适合用来做什么?
- 从 Laravel 应用向客户的 Telegram 账号发送订单或账单提醒 将服务器或监控告警推送到团队的 Telegram 群组 基于应用事件发起投票或问答 向大量订阅者群发公告并遵守 Telegram 频率限制
- telegram 怎么安装和运行?
- 使用 Composer 安装该包: composer require laravel-notification-channels/telegram 通过 @BotFather 创建机器人,并在 config/services.php 中配置 TELEGRAM_BOT_TOKEN 在通知的 via() 方法中返回 'telegram' 并实现 toTelegram()
- 在哪里获取 telegram?
- 源代码和安装说明在 GitHub 上:https://github.com/laravel-notification-channels/telegram
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
用于构建 Telegram 机器人的 PHP 框架,支持处理器、中间件、会话与完整 Bot API。
自动为 Freenom 免费域名续期,并通过邮件、Telegram 等渠道发送通知。
自托管的欧洲房源监控工具,抓取 ImmoScout24、Kleinanzeigen 等平台的新房源,并推送到 Telegram、邮件等渠道。
基于 Telegram Bot API 的 Java 库,用于快速开发 Telegram 机器人,支持长轮询和 Webhook。
基于 Cloudflare Workers 部署的 Telegram AI 机器人,单文件即可上线,无需服务器。