跳转到主要内容

Webhook

该包提供了 Webhook 路由与控制器。

Webhook URL

默认 Webhook URL 如下:
可在 .env 中修改路径。

与 Laravel 事件系统的集成

收到 Webhook 事件后会分发 Laravel 事件。事件发现(event discovery)默认已启用。
在生产环境中请执行 php artisan event:cache

发布默认 Listener

会在 app/Listeners/Line/ 中生成 MessageListener

Bot Facade

Revolution\Line\Facades\Bot 会将调用委派给官方 SDK 的 MessagingApiApi 类的所有方法。

reply 方法

使用 Bot::reply() 时,你可以传入 reply token 来回复消息。
通过 Bot::pushMessage() 进行的推送发送会根据套餐存在条数限制。而针对用户消息的回复(Bot::reply())没有条数限制,可以免费使用。

自定义

Bot Macro

Bot 实现了 Macroable,因此可以自由添加方法。 AppServiceProvider@boot 中进行注册。

替换 MessagingApiApi 实例

Bot::bot() 会返回 MessagingApiApi 实例。可通过 Bot::botUsing() 替换该实例。
也支持 Callable。

替换 WebhookHandler

如果你不想使用 Laravel 事件系统,而希望自行编写 Webhook 处理逻辑,可以实现 WebhookHandler 接口并进行替换。 创建 app/Actions/LineWebhook.php
AppServiceProvider@register 中注册:

默认路由的中间件

默认启用了 throttle 中间件。可通过 .env 修改。

Http::line()

该包对 Http 类进行了扩展,因此你也可以不通过 Bot Facade,而直接发送 API 请求。
更多最新信息请参见 GitHub 仓库
最后修改于 2026年7月18日