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 واحدة فقط.
url_media	رابط ملف الوسائط الذي تريد إرساله عبر واتساب. يجب أن يبدأ بـ https:// وتشير إلى صحة ملف بي دي إف, وثيقة أو صورة ملف. يجب أن يكون الملف متاحًا للعامة دون مصادقة. التنسيقات المدعومة: وثائق: pdf، xml، doc، docx، odt، rtf، txt، tex، xls، xlsx، csv، ods، ppt، pptx، odp، zip، rar، 7z، tar، gz الصور: jpg، jpeg، png
url_media_shorted	إذا كانت القيمة هي نعم، وإذا تم تعيين [pdf_with_image=yes]، فسيتم عرض رابط التنزيل لملف PDF من خلال عنوان URL قصير.
pdf_with_image	إذا كانت القيمة هي نعمسيتم عرض معاينة صورة لملف PDF لمرافقة الرسالة (فقط إذا كان الملف عبارة عن ملف PDF).
encrypt_message	نعم =سيتم تشفير الرسالة عند قراءتها من قبل المستلم. سيحتاج المستلم إلى إدخال مفتاح فريد لفك تشفير الرسالة. تعرف على المزيد حول تشفير الرسائل

مثال بدون وسائط :


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

مثال مع الوسائط:


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

تنسيق النص في الواتس اب :

مائل: استخدم الشرطة السفلية → _text_
عريض: استخدم علامات النجمة → *النص*
شطب: استخدم علامات التلدة → ~النص~
مسافة واحدة: استخدم علامات الاقتباس العكسية → ```النص```

على سبيل المثال: _مرحبا_ بالعالم، كيف حالك اليوم من ```SMSMobileAPI```

إعادة إرسال رسائل WhatsApp غير المرسلة

يتم استخدام نقطة نهاية واجهة برمجة التطبيقات هذه لإعادة إرسال رسالة غير مرسلة (فقط إذا كانت الرسالة تحتوي على حالة خطأ)

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

يحصل بريد https://api.smsmobileapi.com/resendwa/

المعلمة:

المعلمة	وصف
guid	مطلوب GUID للرسالة التي سيتم إعادة إرسالها.

مثال:


        احصل على https://api.smsmobileapi.com/resendwa/?apikey=YOUR_API_KEY&guid=GUID_OF_THE_MESSAGE

المزامنة لاسترجاع الرسالة

يتم استخدام نقطة نهاية واجهة برمجة التطبيقات هذه لإرسال طلب لمزامنة رسائل 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	مطلوب مفتاح API الذي لديك أو سوف تتلقاه.
before	قم بتمرير الطابع الزمني كمعلمة وعرض السجلات أسفل هذا الطابع الزمني.
date	(yyyy-mm-dd) احصل على جميع السجلات بناءً على التاريخ.
message_type	اتركه فارغًا لرؤية جميع الرسائل (النصية والصوتية) يستخدم `نص` لرؤية الرسائل النصية فقط يستخدم `صوتي` لرؤية الرسائل الصوتية فقط المحولة إلى نص

مثال:


        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 والمطور

سجل الأدوات والتغييرات

وثائق واتساب

أرسل واتساب

إعادة إرسال الرسالة

المزامنة

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

المصادقة

إرسال API WhatsApp

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

حدود:

مثال بدون وسائط :

مثال مع الوسائط:

تنسيق النص في الواتس اب :

إعادة إرسال رسائل WhatsApp غير المرسلة

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

المعلمة:

مثال:

المزامنة لاسترجاع الرسالة

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

المعلمة:

مثال:

رد :

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

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

المعلمة:

مثال:

رد :

المصادقة

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

2. مصادقة OAuth2

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

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

Which Method Should You Use?

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

عنوان URL لـ WSDL

حدود:

مثال

أرسل واتساب

أمر cURL الأساسي

مثال cURL في PHP

أرسل واتساب

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

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

أرسل واتساب

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

استخدام `XMLHttpRequest`

أرسل واتساب

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

أرسل واتساب

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