kineticamobile/lubichannel

Ubicual 的 Laravel 通知渠道

0.1 2020-10-16 15:27 UTC

This package is auto-updated.

Last update: 2024-09-21 18:46:10 UTC


README

此包使您能够轻松使用 Laravel 7.x 和 8.x 通过 Ubicual 发送通知。

内容

安装

您可以通过 composer 安装此包

composer require kineticamobile/lubichannel

设置您的 Ubicual 账户

将您的 Ubicual 产品令牌和默认发送者(名称或发送者编号)添加到您的 config/ubicual.php

// config/ubicual.php
...
return [
    'api_token' => env('UBICUAL_API_TOKEN'),
    'from' => env('UBICUAL_FROM', 'Ubicual'),
    'base_url' => env('UBICUAL_BASE_URL', 'https://api.ubicual.com/api/v1/sms/send'),
];

...

使用方法

您可以在通知内的 via() 方法中使用该通道

use Illuminate\Notifications\Notification;
use Kineticamobile\Ubicual\UbicualMessage;

class AccountApproved extends Notification
{
    public function via($notifiable)
    {
        return ["ubicual"];
    }

    public function toUbicual($notifiable)
    {
        return (new UbicualMessage)->content("Your account was approved!");
    }
}

在您的可通知模型中,请确保包含一个 routeNotificationForUbicual() 方法,该方法返回一个电话号码或电话号码数组。

public function routeNotificationForUbicual()
{
    return $this->phone_number;
}

按需通知

有时您可能需要向未存储为您的应用程序 "用户" 的人发送通知。使用 Notification::route 方法,您可以在发送通知之前指定临时的通知路由信息

Notification::route('ubicual', '5555555555')
            ->notify(new InvoicePaid($invoice));

可用的消息方法

from(''):接受用于通知发送者的电话号码/发送者名称。 请确保在您的 Ubicual 控制台中注册发送者名称。

content(''):接受通知正文的字符串值。

变更日志

有关最近更改的更多信息,请参阅 变更日志

测试

$ composer test

安全

如果您发现任何安全问题,请通过电子邮件 danielmaciasramos@gmail.com 反馈,而不是使用问题跟踪器。

贡献

有关详细信息,请参阅 贡献

致谢

许可

MIT 许可证 (MIT)。有关更多信息,请参阅 许可文件