Repolode
laravel-notification-channels

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. 1

    使用 Composer 安装该包

    composer require laravel-notification-channels/telegram
  2. 2

    通过 @BotFather 创建机器人,并在 config/services.php 中配置 TELEGRAM_BOT_TOKEN

  3. 3

    在通知的 via() 方法中返回 'telegram' 并实现 toTelegram()

使用前须知

  • 需要 Telegram 机器人令牌和聊天 ID,且用户必须先与机器人发起对话。

标签

#laravel#php#telegram#telegram-bot#notifications#bot-api#hacktoberfest#laravel-13#laravel-notification-channels#laravel-notifications

常见问题

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 数据每日更新。

相关项目