REST API Documentation

{
  "event": "sms.status_update",
  "data": {
    "id": "cm1a2b3c40001xyz",
    "status": "sent",
    "numbers": "94771234567",
    "serverRef": "ref-987654"
  },
  "timestamp": "2026-09-09T06:40:00.000Z"
}

const express = require('express');
const crypto = require('crypto');
const app = express();

app.use(express.json());

// Webhook listener endpoint
app.post('/webhooks/smsgo', (req, res) => {
  const signature = req.headers['x-smsgo-signature'];
  const apiKey = process.env.SMSGO_API_KEY;

  // Optional: Cryptographically verify webhook authenticity
  if (signature && apiKey) {
    const expected = crypto
      .createHmac('sha256', apiKey)
      .update(JSON.stringify(req.body))
      .digest('hex');

    if (signature !== expected) {
      return res.status(401).json({ error: 'Invalid webhook signature' });
    }
  }

  const { event, data } = req.body;
  if (event === 'sms.status_update') {
    const { id, status, numbers, serverRef, error } = data;

    if (status === 'sent') {
      console.log(`SMS ${id} to ${numbers} delivered! Carrier Ref: ${serverRef}`);
      // Update database: status = 'sent'
    } else if (status === 'failed') {
      console.error(`SMS ${id} to ${numbers} failed: ${error}`);
      // Handle failure / alert
    }
  }

  // Acknowledge receipt
  res.status(200).json({ received: true });
});

app.listen(3000, () => console.log('Webhook server listening on port 3000'));

namespace App\Notifications\Channels;

use Illuminate\Notifications\Notification;
use Illuminate\Support\Facades\Http;

class SmsGoChannel
{
    public function send($notifiable, Notification $notification)
    {
        $message = $notification->toSmsGo($notifiable);
        $to = $notifiable->routeNotificationFor('smsgo') ?? $notifiable->phone;

        if (!$to) {
            return;
        }

        Http::withHeaders([
            'X-API-Key' => config('services.smsgo.key'),
            'Content-Type' => 'application/json',
        ])->post('https://api.smsgo.lk/api/v1/sms/send', [
            'to' => $to,
            'message' => $message,
            'mask' => config('services.smsgo.mask', 'SMSGO'),
        ]);
    }
}

const express = require('express');
const app = express();
app.use(express.json());

app.post('/api/send-alert', async (req, res) => {
  const { phoneNumber, alertText } = req.body;

  try {
    const result = await sendSMS(phoneNumber, alertText);
    res.json({ success: true, data: result.data });
  } catch (error) {
    res.status(500).json({ success: false, error: 'SMS dispatch failed' });
  }
});