دليل شامل لاستخدام WhatsApp API من موقع Whats360: الحصول على API Keys وإرسال الرسائل

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

ما هو WhatsApp API؟

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

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

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

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

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

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

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();
    

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();
    

3. إرسال رسالة نموذج (Template) باستخدام PHP

function sendTextMessage() {
    $url = 'https://toggaar.whats360.live/api/user/v2/send_templet';
    
    $body = [
        'client_id' => 'CLIENT_ID', // استبدلها بـ Client ID الخاص بك
        'mobile' => '919999999999', // رقم الهاتف المستهدف
        'templet_id' => 1,          // معرّف النموذج (Template ID)
    ];
    
    $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();
    

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();
    

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

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

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

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

• WhatsApp API
• Whats360
• API Keys
• إرسال رسائل WhatsApp
• Node.js
• Python
• PHP
• C#
• رسائل نماذج (Templates)

الخلاصة

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

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