Guide d'intégration de l'API SMS pour la RDC : Documentation complète pour les développeurs

import requests

API_TOKEN = "your_api_token_here"
API_URL = "https://api2.smsala.com/SendSmsV2"

def send_sms(to, message, sender_id="DRCNotify"):
    payload = [
        {
            "apiToken": API_TOKEN,
            "messageType": 1,        # 1=Promotional, 2=Transactional, 3=OTP
            "messageEncoding": 1,     # 1=Default
            "destinationAddress": to, # Format: 243990000000 (no + prefix)
            "sourceAddress": sender_id,
            "messageText": message
        }
    ]

    response = requests.post(API_URL, json=payload)
    return response.json()

# Send SMS
result = send_sms("243990000000", "Bonjour! Votre code OTP est: 123456")
print(result)
# Response: [{"MessageId": 25, "OperationCode": 0, "Status": "Success", ...}]

const axios = require('axios');

const API_TOKEN = 'your_api_token_here';
const API_URL = 'https://api2.smsala.com/SendSmsV2';

async function sendSMS(to, message) {
  try {
    const response = await axios.post(API_URL, [
      {
        apiToken: API_TOKEN,
        messageType: 1,        // 1=Promotional, 2=Transactional, 3=OTP
        messageEncoding: 1,    // 1=Default
        destinationAddress: to, // Format: 243990000000 (no + prefix)
        sourceAddress: 'DRCNotify',
        messageText: message
      }
    ]);

    return response.data;
  } catch (error) {
    console.error('Error sending SMS:', error.response?.data);
    throw error;
  }
}

// Send SMS
sendSMS('243990000000', 'Bonjour! Votre code OTP est: 123456')
  .then(result => console.log(result));
// Response: [{"MessageId": 25, "OperationCode": 0, "Status": "Success", ...}]

<?php

$apiToken = 'your_api_token_here';
$apiUrl = 'https://api2.smsala.com/SendSmsV2';

function sendSMS($to, $message) {
    global $apiToken, $apiUrl;

    $data = array(
        array(
            'apiToken' => $apiToken,
            'messageType' => 1,        // 1=Promotional, 2=Transactional, 3=OTP
            'messageEncoding' => 1,    // 1=Default
            'destinationAddress' => $to, // Format: 243990000000 (no + prefix)
            'sourceAddress' => 'DRCNotify',
            'messageText' => $message
        )
    );

    $ch = curl_init($apiUrl);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
    curl_setopt($ch, CURLOPT_HTTPHEADER, array(
        'Content-Type: application/json'
    ));

    $response = curl_exec($ch);
    curl_close($ch);

    return json_decode($response, true);
}

// Send SMS
$result = sendSMS('243990000000', 'Bonjour! Votre code OTP est: 123456');
print_r($result);

?>

// Node.js Bulk SMS Example
// Send to multiple recipients by passing an array of message objects

async function sendBulkSMS(recipients) {
  const messages = recipients.map(r => ({
    apiToken: API_TOKEN,
    messageType: 1,        // 1=Promotional, 2=Transactional, 3=OTP
    messageEncoding: 1,
    destinationAddress: r.to,  // Format: 243990000000 (no + prefix)
    sourceAddress: 'DRCNotify',
    messageText: r.message
  }));

  const response = await axios.post(
    'https://api2.smsala.com/SendSmsV2',
    messages
  );

  return response.data;
}

// Usage
const recipients = [
  { to: '243990000001', message: 'Message for customer 1' },
  { to: '243990000002', message: 'Message for customer 2' },
  { to: '243990000003', message: 'Message for customer 3' }
];

sendBulkSMS(recipients).then(result => console.log(result));

// Send OTP via SMSala API (messageType 3 = OTP)
async function sendOTP(phoneNumber, otpCode) {
  const response = await axios.post(
    'https://api2.smsala.com/SendSmsV2',
    [
      {
        apiToken: API_TOKEN,
        messageType: 3,          // 3 = OTP message
        messageEncoding: 1,
        destinationAddress: phoneNumber, // Format: 243990000000
        sourceAddress: 'DRCNotify',
        messageText: `Votre code OTP est: ${otpCode}. Valide 5 minutes.`,
        callBackUrl: 'https://yourapp.com/webhooks/sms-delivery'
      }
    ]
  );

  // Store the MessageId for delivery tracking
  return response.data[0].MessageId;
}

// Generate and send OTP
const otp = Math.floor(100000 + Math.random() * 900000).toString();
const messageId = await sendOTP('243990000000', otp);
// Store otp + messageId in your database for later verification

// Verify OTP: compare the code the user enters against what you stored.
// Delivery confirmation comes via webhook callback or DLR check:
// GET https://api2.smsala.com/Dlr/GetDetails?apiToken=YOUR_TOKEN&messageId=MESSAGE_ID

async function checkDeliveryStatus(messageId) {
  const response = await axios.get(
    'https://api2.smsala.com/Dlr/GetDetails', {
      params: {
        apiToken: API_TOKEN,
        messageId: messageId
      }
    }
  );

  return response.data;
  // Returns delivery report with status details
}

// Express.js webhook endpoint for SMSala delivery callbacks
// Set callBackUrl in your SendSmsV2 request to receive these
app.post('/webhooks/sms-delivery', (req, res) => {
  const delivery = req.body;

  console.log(`Message ${delivery.messageId} status: ${delivery.status}`);
  console.log(`DLR Status: ${delivery.dlrStatus}`);
  console.log(`Delivered to: ${delivery.destinationAddress}`);
  console.log(`Remarks: ${delivery.remarks}`);

  // Update your database
  updateMessageStatus(delivery.messageId, delivery.dlrStatus);

  res.status(200).send('OK');
});

// Example webhook payload:
// {
//   "messageId": 22,
//   "operationCode": 0,
//   "status": "Success",
//   "dlrStatus": "Delivered",
//   "destinationAddress": "243990000000",
//   "remarks": "Dlr Status is : Delivered"
// }