PHPackages                             chandan07cse/robi-sms - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. chandan07cse/robi-sms

ActiveLibrary[API Development](/categories/api)

chandan07cse/robi-sms
=====================

Laravel package for Robi/AdaReach Business SMS API integration

0125PHP

Since Feb 8Pushed 3mo agoCompare

[ Source](https://github.com/chandan07cse/robi-sms)[ Packagist](https://packagist.org/packages/chandan07cse/robi-sms)[ RSS](/packages/chandan07cse-robi-sms/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

AdaReach SMS - Laravel Package & Standalone Library
=======================================================

[](#adareach-sms---laravel-package--standalone-library)

[![Latest Version on Packagist](https://camo.githubusercontent.com/5d5ecd653c784ed0a34224449e39cec00422c7e4a1594c2efa8bf0a31923b10a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6368616e64616e30376373652f726f62692d736d732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/chandan07cse/robi-sms)[![Total Downloads](https://camo.githubusercontent.com/28ba09175a528201ce864cf4d6ebb034bb5d03c606c07285d482f9f580d22abf/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6368616e64616e30376373652f726f62692d736d732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/chandan07cse/robi-sms)[![License](https://camo.githubusercontent.com/3d597ad1b8c03b4c806cc80baa8672dc6ab61974d53d9f2a2e388ffd7c4a00ca/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6368616e64616e30376373652f726f62692d736d732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/chandan07cse/robi-sms)[![PHP Version](https://camo.githubusercontent.com/c39766aa5b9498e3573e7d790aa92691a008ee32104c2e36de456a3fda4c4d25/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6368616e64616e30376373652f726f62692d736d732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/chandan07cse/robi-sms)

A comprehensive PHP package for integrating with **AdaReach (Robi/MobiReach) Business SMS API**. Works seamlessly with **Laravel** or as a **standalone PHP library** (PHP 7.4+).

---

📑 Table of Contents
-------------------

[](#-table-of-contents)

- [Features](#-features)
- [Requirements](#-requirements)
- [Laravel Installation](#-laravel-installation)
- [Standalone Installation](#-standalone-installation-without-laravel)
- [Phone Number Formats](#-phone-number-formats)
- [Bangla/Unicode SMS](#-banglaunicode-sms)
- [API Reference](#-api-reference)
- [Examples](#-examples)
- [Troubleshooting](#-troubleshooting)
- [Changelog](#-changelog)
- [License](#-license)

---

✨ Features
----------

[](#-features)

### Core Features

[](#core-features)

- ✅ Send single and bulk SMS messages
- ✅ **Phone auto-normalization** (01XXX → 880XXX, +880XXX → 880XXX)
- ✅ **Bangla/Unicode auto-detection**
- ✅ Real-time SMS delivery tracking
- ✅ Balance checking (API & GUI balance)
- ✅ **PHP 7.4+ compatible**
- ✅ **Works without Laravel** (Standalone mode)
- ✅ Token-based authentication with auto-refresh
- ✅ File-based token caching

### Dashboard Features

[](#dashboard-features)

- 🎨 Modern, responsive UI with tabs
- 📊 Character counter with SMS parts calculation
- 📱 Single & Bulk SMS sending
- 💰 Real-time balance display
- 🔐 Credential management
- 📄 Message history (Laravel mode)
- 📈 Analytics and statistics (Laravel mode)

### Security

[](#security)

- 🔒 Token-based authentication with auto-refresh
- 🔐 Encrypted credentials (Laravel mode)
- 💾 File-based token caching (Standalone mode)
- 🛡️ Database-backed configuration (Laravel mode)

---

📋 Requirements
--------------

[](#-requirements)

### Laravel Requirements

[](#laravel-requirements)

- PHP 8.1 or higher
- Laravel 10.x or 11.x
- MySQL/PostgreSQL database
- Redis (optional, for caching)
- Node.js 16+ (for dashboard assets)

### Standalone Requirements

[](#standalone-requirements)

- PHP 7.4 or higher (PHP 7.4, 8.0, 8.1, 8.2, 8.3)
- cURL extension
- JSON extension
- Composer

---

🎯 Laravel Installation
----------------------

[](#-laravel-installation)

Perfect for Laravel applications with full dashboard, analytics, and database integration.

### Step 1: Install Package

[](#step-1-install-package)

```
composer require chandan07cse/robi-sms
```

### Step 2: Publish Configuration & Assets

[](#step-2-publish-configuration--assets)

```
# Publish config, migrations, and assets
php artisan vendor:publish --provider="AdaReach\Sms\AdaReachServiceProvider"

# Run migrations
php artisan migrate

# Build dashboard assets (optional)
npm install && npm run build
```

### Step 3: Configure Environment

[](#step-3-configure-environment)

Add these to your `.env` file:

```
ADAREARCH_USERNAME=your_username
ADAREARCH_PASSWORD=your_password
ADAREARCH_BASE_URL=https://api.mobireach.com.bd
ADAREARCH_DEFAULT_SENDER=8801XXXXXXXXX
```

### Step 4: Usage in Laravel

[](#step-4-usage-in-laravel)

```
use AdaReach\Sms\Facades\AdaReach;

// Send single SMS
$response = AdaReach::sendSms('01703611094', 'Hello from Laravel!');

// Send bulk SMS
$response = AdaReach::sendBulkSms(
    ['01703611094', '01812345678'],
    'Bulk message'
);

// Check balance
$balance = AdaReach::getBalance();

// Get account info
$info = AdaReach::getAccountInfo();
```

### Step 5: Access Dashboard

[](#step-5-access-dashboard)

Visit your Laravel SMS dashboard:

```
http://your-laravel-app.test/sms-dashboard

```

**Dashboard Features:**

- 📊 Real-time analytics & statistics
- 📱 Send single & bulk SMS
- 💰 Balance monitoring
- 📈 Message history & tracking
- 🔐 Credential management
- 📄 Export message logs

---

🚀 Standalone Installation (Without Laravel)
-------------------------------------------

[](#-standalone-installation-without-laravel)

Perfect for plain PHP projects, WordPress, custom frameworks, or any PHP 7.4+ application.

### Step 1: Install via Composer

[](#step-1-install-via-composer)

```
composer require chandan07cse/robi-sms
```

### Step 2: Basic Setup

[](#step-2-basic-setup)

```