https://api.strongx.it.ao/v1

Authorization: Bearer strx_YOUR_API_KEY

# Use a SANDBOX key (strx_test_…). Nothing is charged or sent.
curl -X POST https://api.strongx.it.ao/v1/sms/send \
  -H "Authorization: Bearer strx_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "to": "+244900000000", "message": "Hello sandbox" }'

# +244900000000  → delivered
# +244900000001  → failed
# +244900000002  → sent (no delivery receipt)

curl -X POST https://api.strongx.it.ao/v1/sms/send \
  -H "Authorization: Bearer strx_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+244923456789",
    "message": "Hello from StrongX!",
    "applicationId": "YOUR_APP_ID"
  }'

{
  "success": true,
  "data": {
    "messageId": "7d1c2f9e-5b1a-4c6e-9a43-0f8f2b6d1e21",
    "status": "queued"
  }
}

curl -X POST https://api.strongx.it.ao/v1/sms/send-bulk \
  -H "Authorization: Bearer strx_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "recipients": [
      { "phone": "+244923456789", "name": "João" },
      { "phone": "+244912345678", "name": "Maria" }
    ],
    "message": "Hello from StrongX!",
    "applicationId": "YOUR_APP_ID"
  }'

{
  "success": true,
  "data": {
    "enqueued": 2,
    "totalCost": 10.0,
    "messages": [
      { "messageId": "…", "phone": "244923456789", "status": "queued" },
      { "messageId": "…", "phone": "244912345678", "status": "queued" }
    ]
  }
}

curl -X POST https://api.strongx.it.ao/v1/email/send \
  -H "Authorization: Bearer strx_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "user@example.com",
    "subject": "Hello from StrongX!",
    "htmlBody": "<h1>Hello!</h1><p>This is a test email.</p>",
    "textBody": "Hello! This is a test email.",
    "applicationId": "YOUR_APP_ID"
  }'

{
  "success": true,
  "data": {
    "messageId": "7d1c2f9e-5b1a-4c6e-9a43-0f8f2b6d1e21",
    "status": "queued"
  }
}

curl -X POST https://api.strongx.it.ao/v1/email/send-bulk \
  -H "Authorization: Bearer strx_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "recipients": ["user1@example.com", "user2@example.com"],
    "subject": "Hello from StrongX!",
    "htmlBody": "<h1>Hello!</h1><p>This is a bulk email.</p>",
    "applicationId": "YOUR_APP_ID"
  }'

{
  "success": true,
  "data": {
    "sent": 2,
    "failed": 0,
    "messages": [
      { "messageId": "…", "email": "ana@example.com", "status": "queued" },
      { "messageId": "…", "email": "rui@example.com", "status": "queued" }
    ]
  }
}

curl -X POST https://api.strongx.it.ao/v1/whatsapp/send \
  -H "Authorization: Bearer strx_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+244923456789",
    "message": "Hello from StrongX via WhatsApp!",
    "applicationId": "YOUR_APP_ID"
  }'

{
  "success": true,
  "data": {
    "messageId": "7d1c2f9e-5b1a-4c6e-9a43-0f8f2b6d1e21",
    "status": "queued"
  }
}

{
  "event": "message.delivered",
  "data": {
    "message_id": "7d1c2f9e-5b1a-4c6e-9a43-0f8f2b6d1e21",
    "channel": "sms",
    "status": "delivered",
    "to": "244923456789",
    "provider_name": "telco_sms",
    "error_message": null,
    "sandbox": false
  }
}

import crypto from 'node:crypto';

// rawBody: the request body exactly as received (Buffer)
function verifyStrongX(rawBody, header, secret, toleranceSec = 300) {
  const parts = Object.fromEntries(header.split(',').map((p) => p.split('=')));
  const timestamp = Number(parts.t);
  if (!timestamp || Math.abs(Date.now() / 1000 - timestamp) > toleranceSec) return false;

  const expected = crypto
    .createHmac('sha256', secret)
    .update(`${parts.t}.`)
    .update(rawBody)
    .digest('hex');

  return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(parts.v1 ?? ''));
}

// verifyStrongX(req.rawBody, req.get('X-StrongX-Signature-V2'), process.env.STRONGX_WEBHOOK_SECRET)

{
  "success": true,
  "data": {
    "id": "7d1c2f9e-5b1a-4c6e-9a43-0f8f2b6d1e21",
    "channel": "sms",
    "to": "244900000001",
    "status": "failed",
    "errorMessage": "Sandbox: simulated provider rejection",
    "cost": 0.0,
    "isSandbox": true,
    "createdAt": "2026-10-08T10:00:00+00:00",
    "updatedAt": "2026-10-08T10:00:01+00:00"
  }
}

{
  "error": "sandbox_recipient_not_allowed",
  "message": "Sandbox keys only accept test recipients: …"
}