Hypersender SMS Webhooks
The Hypersender SMS API offers a webhook-based integration that delivers real-time, event-driven notifications. This allows developers to monitor their connected phones (sms app) or respond to specific events.- Monitor Message Status: Provides real-time updates on the status of sent messages, such as when the message is queued to be sent or has been successfully delivered.
- Receive Incoming Messages: Get notified when a new message is received on the connected phone.
- Monitor Connected Phone: Receive periodic heartbeats from your connected phone to ensure the connection is active and act when the phone is offline.
Configure the webhook
1
Open your instance settings
Sign in to the Hypersender dashboard and open the settings for the instance connected to your Android phone.
2
Set the webhook URL
Paste the public HTTPS endpoint that should receive the events. Hypersender POSTs a JSON payload to this URL for every event.
3
Acknowledge quickly
Reply with a 2xx status as soon as you receive the payload. If your handler needs more time, queue the payload and process it in the background.
Events
Best practices
- Handle each event idempotently, keyed on the message or heartbeat identifier in the payload.
- Keep the handler fast: persist the payload first, then do the slow work asynchronously.
- Log every payload for at least a few days so you can replay events while integrating.
- Alert on
heartbeat-offlineand repeatedmessage-failedevents — both usually mean the phone needs attention.
Next steps
Receiving SMS Messages
End-to-end flow for handling inbound replies.
Handle webhooks in Laravel
Use the SDK’s webhook controller and job instead of writing raw handlers.