SMS Webhook Handling & Events (v1)

Overview

In this guide, we will cover how to handle incoming SMS webhooks and events using the Hypersender Laravel SDK. Webhooks are a powerful way to receive real-time updates from SMS, allowing your application to respond to messages, status changes, and other events as they happen.

Setting Up Webhooks

The package auto-registers a POST route (default /sms/webhook).
Verifies the signature using the secret in config/env.
Dispatches a dedicated Laravel event for each webhook event type (e.g., MessagesUpserted, GroupsUpdated, etc.).
Listen for events in your app:

use Hypersender\Events\Sms\MessagePhoneSent;

Event::listen(MessagePhoneSent::class, function ($event) {
    $event->payload
});

See the Webhook Usage in it’s dedicated section for more details webhook usage.

Available Webhook Events

The following events are available for handling sms webhooks:

Hypersender\Events\Sms\MessagePhoneSent
Hypersender\Events\Sms\MessageCallMissed
Hypersender\Events\Sms\MessageNotificationScheduled
Hypersender\Events\Sms\MessagePhoneDelivered
Hypersender\Events\Sms\MessagePhoneReceived
Hypersender\Events\Sms\MessageSendExpired
Hypersender\Events\Sms\MessageSendFailed
Hypersender\Events\Sms\PhoneHeartbeatDisabled
Hypersender\Events\Sms\PhoneHeartbeatOnline
Hypersender\Events\Sms\PhoneHeartbeatOffline
Hypersender\Events\Sms\PhoneHeartbeatMissed
Hypersender\Events\Sms\PhoneHeartbeatReceived

Customizing the Webhook Route

To customize the webhook route, you can publish the package’s configuration file and modify the webhook_route setting:

php artisan vendor:publish --tag="hypersender-config"

Then, update the sms_webhook_route in config/hypersender-config.php:

'sms_webhook_route' => 'your/custom/route',

​Overview

​Setting Up Webhooks

​Available Webhook Events

​Customizing the Webhook Route

Overview

Setting Up Webhooks

Available Webhook Events

Customizing the Webhook Route