Unique-Notify Developer Documentation

Unique-Notify is an enterprise-grade multi-gateway communication engine providing automated OTP delivery, transactional notifications, and marketing broadcasts via WhatsApp. The platform offers a unified REST API across both official Meta Cloud API and Baileys Multi-Device QR Socket gateways.

Authentication

All API requests to Unique-Notify must include an active API Key. You can pass your key via either the x-api-key HTTP header or the standard Authorization: Bearer header.

Quick Start (cURL)

Send your first automated message in seconds with this minimal cURL request:

curl -X POST "http://localhost:3000/api/v1/messages/send-text" \
  -H "Content-Type: application/json" \
  -H "x-api-key: un_live_8f3a9b2c1d4e5f6a7b8c9d0e1f2a3b4c" \
  -d '{
    "phone": "8801700000000",
    "message": "Hello! Your hosting invoice #10492 has been generated.",
    "gateway": "meta"
  }'

{
  "success": true,
  "message": "Message sent successfully",
  "gateway": "meta",
  "logId": 482,
  "metaMessageId": "wamid.HBgM..."
}

One-Time Password (OTP) API

Unique-Notify features an automated OTP generator with lifecycle tracking, custom expiration windows, and instant verification endpoints.

{
  "phone": "8801700000000",
  "serviceName": "Star Hosting Login",
  "length": 6,
  "expiryMinutes": 5,
  "gateway": "meta"
}

{
  "phone": "8801700000000",
  "otp": "492015"
}

Send Text & Media Messages

Send rich text notifications, invoices, PDF receipts, or promotional images with captions.

{
  "phone": "8801700000000",
  "mediaUrl": "https://example.com/invoices/inv-1042.pdf",
  "caption": "Your monthly web hosting invoice is attached.",
  "mediaType": "document",
  "fileName": "invoice-1042.pdf",
  "gateway": "meta"
}

SMS Gateway & Android Dual-SIM Routing

Send SMS using your own physical Android smartphone (with Dual-SIM SIM 1 / SIM 2 selection) or via 3rd-party aggregators (Greenweb BD, BulkSMSBD, Custom HTTP Webhook).

{
  "recipient": "8801700000000",
  "message": "Your verification code is 591024. Do not share this OTP with anyone.",
  "gateway_type": "android_sim", // 'android_sim', 'greenweb', 'bulksmsbd', 'custom_http'
  "sim_slot": 1 // 1 for SIM Slot 1, 2 for SIM Slot 2
}

// Response
{
  "success": true,
  "message": "SMS queued for Android SIM gateway dispatch",
  "data": {
    "job_id": "4",
    "status": "queued",
    "recipient": "8801700000000",
    "gateway": "android_sim",
    "sim_slot": 1
  }
}

WHMCS Hook Integration Guide

Unique-Notify includes a ready-to-use, zero-dependency WHMCS hook file located in integrations/whmcs/hooks/unique_notify.php.

define('UNIQUE_NOTIFY_API_URL', 'http://your-server:3000/api/v1');
define('UNIQUE_NOTIFY_API_KEY', 'un_live_8f3a9b2c1d4e5f6a7b8c9d0e1f2a3b4c');
define('UNIQUE_NOTIFY_GATEWAY', 'meta'); // or 'qr'

Standalone PHP SDK

For custom PHP web applications, Laravel, or CodeIgniter, use our lightweight SDK from integrations/php-sdk/UniqueNotify.php:

require_once __DIR__ . '/integrations/php-sdk/UniqueNotify.php';

use UniqueNotify\UniqueNotify;

$client = new UniqueNotify([
    'api_url' => 'http://localhost:3000/api/v1',
    'api_key' => 'un_live_8f3a9b2c1d4e5f6a7b8c9d0e1f2a3b4c',
    'gateway' => 'meta'
]);

// 1. Send OTP
$otpResponse = $client->sendOtp('8801700000000', 'Star Hosting Portal');

// 2. Verify OTP
$verifyResponse = $client->verifyOtp('8801700000000', '123456');

// 3. Send Text Notification
$client->sendText('8801700000000', 'Your order #5523 has been dispatched.');

// 4. Send Document / Invoice
$client->sendMedia('8801700000000', 'https://example.com/inv.pdf', 'Monthly Invoice', 'document');

Anti-Ban Engine & Spintax Guide

When sending through the QR gateway, Unique-Notify automatically implements multiple defensive behaviors to prevent WhatsApp spam flags.

Interactive API Console

Test live API dispatches directly in your browser without leaving this documentation portal.