yoopl / viberbot
Laravel 包用于创建 Viber 机器人
v0.7
2021-06-28 13:03 UTC
Requires
- php: >=7.2
- guzzlehttp/guzzle: >=6.3
- laravel/framework: >=6.0
README
该包的目的是允许您使用 Viber Bot 选项与客户进行交易性通讯,与其他主要用于广告广播或回答支持问题的包不同。
本包基于 paragraf-lex/viber-bot。
安装
通过 Composer 安装。
设置
环境变量
在您的 .env 文件中设置以下参数
VIBERBOT_API=viber_token VIBERBOT_NAME=name VIBERBOT_PHOTO=photo VIBERBOT_LOG=true VIBERBOT_SEND=true
配置
通过配置文件可以进行额外配置。您可以将其发布到您的配置文件夹
php artisan vendor:publish --tag=viberBot
Webhook
要发布您的 webhook,设置您的路由并运行以下 artisan 命令(以路由名称作为参数)
php artisan viberbot:webhook route_name
日志记录
使用 env/config 参数打开或关闭接收钩子调用和发送 Viber 消息的日志记录。对于调试或保存对话历史记录很有用。
如果您启用日志记录,需要设置两个名为 viberbot
和 viberbot_hook
的日志通道。
订阅用户
使用机器人监听 ConversationStarted 事件,向客户发送消息,提示他们订阅您的机器人。确保保存您在订阅时收到的 Viber ID!
如果您需要,也可以构建机器人来回答问题。
发送消息
使用客户端向您的订阅者发送消息并构建您的通知!
- 创建一个消息,它扩展了包中的一个 ViberMessage 类,例如
Boyo\Viberbot\Messages\TextMessage
- 在 Message 类构造函数中设置
$this->text
参数(对于文本消息),以及任何其他需要的参数(键盘、媒体等) - 创建客户端实例
$client = new ViberClient();
- 发送消息,传递一个 ViberUser 模型(收件人)
$client->send($message,$user)
构建通知
- 将 viberbot 通道添加到您的 Laravel 通知的 via 参数中
$via[] = ViberbotChannel::class;
- 创建一个方法
toViberbot($notifiable)
- 在此方法中返回一个扩展包中类(例如
Boyo\Viberbot\Messages\TextMessage
)的 Viber 消息 - 在 Message 类构造函数中设置
$this->text
参数(对于文本消息),以及任何其他需要的参数(键盘、媒体等)