Soap Asanak SMS Axios JavaScript

SoapAsanakSMSAxiosJS is a Node.js library for sending SMS messages through the Asanak SOAP SMS gateway using Axios.

It sends raw SOAP XML requests and provides full debugging logs, including both the outgoing SOAP request and the incoming SOAP response.

All credentials and configuration values can be easily managed through environment variables.

Table of Contents

• Features
• Installation
• Configuration
• Usage
• Example
• License

Features

• Simple, reusable Node.js library for Asanak SOAP SMS gateway
• Supports credentials from environment variables (.env)
• Logs raw XML request and response for debugging
• Configurable source number and SOAP web service URL
• Built using axios for HTTP requests

Installation

npm install soap-asanak-sms-axios

Or clone the repository:

git clone https://github.com/BaseMax/SoapAsanakSMSAxiosJS.git
cd SoapAsanakSMSAxiosJS
npm install

Configuration

Create a .env file in your project root:

ASANAK_USERNAME=your_username
ASANAK_PASSWORD=your_password
ASANAK_SOURCE_NUMBER=your_number
ASANAK_WEBSERVICE=https://smsapi.asanak.ir/services/CompositeSmsGateway?wsdl

The library will automatically load .env from the current folder or parent directory.

Usage

Using

const AsanakSms = require("soap-asanak-sms-axios");

const sms = new AsanakSms({});

Import and Initialize

const AsanakSms = require("./lib/AsanakSms");

const sms = new AsanakSms({});

Sending an SMS

(async () => {
  try {
    const response = await sms.send("989121111010", "سلام - این یک پیام تست است");
    console.log("Response:", response);
  } catch (err) {
    console.error("Failed to send SMS:", err.message);
  }
})();

Notes:

• send(destAddress, message) sends a single SMS.
• Logs will display raw request XML, response headers, and raw response XML.

Project Structure

SoapAsanakSMSAxiosJS/
├── lib/
│   └── AsanakSms.js       # Main library
├── tests/                 # Test scripts
├── .env                   # Environment variables
├── package.json
└── README.md

License

This project is licensed under the MIT License.

Copyright © 2025 Seyyed Ali Mohammadiyeh (Max Base)

MIT License