📱 Android SMS Gateway (PHP)

Android SMS Gateway transforms your Android smartphone into an SMS gateway. It is a lightweight application that enables you to send SMS messages programmatically via an API, making it ideal for integrating SMS functionality into your applications or services.

• https://packagist.org/packages/rootscratch/sms
• https://sms.rootscratch.com/

🚀 Installation

To install the rootscratch/sms via Composer, run the following command:

composer require rootscratch/sms

📖 Usage/Examples

To use the Rootscratch SMS in your PHP project, include the Composer autoloader:

require_once__DIR__ . '/vendor/autoload.php';
useRootscratch\SMS\Configuration;
$configuration = newConfiguration();
// Set API Key$configuration->setApiKey('your_api_key');

⚙️ Configuration Usage

/** * Configuration *  * Get Devices = getDevices() * Get Balance = getBalance() *  * Get Message By ID = getMessageByID($id) : if $id int = message id, if $id string = group id *  * Get Message By Status = getMessagesByStatus($status, $deviceID = null, $simID = null, $time = null, $endTimestamp = null) * Get messages "received" on SIM 1 of device ID 8 in last 24 hours = getMessagesByStatus("Received", 8, 0, time() - 86400) *  * Get USSD Request By ID = getUssdRequestByID($id) * Get USSD requests with request text "*150#" sent in last 24 hours. = getUssdRequests("*150#", null, null, time() - 86400) *  * Add a new contact to contacts list 1 or resubscribe the contact if it already exists. = addContact(1, "+11234567890", "Test", true); * Unsubscribe a contact using the mobile number. = unsubscribeContact(1, "+11234567890"); *  */echojson_encode($configuration->getDevices(), JSON_PRETTY_PRINT);

📤 Send Single SMS

useRootscratch\SMS\Send;
$sendMessage = newSend();
$send_single = $sendMessage->sendSingleMessage('mobile_number', 'Message');
echojson_encode($send_single, JSON_PRETTY_PRINT);

📥 Send Bulk Message

$send_bulk = $sendMessage->sendMessages([
[
"number" => "6391234567890",
"message" => "Message 1"
],
[
"number" => "6391234567891",
"message" => "Message 2"
]
]);
echojson_encode($send_bulk, JSON_PRETTY_PRINT);

🖼️ Send MMS Sample

• Use All Sims = sendMessages(messages = array, option = USE_ALL_SIMS)
• Use All Devices = sendMessages(messages = array, option = USE_ALL_DEVICES)
• Use Specified Devices = sendMessages(messages = array, option = USE_SPECIFIED, devices = array)

/** * Send MMS Sample * Use All Sims = sendMessages(messages = array, option = USE_ALL_SIMS) * Use All Devices = sendMessages(messages = array, option = USE_ALL_DEVICES) * Use Specified Devices = sendMessages(messages = array, option = USE_SPECIFIED, devices = array) */$send_bulk_mms = $sendMessage->sendMessages([
[
"number" => "639123456789",
"message" => "Test 1",
"type" => "mms",
"attachments" => 'https://sample.com/1.png'
],
[
"number" => "639123456789",
"message" => "Test 2",
"type" => "mms",
"attachments" => 'https://sample.com/1.png'
]
]);
echojson_encode($send_bulk_mms, JSON_PRETTY_PRINT);

📇 Send Message To Contacts List

Send a message on schedule to contacts in contacts list with ID of 1.

$sendMessage->sendMessageToContactsList(1, "Test", null, null, strtotime("+2 minutes"));

Send a message to contacts in contacts list with ID of 1.

$send_contact_list = $sendMessage->sendMessageToContactsList(
1,
'Via Contact List!',
Configuration::USE_SPECIFIED,
[4]
);
echojson_encode($send_contact_list, JSON_PRETTY_PRINT);

📲 Send USSD Request

Send a USSD request using the default SIM of Device ID 1.

$send_ussd = $sendMessage->sendUssdRequest('*150#', 1);
echojson_encode($send_ussd, JSON_PRETTY_PRINT);

Send a USSD request using SIM in slot 1 of Device ID 1.

$send_ussd = $sendMessage->sendUssdRequest('*150#', 1, 0);
echojson_encode($send_ussd, JSON_PRETTY_PRINT);

Send a USSD request using SIM in slot 2 of Device ID 1.

$send_ussd = $sendMessage->sendUssdRequest('*150#', 1, 1);
echojson_encode($send_ussd, JSON_PRETTY_PRINT);

🔄 Resend SMS

/** * Resend SMS Sample * Resend Message By ID = resendMessageByID(id = int) * Resend Messages By Group ID = resendMessagesByGroupID(group_id = string, status = string) */useRootscratch\SMS\Resend;
$resend = newResend();
$resend_by_id = $resend->resendMessagesByGroupID('MZ7QabWteHWfSkjkgX67acc67bcc2048.73874662', 'Failed');
echojson_encode($resend_by_id, JSON_PRETTY_PRINT);

🛠️ Support

For support, please email me at jaycee@rootscratch.com.