دليل شامل لإرسال رسائل نصية باستخدام WhatsApp API من واتس 360

في عالم الأعمال الحديث، أصبحت تطبيقات المراسلة الفورية مثل WhatsApp أداة أساسية للتواصل مع العملاء. إذا كنت تبحث عن طريقة لإرسال رسائل WhatsApp برمجيًا، فإن واتس 360 يقدم واجهة برمجة تطبيقات (API) قوية تتيح لك إرسال رسائل نصية بسهولة. في هذا المقال، سنتعرف على كيفية استخدام WhatsApp API من واتس 360 لإرسال رسائل نصية باستخدام لغات برمجة مختلفة مثل JavaScript (Node.js)، Python، PHP، و C#.

ما هو WhatsApp API؟

واجهة برمجة التطبيقات (API) الخاصة بـ WhatsApp تسمح للمطورين بدمج إمكانيات إرسال الرسائل في تطبيقاتهم أو أنظمتهم. باستخدام WhatsApp API، يمكنك إرسال رسائل نصية، صور، فيديوهات، وحتى رسائل نماذج (Templates) للعملاء بشكل تلقائي.

الخطوة الأولى: الحصول على API Keys من واتس 360

قبل البدء في استخدام WhatsApp API، تحتاج إلى الحصول على API Keys من منصة واتس 360. اتبع الخطوات التالية:

إنشاء حساب على واتس 360:
- قم بزيارة موقع واتس 360 وأنشئ حسابًا جديدًا إذا لم يكن لديك حساب مسبقًا.
الوصول إلى لوحة التحكم:
- بعد تسجيل الدخول، انتقل إلى لوحة التحكم (Dashboard) الخاصة بحسابك.
إنشاء تطبيق جديد:
- في لوحة التحكم، ابحث عن قسم “API Keys” أو “تطبيقات API”.
- قم بإنشاء تطبيق جديد واحصل على API Key الخاص بك.
تفعيل API Key:
- تأكد من تفعيل المفتاح (API Key) لبدء استخدامه في إرسال الرسائل.

الخطوة الثانية: إرسال رسائل نصية باستخدام WhatsApp API

بعد الحصول على API Key، يمكنك البدء في إرسال الرسائل النصية. سنستعرض كيفية إرسال رسائل نصية باستخدام لغات برمجة مختلفة.

1. إرسال رسالة نصية باستخدام Node.js


const fetch = require('node-fetch');

async function sendTextMessage() {
    const url = 'https://toggaar.whats360.live/api/user/v2/send_message';
  
    const body = {
      client_id: 'CLIENT_ID', // استبدلها بـ Client ID الخاص بك
      mobile: '919999999999', // رقم الهاتف المستهدف
      text: 'Hello world', // النص المراد إرساله
    };
  
    const token = 'YOUR_API_KEYS'; // استبدلها بـ API Key الخاص بك
  
    const headers = {
      'Content-Type': 'application/json',
      Authorization: `Bearer ${token}`,
    };
  
    try {
      const response = await fetch(url, {
        method: 'POST',
        headers,
        body: JSON.stringify(body),
      });
  
      if (!response.ok) {
        throw new Error('Request failed');
      }
  
      const data = await response.json();
      console.log(data); // عرض الاستجابة
    } catch (error) {
      console.error(error);
    }
}
  
sendTextMessage();

شرح الكود:

يتم إرسال طلب POST إلى الـ API مع إضافة البيانات (client_id, mobile, text) في جسم الطلب (body).
يتم استخدام Authorization header لإرسال الـ API Key.

2. إرسال رسالة نصية باستخدام Python


import requests

def send_text_message():
    url = 'https://toggaar.whats360.live/api/user/v2/send_message'
    
    body = {
        'client_id': 'CLIENT_ID',  # استبدلها بـ Client ID الخاص بك
        'mobile': '919999999999',  # رقم الهاتف المستهدف
        'text': 'Hello world',     # النص المراد إرساله
    }
    
    token = 'YOUR_API_KEYS'  # استبدلها بـ API Key الخاص بك
    
    headers = {
        'Content-Type': 'application/json',
        'Authorization': f'Bearer {token}',
    }
    
    try:
        response = requests.post(url, headers=headers, json=body)
        
        if not response.ok:
            raise Exception('Request failed')
        
        data = response.json()
        print(data)  # عرض الاستجابة
    except Exception as error:
        print(error)

send_text_message();

شرح الكود:

يتم إرسال طلب POST باستخدام مكتبة requests في Python.
يتم إضافة الـ API Key في Authorization header.

3. إرسال رسالة نصية باستخدام PHP


function sendTextMessage() {
    $url = 'https://toggaar.whats360.live/api/user/v2/send_message';
    
    $body = [
        'client_id' => 'CLIENT_ID', // استبدلها بـ Client ID الخاص بك
        'mobile' => '919999999999', // رقم الهاتف المستهدف
        'text' => 'Hello world',    // النص المراد إرساله
    ];
    
    $token = 'YOUR_API_KEYS'; // استبدلها بـ API Key الخاص بك
    
    $headers = [
        'Content-Type: application/json',
        'Authorization: Bearer ' . $token,
    ];
    
    try {
        $curl = curl_init($url);
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
        curl_setopt($curl, CURLOPT_POST, true);
        curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode($body));
        
        $response = curl_exec($curl);
        
        if ($response === false) {
            throw new Exception(curl_error($curl));
        }
        
        $httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
        if ($httpCode >= 400) {
            throw new Exception('Request failed');
        }
        
        $data = json_decode($response, true);
        print_r($data); // عرض الاستجابة
    } catch (Exception $error) {
        echo $error->getMessage();
    }
}

sendTextMessage();

شرح الكود:

يتم إرسال طلب POST باستخدام cURL في PHP.
يتم إضافة الـ API Key في Authorization header.

4. إرسال رسالة نصية باستخدام C#


using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Threading.Tasks;

public static async Task SendTextMessage()
{
    var url = "https://toggaar.whats360.live/api/user/v2/send_message";
    
    var body = new
    {
        client_id = "CLIENT_ID", // استبدلها بـ Client ID الخاص بك
        mobile = "919999999999", // رقم الهاتف المستهدف
        text = "Hello world"     // النص المراد إرساله
    };
    
    var token = "YOUR_API_KEYS"; // استبدلها بـ API Key الخاص بك
    
    using (var client = new HttpClient())
    {
        client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token);
        client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
        
        try
        {
            var response = await client.PostAsJsonAsync(url, body);
            
            if (!response.IsSuccessStatusCode)
            {
                throw new Exception("Request failed");
            }
            
            var data = await response.Content.ReadAsAsync();
            Console.WriteLine(data); // عرض الاستجابة
        }
        catch (Exception error)
        {
            Console.WriteLine(error);
        }
    }
}

await SendTextMessage();

شرح الكود:

يتم إرسال طلب POST باستخدام HttpClient في C#.
يتم إضافة الـ API Key في Authorization header.

استجابة ناجحة

عند نجاح إرسال الرسالة، ستتلقى استجابة JSON تحتوي على تفاصيل العملية:


{
  "success": true,
  "message": "The message has been successfully sent.",
  "data": {}
}

الكلمات المفتاحية

WhatsApp API
واتس 360
إرسال رسائل WhatsApp
Node.js
Python
PHP
C#
رسائل نصية

الخلاصة

باستخدام واتس 360 API، يمكنك بسهولة إرسال رسائل WhatsApp برمجيًا. سواء كنت تستخدم Node.js، Python، PHP، أو C#، فإن العملية بسيطة وفعّالة. تأكد من الحصول على API Keys الصحيحة واتباع الخطوات المذكورة أعلاه لبدء إرسال الرسائل بسلاسة.

إذا كانت لديك أي أسئلة أو تحتاج إلى مزيد من التوضيحات، فلا تتردد في التواصل معنا.