Messages Management - Hypersender

Overview

The Send Message Module in Hypersender’s Laravel SDK allows you to send and manage SMS messages programmatically. This guide provides a comprehensive overview of the available methods and how to use them effectively in your Laravel applications through your Android Phone.

Methods

Send SMS Message

Send a new SMS message to be sent by your android phone. (learn more)

Basic Usage
Parameters

use Hypersender\Hypersender;

Hypersender::sms()
  ->sendMessage(
      content: 'Hello, this is a test message!',
      requestId: 'e7b8a3c0-2d1a-4f9b-9f6c-1b2c3d4e5f6a',
      to: '+1234567890',
      // Optional parameters
      // scheduleSendAt: '2025-01-01 12:00:00',
      // maxSendAttempts: 3,
      // messageExpirationSeconds: 120,
    );

Parameter	Type	Required	Description
content	string	yes	The content of your SMS message
requestId	string	yes	A unique identifier you can later use to find this message (preferably a UUID)
to	string	yes	The recipient’s phone number (e.g. +201234567890)
scheduleSendAt	string	no	Optional date-time to schedule sending (e.g. 2025-01-01 12:00:00). You can schedule up to 3 days ahead (relative to your phone timezone).
maxSendAttempts	int	no	How many times to retry sending if it fails. Max: 15.
messageExpirationSeconds	int	no	Message validity window in seconds (useful for OTPs, e.g. 120 for 2 minutes).

List Messages

Retrieve a paginated list of messages with powerful filtering. (learn more)

Basic Usage
Basic Usage with Filters
Parameters

use Hypersender\Hypersender;

$response = Hypersender::sms()->messages();

use Hypersender\Hypersender;

$request = app(MessagesIndexRequest::class, [
    'perPage' => '50',
    'page' => '2',
    'sort' => '-updated_at',
    'include' => 'thread',
    'filter' => [
        'request_id' => 'e7b8a3c0-2d1a-4f9b-9f6c-1b2c3d4e5f6a',
        'status' => 'delivered',
        // other filters (check Parameters tab)
    ],
]);

$response = Hypersender::sms()->messages($request);

Parameter	Type	Required	Description
per_page	int	no	Number of items per page (max 50)
page	int	no	Page number to retrieve
sort	string	no	Sort fields (e.g. `updated_at` or `-updated_at` for desc)
include	string	no	Related resources to include (comma-separated)
filter[request_id]	string	no	Filter by your custom request id
filter[message_thread_id]	string	no	Filter by message thread id
filter[from_phone_number]	string	no	Filter by sender phone number
filter[to_phone_number]	string	no	Filter by recipient phone number
filter[content]	string	no	Filter by message content (search)
filter[status]	string	no	Filter by status (e.g. sent, delivered, failed, expired)
filter[type]	string	no	Filter by message type
filter[delivered_at]	string	no	Filter by delivered_at timestamp/range
filter[received_at]	string	no	Filter by received_at timestamp/range
filter[expired_at]	string	no	Filter by expired_at timestamp/range
filter[failed_at]	string	no	Filter by failed_at timestamp/range
filter[schedule_send_at]	string	no	Filter by scheduled send time
filter[created_at]	string	no	Filter by created_at timestamp/range
filter[updated_at]	string	no	Filter by updated_at timestamp/range

Delete Message

Delete a message by its ID. (learn more)

Basic Usage
Parameters

use Hypersender\Hypersender;

Hypersender::sms()->deleteMessage(
    messageId: 'msg_01HXYZABCDEF1234567'
);

​Overview

​Methods

​Send SMS Message

​List Messages

​Delete Message

Overview

Methods

Send SMS Message

List Messages

Delete Message