README

Laravel Notification driver for Chatwork.

Installation

With Composer:

composer require a-yasui/laravel-chatwork

After installing the package, please publish the configuration file.

php artisan vendor:publish --provider="ATYasu\Chatwork\ServiceProvider"

Usage

1. Set the Chatwork API Token

Open .env and set your Chatwork API Token like as below.

CHATWORK_API_TOKEN=XXXXXXXXXXXXXXXXXX

2. Create an notification class

Create a notification class like as below.

class SampleNotification extends ChatworkNotification
{
    function toChatwork($notifiable): ChatworkMessage
    {
        return (new ChatworkMessage())
            ->text('This is sample notification');
    }
}

3. Sending notification

Here are some examples of notification methods.
Please refer to the following page if you want to know more about Laravel Notification.
https://laravel.com/docs/notifications

Example of On-Demand Notifications

Notification::route('chatwork', '{ROOM_ID}')
    ->notify(new SampleNotification());

Example of using Notifiable trait

Add the method routeNotificationForChatwork to your model using Notifiable.

class User extends Authenticatable
{
    use Notifiable;
    
    public function routeNotificationForChatwork()
    {
        return '{ROOM_ID}';
    }
}

Next, just notify when you want.

$user->notify(new SampleNotification());

Building message

You can create a chat message as below.

$message = new SampleNotification();
$message->to('999999')
    ->info("Please confirm this.\nhttp://example.com/", 'New Order #7489393')
    ->toAll()
    ->text('FYI');

Mention specific user

$message->to('999999');

Mention all users in the room

$message->toAll();

Simple text

$message->text('This is simple text message.');

Information

$message->info('This is information.');

With title

$message->info('This is information.', 'Information title');

License

MIT