Download the PHP package babenkoivan/telegram-notifications without Composer

Telegram Notifications For Laravel

The package provides easy way to send Telegram notifications to any notifiable entity in your project. It uses official Telegram Bot API to deliver your message directly to a user. You can send any information you want: text, media, location or contact.

Contents

• Requirements
• Installation
• Set up your model
• Usage example
• Advanced Usage
  • Single Message
    • TelegramMessage
    • TelegramPhoto
    • TelegramAudio
    • TelegramDocument
    • TelegramSticker
    • TelegramVideo
    • TelegramVoice
    • TelegramLocation
    • TelegramVenue
    • TelegramContact
  • Message Collection

Requirements

The package has been tested on following configuration:

• PHP version >= 7.3
• Laravel Framework version >= 5.5

Installation

To install the package you can use composer:

If the package discovery is disabled, you need to register the service provider in config/app.php file:

To copy the package settings to config directory run:

Now you're ready to set up a bot token for your application. If you haven't created a bot you can make new one using BotFather. For more information, visit Bots: An introduction for developers page.

Let's move on and assume you have a token. You can configure the token either in .env file:

or in config/telegram.php file:

Of course, the token above is just an example, you have to specify your own token.

Set up your model

To notify user or any other notifiable entity you need to use Notifiable trait with your model and define routeNotificationForTelegram method, which will return a chat_id:

At this point, you may wonder where to get a chat_id. The answer is it's up to you! You can create a webhook to receive updates for your bot and collect chat ids, or you can specify ids manually for certain users.

To get started, you can send Hello! message to your bot and then get message details by requesting API method:

You will receive a JSON in return:

Usage example

if you configured a model you're ready to make your first Telegram notification. You can create a new notification using artisan command:

And again, TelegramNotification here is just an example, you can specify any name you want.

Now, you can go to app/Notifications folder and you'll see TelegramNotification.php file. In via method specify TelegramChannel::class and initialize a new TelegramMessage instance in toTelegram method:

To send the notification use notify method with notifiable entity.

Let's say we have an authenticated user and we want to send a message from a route callback. We can do it like this:

Advanced Usage

You can send either a single message or a message collection at once.

Single Message

Each message class represents certain type of information you can deliver to a user. To send a message return a new instance of necessary type from toTelegram method:

You can also pass parameters to the constructor, to be more explicit:

Available message types are listed below.

TelegramMessage

TelegramNotifications\Messages\TelegramMessage

TelegramPhoto

TelegramNotifications\Messages\TelegramPhoto

TelegramAudio

TelegramNotifications\Messages\TelegramAudio

TelegramDocument

TelegramNotifications\Messages\TelegramDocument

TelegramSticker

TelegramNotifications\Messages\TelegramSticker

TelegramVideo

TelegramNotifications\Messages\TelegramVideo

TelegramVoice

TelegramNotifications\Messages\TelegramVoice

TelegramLocation

TelegramNotifications\Messages\TelegramLocation

TelegramVenue

TelegramNotifications\Messages\TelegramVenue

TelegramContact

TelegramNotifications\Messages\TelegramContact

Message Collection

Instead of sending one message at once you can send bunch of messages using TelegramCollection:

Each method of the collection creates corresponding message instance and puts it in the collection. Available methods are listed below: