راهنمای ارسال پیامک با NodeJs

کتابخانه ارسال پیامک NodeJs با وب سرویس قاصدک

وب‌سرویس پیام کوتاه قاصدک، یک سرویس ارسال و دریافت پیام کوتاه از طریق REST API برای ارسال پیامک‌های وب‌سرویسی است.

تلاش قاصدک روی این سرویس بر ارائه‌ی خدمات با کیفیت، قابل اتکا و ساده به کاربرانش هست. در این قسمت راهنمای ساده برای ارسال و دریافت پیامک از طریق کتابخونه قاصدک برای nodejs آماده کردیم.

نحوه نصب کتابخانه nodejs

کتابخونه ghasedak رو به سادگی می توانید از روی npm نصب کنید :

    
     npm install ghasedaksms

همچنین از طریق yarn می توانید نصب کنید :

    
        yarn install ghasedaksms

نحوه استفاده از کتابخانه نصب شده

برای استفاده از این کتابخونه، بعد از نصب کافیه تو کد پروژتون اون رو ایمپورت کنید:

    
        const Ghasedak = require('ghasedaksms');
        const apikey='';
        const receptor = '09359610015';
        const line = '30005088';
        let ghasedak = new Ghasedak(apiKey);

سپس می توانید به سادگی پیام خود را به شماره مورد نظر ارسال کنید :

    
        async function sendSimpleSms() {
        const simpleSmsCommand = {
        sendDate: "2024-07-09T18:45:09.902Z",
        message: 'Test message',
        receptor:  '093****',
        linenumber: '3000****',
        clientReferenceId: "your_unique_reference_id",
        udh: false
        };
        const simpleSmsResponse = await ghasedak.sendSimpleSms(simpleSmsCommand);
        }

ارسال گروهی

    
        async function sendBulkSms() {
        const bulkSmsCommand = {
        message: 'Bulk message',
        receptors: ['093*****', '09xxxxxxxxx'],
        linenumber: '3000****'
        };
        const bulkSmsResponse = await ghasedak.sendBulkSms(bulkSmsCommand);
        }

ارسال پیامک اعتبار سنجی (otp)

    
        async function sendOtpSms() {
        const otpSmsCommand = {
        sendDate: '2024-07-09T20:03:25.658Z',
        receptors: [
        {
        mobile: '0935******',
        clientReferenceId: 'your_unique_reference_id'
        }
        ],
        templateName: 'newOTP',
        inputs: [
        {
        param: 'Code',
        value: 'strisng'
        },
        {
        param: 'Name',
        value: 'strddisng' '
        }
        ],
        udh: true
        };

        try {
        const otpSmsResponse = await ghasedak.sendOtpSms(otpSmsCommand);
        } catch (error) {
        console.error('Error sending OTP SMS:', error.message);
        }
        }

قاصدک در گیت هاب

با استفاده از این کتابخونه می توانید از عملیات های مختلفی مثل ارسال پیامک‌های ساده، ارسال پیامک otp، ارسال پیامک گروهی و سایر خدمات قاصدک استفاده کنید. برای اینکار می توانید به صفحه‌ی کتابخونه روی گیت هاب سری بزنید و البته مستندات وبسرویس قاصدک هم می تواند راه استفاده از قاصدک برای زبان های برنامه نویسی مختلف رو برای شما ساده تر نماید.

Ghasedak fo nodejs

Ghasedak sms webservice package for nodejs

Installation

You can simply install and use ghasedak nodejs library from npm:

    
        npm install --save ghasedaksms

or from yarn:

    
        yarn install ghasedaksms

Usage

Import ghasedak package:

    
        const Ghasedak = require('ghasedaksms');

You need a Ghasedak account. Register and get your API key.

Create an instance from Ghasedak class with your API key:

Instance

 
    
        const apikey='';
        const receptor = '0935*****';
        const line = '3000****';
        let ghasedak = new Ghasedak(apiKey);

Send Simple SMS

 
    
        async function sendSimpleSms() {
        const simpleSmsCommand = {
        sendDate: "2024-07-09T18:45:09.902Z",
        message: 'Test message',
        receptor:  '0935*****',
        linenumber: '3000****',
        clientReferenceId: "your_unique_reference_id",
        udh: false
        };
        const simpleSmsResponse = await ghasedak.sendSimpleSms(simpleSmsCommand);
        }

Send Bulk SMS

 
    
        async function sendBulkSms() {
        const bulkSmsCommand = {
        message: 'Bulk message',
        receptors: ['0935*****', '09xxxxxxxxx'],
        linenumber: '3000*****'
        };
        const bulkSmsResponse = await ghasedak.sendBulkSms(bulkSmsCommand);
        }

Send Verification SMS

 
    
        async function sendOtpSms() {
        const otpSmsCommand = {
        sendDate: '2024-07-09T20:03:25.658Z',
        receptors: [
        {
        mobile: '0935******',
        clientReferenceId: 'your_unique_reference_id'
        }
        ],
        templateName: 'newOTP',
        inputs: [
        {
        param: 'Code',
        value: 'strisng'
        },
        {
        param: 'Name',
        value: 'strddisng' '
        }
        ],
        udh: true
        };

        try {
        const otpSmsResponse = await ghasedak.sendOtpSms(otpSmsCommand);
        } catch (error) {
        console.error('Error sending OTP SMS:', error.message);
        }
        }

Done!