README

Visão Geral

O pacote Notify Service for Laravel (risetechapps/notify-service-for-laravel) estende o sistema de Notificações do Laravel, fornecendo canais de comunicação robustos para envio de E-mail e SMS através da plataforma NotifyKit ¹.

Este pacote simplifica o processo de envio de notificações transacionais e de marketing, permitindo a construção de mensagens ricas em conteúdo (como tabelas, listas e ações) para e-mail e mensagens de texto concisas para SMS, tudo isso utilizando a sintaxe familiar do Laravel.

Requisitos

Para utilizar este pacote, você deve atender aos seguintes requisitos:

Instalação

Você pode instalar o pacote via Composer:

composer require risetechapps/notify-service-for-laravel

Publicação do Arquivo de Configuração

Após a instalação, você deve publicar o arquivo de configuração do pacote. Isso criará o arquivo config/notify.php em sua aplicação:

php artisan vendor:publish --tag=config

Configuração

O pacote requer que você defina sua chave de API do NotifyKit. Adicione a seguinte variável ao seu arquivo .env:

NOTIFY_SERVICE_KEY="SUA_CHAVE_DE_API_DO_NOTIFYKIT"

O arquivo de configuração publicado (config/notify.php) é o seguinte:

<?php

return [
    'key' => env('NOTIFY_SERVICE_KEY', "")
];

Uso

O pacote se integra perfeitamente ao sistema de Notificações do Laravel. Ele registra dois novos canais de notificação: notify.mail e notify.sms.

Canais de Notificação

Para usar os canais, você deve incluí-los no método via() de sua classe de notificação:

Exemplo de Notificação

Crie uma nova notificação, por exemplo, OrderShippedNotification:

namespace App\Notifications;

use Illuminate\Bus\Queueable;
use Illuminate\Notifications\Notification;
use RiseTechApps\Notify\Message\NotifyMail;
use RiseTechApps\Notify\Message\NotifySms;

class OrderShippedNotification extends Notification
{
    use Queueable;

    public function via(object $notifiable): array
    {
        return ['notify.mail', 'notify.sms'];
    }

    /**
     * Converte a notificação para uma mensagem de E-mail do NotifyKit.
     */
    public function toNotifyMail(object $notifiable): NotifyMail
    {
        return (new NotifyMail())
            ->subject('Seu pedido foi enviado!')
            ->lineHeader('Olá, ' . $notifiable->name . '!')
            ->line('Seu pedido #12345 foi enviado e está a caminho.')
            ->action('Rastrear Pedido', 'https://rastreio.com/12345')
            ->lineFooter('Obrigado por comprar conosco!');
    }

    /**
     * Converte a notificação para uma mensagem de SMS do NotifyKit.
     */
    public function toNotifySms(object $notifiable): NotifySms
    {
        return (new NotifySms())
            ->content('Seu pedido #12345 foi enviado. Rastreie em: https://rastreio.com/12345');
    }
}

Roteamento de Notificações

Seu modelo Notifiable (geralmente o User) deve implementar os métodos de roteamento para que o pacote saiba para onde enviar as mensagens:

// No seu modelo User.php

use Illuminate\Notifications\Notifiable;

class User extends Authenticatable
{
    use Notifiable;

    /**
     * Rota para o canal de E-mail.
     */
    public function routeNotificationForMail(Notification $notification): string|array
    {
        return $this->email; // Ou um array de e-mails
    }

    /**
     * Rota para o canal de SMS.
     */
    public function routeNotificationForSms(Notification $notification): string
    {
        return $this->phone_number; // Deve ser o número de telefone
    }
}

Construindo a Mensagem de Email (NotifyMail)

A classe NotifyMail oferece métodos fluentes para construir e-mails ricos em conteúdo:

Construindo a Mensagem de SMS (NotifySms)

A classe NotifySms é mais simples, focada na mensagem de texto:

Eventos

O pacote dispara eventos do Laravel durante o ciclo de vida do envio da notificação, permitindo que você monitore e reaja ao status das entregas:

Você pode escutar esses eventos em seu EventServiceProvider para implementar lógica de logging ou retry.

Contribuição

Sinta-se à vontade para contribuir com o desenvolvimento do Notify Service for Laravel. Por favor, consulte o arquivo CONTRIBUTING.md para detalhes.

Licença

O pacote Notify Service for Laravel é um software de código aberto licenciado sob a Licença MIT.

Footnotes

1. O NotifyKit é uma plataforma de comunicação que oferece serviços de envio de e-mail e SMS via API. Este pacote atua como um wrapper para integrar esses serviços ao sistema de Notificações do Laravel. ↩