# Rocket.Chat Laravel Notifications Channel


Latest Version on Packagist (opens new window) Software License (opens new window) Build Status (opens new window) StyleCI (opens new window) Quality Score (opens new window) Code Coverage (opens new window) Total Downloads (opens new window)

# Introduction

This package makes it easy to send notifications using RocketChat (opens new window) with Laravel 5.6+.

# Contents

# Installation

You can install the package via composer:

$ composer require laravel-notification-channels/rocket-chat

# Setting up the RocketChat service

In order to send message to RocketChat channels, you need to obtain Webhook (opens new window).

Add your RocketChat API server's base url, incoming Webhook Token and optionally the default channel to your config/services.php:

// config/services.php
'rocketchat' => [
     // Base URL for RocketChat API server (https://your.rocketchat.server.com)
    'url' => env('ROCKETCHAT_URL'),
    'token' => env('ROCKETCHAT_TOKEN'),
    // Default channel (optional)
    'channel' => env('ROCKETCHAT_CHANNEL'),

# Usage

You can use the channel in your via() method inside the notification:

use Illuminate\Notifications\Notification;
use NotificationChannels\RocketChat\RocketChatMessage;
use NotificationChannels\RocketChat\RocketChatWebhookChannel;

class TaskCompleted extends Notification
    public function via($notifiable): array
        return [

    public function toRocketChat($notifiable): RocketChatMessage
        return RocketChatMessage::create('Test message')
            ->to('channel_name') // optional if set in config
            ->from('webhook_token'); // optional if set in config

In order to let your notification know which RocketChat channel you are targeting, add the routeNotificationForRocketChat method to your Notifiable model:

public function routeNotificationForRocketChat(): string
    return 'channel_name';

# Available methods

from(): Sets the sender's access token.

to(): Specifies the channel id to send the notification to (overridden by routeNotificationForRocketChat if empty).

content(): Sets a content of the notification message. Supports Github flavoured markdown.

alias(): This will cause the message’s name to appear as the given alias, but your username will still display.

emoji(): This will make the avatar on this message be an emoji. (e.g. '🙈')

avatar(): This will make the avatar use the provided image url.

attachment(): This will add an single attachment.

attachments(): This will add multiple attachments.

clearAttachments(): This will remove all attachments.

# Adding Attachment

There are several ways to add one ore more attachments to a message

public function toRocketChat($notifiable)
    return RocketChatMessage::create('Test message')
        ->to('channel_name') // optional if set in config
        ->from('webhook_token') // optional if set in config
            RocketChatAttachment::create(['image_url' => 'test']),
            new RocketChatAttachment(['image_url' => 'test']),
                'image_url' => 'test'

# Available methods

color(): The color you want the order on the left side to be, any value background-css supports.

text(): The text to display for this attachment, it is different than the message’s text.

timestamp(): Displays the time next to the text portion. ISO8601 Zulu Date or instance of any \DateTime

thumbnailUrl(): An image that displays to the left of the text, looks better when this is relatively small.

messageLink(): Only applicable if the ts is provided, as it makes the time clickable to this link.

collapsed(): Causes the image, audio, and video sections to be hiding when collapsed is true.

author($name, $link, $icon): shortcut for author methods

authorName(): Name of the author.

authorLink(): Providing this makes the author name clickable and points to this link.

authorIcon(): Displays a tiny icon to the left of the Author’s name.

title(): Title to display for this attachment, displays under the author.

titleLink(): Providing this makes the title clickable, pointing to this link.

titleLinkDownload(): When this is true, a download icon appears and clicking this saves the link to file.

imageUrl(): The image to display, will be “big” and easy to see.

audioUrl(): Audio file to play, only supports what html audio does.

videoUrl(): Video file to play, only supports what html video does.

fields(): An array of Attachment Field Objects.

        'short' => false, // Whether this field should be a short field. Default: false
        'title' => 'Title 1', //The title of this field. Required
        'value' => 'Value 1' // The value of this field, displayed underneath the title value. Required
        'short' => true,
        'title' => 'Title 2',
        'value' => 'Value 2'


# Changelog

Please see CHANGELOG (opens new window) for more information what has changed recently.

# Testing

$ vendor/bin/phpunit

# Security

If you discover any security related issues, please email open@cybercog.su instead of using the issue tracker.

# Contributing

Please see CONTRIBUTING (opens new window) for details.

# Credits

# Change log

Please see CHANGELOG (opens new window) for more information on what has changed recently.

# License

The MIT License (MIT). Please see License File (opens new window) for more information.

# About CyberCog

CyberCog (opens new window) is a Social Unity of enthusiasts. Research best solutions in product & software development is our passion.