Dev DOC WhatsApp - SMSMobileAPI

وثائق واتساب

تتعلق هذه الوثيقة بإرسال واستقبال رسائل WhatsApp.

انقر هنا لمعرفة المزيد حول جميع الميزات التي يوفرها تكامل WhatsApp الخاص بنا.

في SMSmobileAPI، نسعى جاهدين لجعل واجهة برمجة التطبيقات الخاصة بنا متوافقة قدر الإمكان مع أي بنية أو منصة.
سواء كنت تستخدم REST أو SOAP أو cURL أو لغات برمجة مختلفة مثل Python أو JavaScript أو PHP والمزيد، فإن واجهة برمجة التطبيقات الخاصة بنا مصممة للتكامل بسلاسة في مشاريعك.

لدينا أيضًا مكونات إضافية جاهزة للاستخدام لحلول وبرامج التجارة الإلكترونية. انقر هنا لاكتشافهم.

واجهة برمجة التطبيقات REST

cURL

جافا سكريبت

بايثون

نود.جي اس

روبي

WSDL

إرسال API WhatsApp

يتم استخدام نقطة نهاية API هذه لإرسال رسائل WhatsApp.

نقطة النهاية:

GET POST https://api.smsmobileapi.com/sendsms

حدود:

- apikey:مفتاح API الفريد الخاص بك.

- recipients: رقم هاتف المستلم (يجب أن يكون الرقم متاحًا على WhatsApp). أدخل رقم الهاتف الذي يبدأ برمز الدولة (بدون "+" وبدون "00")، متبوعًا مباشرة ببقية رقمك. مثال 191728660

- message:الرسالة المراد إرسالها (أسطر متعددة ممكنة).

- waonly:يجب أن يكون لها القيمة نعم -> مطلوب تحديد أنه يجب إرسال رسالة WhatsApp واحدة فقط

مثال:


        GET https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEYY&waonly=yes&recipients=191728660&message=Hello%20World

المزامنة

يتم استخدام نقطة نهاية واجهة برمجة التطبيقات هذه لإرسال طلب لمزامنة رسائل WhatsApp واسترجاعها.
هذه الخطوة إلزامية ويجب تنفيذها قبل استدعاء نقطة النهاية التي تسترجع الرسائل.

نقطة النهاية:

GET https://api.smsmobileapi.com/getwa/synchronisation/

المعلمة:

- apikey (required): مفتاح API الذي لديك أو سوف تتلقاه.

مثال:


        GET https://api.smsmobileapi.com/getwa/synchronisation/?apikey=YOUR_API_KEY

رد :



{


 "خطأ": "0"،

   "الرسائل": "متزامنة"،

  "تنتهي صلاحيتها في 2025-03-11 12:27:00"،

  "تنتهي صلاحيتها في يونكس": "1741692420"،


 

}

استرجاع رسالة WhatsApp

يتم استخدام نقطة نهاية واجهة برمجة التطبيقات هذه لاسترداد رسائل WhatsApp المستلمة.

نقطة النهاية:

GET https://api.smsmobileapi.com/getwa

المعلمة:

- apikey (required): مفتاح API الذي لديك أو سوف تتلقاه.

- before (optional): قم بتمرير الطابع الزمني كمعلمة وعرض السجلات أسفل هذا الطابع الزمني.

- date (optional): (yyyy-mm-dd) احصل على جميع السجلات بناءً على التاريخ.

مثال:


        GET https://api.smsmobileapi.com/getwa/?apikey=YOUR_API_KEY

رد :



{


  "التاريخ": "2025-03-11"،

  "الساعة": "12:27:00"،

  "الطابع الزمني": "1741692420"،

  "الرقم": "19176728660"،

  "اتصل بنا": "Smsmobileapi"،

  "الرسالة": "هل يمكنك أن تخبرني متى سأستلم طلبي؟"

  "الدليل": "652fcfc0-12a8-46f5-b5ba-9391135b8b4c"،

  
  "أكثر": {

    "الرد التلقائي": "1"،

    "نقل إلى البريد الإلكتروني": "1"،

    "chatgpt_reply": "1"

	
  },


  "chatgpt": {

    "رموز المطالبة": "900"،

    "completion_tokens": "10"،

    "إجمالي الرموز": "910"،

    "إجمالي تكلفة الرموز": "0.182"

	 "الرد": "سيتم شحن طلبك #576 غدًا."

	
  }

    
  
}

المصادقة

تدعم واجهة برمجة تطبيقات SMSMobile طريقتين للمصادقة: استخدام مفتاح API بسيط أو بروتوكول OAuth2 مع معرف العميل وسر العميل.

1. مصادقة مفتاح API

لإرسال أو استلام رسائل واتساب عبر واجهة برمجة التطبيقات (API)، يلزم المصادقة باستخدام مفتاح API. يضمن هذا وصولاً آمنًا ومُصرَّحًا به إلى خدمة الرسائل. ما عليك سوى تضمين مفتاح API الخاص بك في طلب المصادقة وابدأ بإرسال الرسائل بسلاسة.

2. مصادقة OAuth2

يوفر OAuth2 طريقة مصادقة أكثر أمانًا وقابلة للتطوير.
سوف تحتاج إلى استخدام معرف العميل وسر العميل للحصول على رمز وصول، والذي يجب تضمينه بعد ذلك في طلبات واجهة برمجة التطبيقات الخاصة بك باستخدام التفويض رأس الصفحة.

معرف العميل وسر العميل متاحان في لوحة المعلومات الخاصة بك.

الحصول على رمز الوصول

للحصول على رمز وصول، أرسل طلب POST إلى نقطة نهاية الرمز باستخدام معرف العميل والسر الخاص بالعميل.


curl -X POST https://api.smsmobileapi.com/oauth2/token \

-H "Content-Type: application/x-www-form-urlencoded" \

-d "grant_type=client_credentials" \

-d "client_id=1ab0ex4b4c1ef2c800690d" \

-d "client_secret=3ed108a93d0414074b94364290b6a7348475e93a0567005"

استخدام رمز الوصول:

بمجرد حصولك على رمز الوصول، قم بتضمينه في التفويض رأس طلبات واجهة برمجة التطبيقات الخاصة بك:


curl -X POST https://api.smsmobileapi.com/sendsms?waonly=yes \

-H "Authorization: Bearer abc123xyz456" \

-H "Content-Type: application/x-www-form-urlencoded" \

-d "recipients=+1234567890" \

-d "message=Hello"

Which Method Should You Use?

- Use API Key Authentication for quick and straightforward integrations.

- Use OAuth2 Authentication for enhanced security and scalability in your integrations.

إرسال رسالة واتس اب

عنوان URL لـ WSDL

https://api.smsmobileapi.com/sendsms/wsdl/sendsms.wsdl

حدود:

- recipients: رقم الهاتف المحمول للمستلم.

- message: الرسالة المراد إرسالها.

- apikey: مفتاح API الذي لديك أو سوف تتلقاه.

- waonly: يجب أن يكون لها القيمة نعم -> مطلوب تحديد أنه يجب إرسال رسالة WhatsApp واحدة فقط.

مثال


                require_once "lib/nusoap.php";

                

                $client = new nusoap_client("https://api.smsmobileapi.com/sendsms/wsdl/sendsms.wsdl", true);

                $error  = $client->getError();

                

                $result = $client->call("sendSms", array("waonly" =>"yes","recipients" =>$_GET['recipients'],"message" =>$_GET['message'],"apikey" =>$_GET['apikey']));

                

                print_r($result);

أرسل واتساب

أمر cURL الأساسي

بإمكانك استخدام أمر cURL التالي لإرسال رسالة WhatsApp عبر SMSmobileAPI:


        curl -X POST https://api.smsmobileapi.com/sendsms/?waonly=yes \

        -d "recipients=PHONE_NUMBER" \

        -d "message=YOUR_MESSAGE" \

        -d "apikey=YOUR_API_KEY"

مثال cURL في PHP

إذا كنت تستخدم PHP، فإليك كيفية إرسال رسالة WhatsApp باستخدام cURL:


        <?php

        

        $url = 'https://api.smsmobileapi.com/sendsms/?waonly=yes';

        $data = array(

            'recipients' => 'PHONE_NUMBER',

            'message' => 'YOUR_MESSAGE',

            'apikey' => 'YOUR_API_KEY'


        );

        

        $options = array(

            CURLOPT_URL => $url,

            CURLOPT_POST => true,

            CURLOPT_POSTFIELDS => http_build_query($data),

            CURLOPT_RETURNTRANSFER => true,

        );

        

        $ch = curl_init();

        curl_setopt_array($ch, $options);

        $response = curl_exec($ch);

        curl_close($ch);

        

        echo $response;

        

        ?>

يوضح مثال PHP هذا كيفية إرسال طلب POST باستخدام cURL إلى SMSmobileAPI، وتمرير المعلمات الضرورية كمصفوفة ارتباطية.

أرسل واتساب

استخدم وحدة Python الرسمية الخاصة بنا: https://smsmobileapi.com/python/
أو استخدم الطريقة اليدوية ...

استخدام مكتبة `requests`

مكتبة `requests` هي مكتبة HTTP شائعة وبسيطة للغة Python. وإليك كيفية استخدامها لإرسال رسالة WhatsApp عبر SMSmobileAPI:


        import requests



        url = "https://api.smsmobileapi.com/sendsms/waonly=yes"



        payload = {

            "recipients": "PHONE_NUMBER",

            "message": "YOUR_MESSAGE",

            "apikey": "YOUR_API_KEY"

        }



        response = requests.post(url, data=payload)



        print(response.text)

يوضح هذا المثال طلب POST بسيطًا إلى SMSmobileAPI، لإرسال رسالة WhatsApp إلى رقم هاتف محدد.

استخدام مكتبة `http.client`

تعتبر المكتبة `http.client` مضمنة في مكتبة Python القياسية ويمكن أيضًا استخدامها للتفاعل مع واجهة برمجة التطبيقات الخاصة بك:


        import http.client

        import urllib.parse



        conn = http.client.HTTPSConnection("api.smsmobileapi.com")



        params = urllib.parse.urlencode({

            "recipients": "PHONE_NUMBER",

            "message": "YOUR_MESSAGE",

            "apikey": "YOUR_API_KEY"

        })



        headers = { "Content-type": "application/x-www-form-urlencoded" }



        conn.request("POST", "/sendsms/?waonly=yes", params, headers)

        response = conn.getresponse()

        data = response.read()



        print(data.decode("utf-8"))

        conn.close()

يوضح هذا المثال كيفية استخدام مكتبة `http.client` لإرسال طلب POST إلى واجهة برمجة التطبيقات. يتم ترميز المعلمات بصيغة URL وإرسالها مع الرؤوس المناسبة.

أرسل واتساب

استخدام واجهة برمجة التطبيقات `fetch`

تُعد واجهة برمجة التطبيقات "fetch" طريقة حديثة ومتعددة الاستخدامات لإرسال طلبات HTTP في JavaScript. وإليك كيفية استخدامها لإرسال رسالة WhatsApp عبر واجهة برمجة تطبيقات SMSmobile:


        const url = "https://api.smsmobileapi.com/sendsms/?waonly=yes";



        const data = {

            recipients: "PHONE_NUMBER",

            message: "YOUR_MESSAGE",

            apikey: "YOUR_API_KEY"

        };



        fetch(url, {

            method: "POST",

            headers: {

                "Content-Type": "application/x-www-form-urlencoded"

            },

            body: new URLSearchParams(data)

        })

        .then(response => response.text())

        .then(result => console.log(result))

        .catch(error => console.error("Error:", error));

يوضح هذا المثال كيفية إرسال طلب POST باستخدام واجهة برمجة التطبيقات `fetch`، والتي تدعمها معظم المتصفحات الحديثة.

استخدام `XMLHttpRequest`

إذا كنت بحاجة إلى دعم المتصفحات القديمة، فيمكنك استخدام الكائن `XMLHttpRequest`:


        const xhr = new XMLHttpRequest();

        const url = "https://api.smsmobileapi.com/sendsms/?waonly=yes";



        const data = "recipients=PHONE_NUMBER&message=YOUR_MESSAGE&apikey=YOUR_API_KEY";



        xhr.open("POST", url, true);

        xhr.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");



        xhr.onreadystatechange = function() {

            if (xhr.readyState === 4 && xhr.status === 200) {

                console.log(xhr.responseText);

            }

        };



        xhr.send(data);

يوضح هذا المثال كيفية استخدام `XMLHttpRequest` لإرسال طلب POST، مما يوفر التوافق مع المتصفحات القديمة التي قد لا تدعم `fetch`.

أرسل واتساب

استخدام مكتبة `axios`

تُعد مكتبة `axios` عميل HTTP شائعًا لـ Node.js. وإليك كيفية استخدامها لإرسال رسالة WhatsApp عبر SMSmobileAPI:


        const axios = require('axios');



        const url = 'https://api.smsmobileapi.com/sendsms/?waonly=yes';

        const data = {

            recipients: 'PHONE_NUMBER',

            message: 'YOUR_MESSAGE',

            apikey: 'YOUR_API_KEY'

        };



        axios.post(url, data)

        .then(response => {

            console.log(response.data);

        })

        .catch(error => {

            console.error('Error:', error);

        });

يوضح هذا المثال كيفية إرسال طلب POST باستخدام `axios` في Node.js للتفاعل مع SMSmobileAPI.

أرسل واتساب

استخدام مكتبة `Net::HTTP`

بإمكانك استخدام مكتبة `Net::HTTP` في Ruby لإرسال رسالة WhatsApp عبر SMSmobileAPI:


        require 'net/http'

        require 'uri'



        uri = URI.parse("https://api.smsmobileapi.com/sendsms/?waonly=yes")

        request = Net::HTTP::Post.new(uri)

        request.set_form_data(

            "recipients" => "PHONE_NUMBER",

            "message" => "YOUR_MESSAGE",

            "apikey" => "YOUR_API_KEY"

        )



        req_options = {

            use_ssl: uri.scheme == "https",

        }



        response = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|

            http.request(request)

        end



        puts response.body

يوضح هذا المثال كيفية إرسال طلب POST باستخدام `Net::HTTP` في Ruby إلى SMSmobileAPI.

ومن الممكن أيضا إرسال رسالة WhatsApp ورسالة نصية قصيرة في نفس الوقت.

إذا كان لديك أي أسئلة أو اقتراحات أو تحتاج إلى مساعدة، فإن فريقنا هنا لمساعدتك.
لا تتردد في التواصل معنا على api@smsmobileapi.com

وثائق واتساب

أرسل واتساب

المزامنة

استرجاع الرسائل

المصادقة

إرسال API WhatsApp

نقطة النهاية:

حدود:

مثال:

المزامنة

نقطة النهاية:

المعلمة:

مثال:

رد :

استرجاع رسالة WhatsApp

نقطة النهاية:

المعلمة:

مثال:

رد :

المصادقة

1. مصادقة مفتاح API

2. مصادقة OAuth2

الحصول على رمز الوصول

استخدام رمز الوصول:

Which Method Should You Use?

إرسال رسالة واتس اب

عنوان URL لـ WSDL

حدود:

مثال

أرسل واتساب

أمر cURL الأساسي

مثال cURL في PHP

أرسل واتساب

استخدام مكتبة `requests`

استخدام مكتبة `http.client`

أرسل واتساب

استخدام واجهة برمجة التطبيقات `fetch`

استخدام `XMLHttpRequest`

أرسل واتساب

استخدام مكتبة `axios`

أرسل واتساب

استخدام مكتبة `Net::HTTP`