mr3od/laravel-textbee-channel

Provides TextBee notification channel for Laravel

v1.0.1 2026-05-14 23:51 UTC

Requires

• php: ^8.3
• illuminate/events: ^12.0 || ^13.0
• illuminate/notifications: ^12.0 || ^13.0
• illuminate/queue: ^12.0 || ^13.0
• illuminate/support: ^12.0 || ^13.0

Requires (Dev)

• laravel/pint: ^1.21
• mockery/mockery: ^1.0
• orchestra/testbench: ^10.0 || ^11.0
• phpunit/phpunit: ^10.5 || ^11.5.10

MIT

• Abdulrahman Alwan

• sms
• notification
• laravel
• textbee

Published on Packagist.org on 2026-05-14 23:52 UTC

README

This package makes it easy to send SMS notifications via TextBee with Laravel 12 and 13.

TextBee lets you send SMS messages through an Android device you own — no carrier contract required.

Contents

• Installation
• Configuration
• Usage
  • Available Message methods
• Changelog
• Testing
• Security
• Contributing
• Credits
• License

Installation

composer require mr3od/laravel-textbee-channel

Configuration

Add your TextBee API key and device ID to .env:

TEXTBEE_API_KEY=your-api-key-here
TEXTBEE_DEVICE_ID=your-device-id-here       # optional if set per-message
TEXTBEE_ENABLED=true
TEXTBEE_BASE_URL=https://api.textbee.dev/api/v1  # optional — override for self-hosted instances
TEXTBEE_DEBUG_TO=[phone]                # optional — redirect all messages here during development

Publish the config file:

php artisan vendor:publish --provider="Mr3od\Textbee\TextbeeProvider"

This creates config/textbee-notification-channel.php.

Usage

Use the channel in your notification's via() method:

use Mr3od\Textbee\TextbeeChannel;
use Mr3od\Textbee\TextbeeSmsMessage;
use Illuminate\Notifications\Notification;

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

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

The channel resolves the recipient's phone number by calling routeNotificationFor('textbee') on the notifiable, then routeNotificationFor(TextbeeChannel::class), and finally falls back to the phone_number attribute.

Add the routing method to your notifiable model to override the default:

public function routeNotificationForTextbee()
{
    return $this->mobile_number;
}

Per-message device override

If you have multiple Android devices registered in TextBee you can pick one per message:

public function toTextbee($notifiable)
{
    return TextbeeSmsMessage::create("Your OTP is 123456")
        ->deviceId('your-other-device-id');
}

Multiple recipients

return TextbeeSmsMessage::create('Your OTP is 123456')
    ->to(['[phone]', '+0987654321']);

Multi-SIM devices

return TextbeeSmsMessage::create('Hello!')
    ->simSubscriptionId(1);

Available Message methods

TextbeeSmsMessage

Method	Description
content(string $text)	SMS body
to(string|array $recipients)	One or more recipient phone numbers
deviceId(string $id)	Override the TextBee device to send from
simSubscriptionId(int $id)	SIM slot to use on multi-SIM devices

Changelog

Please see CHANGELOG for recent changes.

Testing

composer test

Security

If you discover a security issue please email [e-mail] instead of using the issue tracker.

Contributing

Please see CONTRIBUTING for details.

Credits

• Abdulrahman Alwan

License

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