شرح هيكل الاستجابة الناجحة في WhatsApp API من موقع Whats360

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

ما هو هيكل الاستجابة الناجحة؟

عند إرسال رسالة عبر WhatsApp API، ستتلقى استجابة من الخادم (Server Response) تحتوي على معلومات حول حالة الإرسال. الاستجابة الناجحة تعني أن الرسالة تم إرسالها بنجاح إلى المستلم. هذه الاستجابة تأتي عادةً بتنسيق JSON وتشمل حقولًا مثل:

• success: يشير إلى نجاح العملية (true).
• message: وصف نصي للاستجابة.
• data: بيانات إضافية قد تحتوي على تفاصيل إضافية حول العملية.

مثال للاستجابة الناجحة:

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

المتطلبات الأساسية

قبل البدء، تأكد من أن لديك:

• حساب WhatsApp Business API: يمكنك الحصول عليه من خلال مزودي خدمات WhatsApp API مثل Whats360.
• API Keys: المفتاح الخاص بك للوصول إلى API.
• Client ID: معرف العميل الخاص بك.
• Endpoint URL: عنوان URL الخاص بـ API (مثل https://toggaar.whats360.live/api/user/v2/send_message).

شرح هيكل الاستجابة الناجحة

1. الحقل `success`

هذا الحقل يشير إلى نجاح العملية. إذا كانت القيمة true، فهذا يعني أن الرسالة تم إرسالها بنجاح. إذا كانت القيمة false، فهذا يعني أن هناك خطأ ما في العملية.

2. الحقل `message`

هذا الحقل يحتوي على وصف نصي للاستجابة. في حالة النجاح، قد يكون النص مثل “The message has been successfully sent.” في حالة الفشل، قد يحتوي على رسالة خطأ توضح سبب الفشل.

3. الحقل `data`

هذا الحقل يحتوي على بيانات إضافية قد تكون فارغة في بعض الحالات أو تحتوي على تفاصيل إضافية حول العملية.

الكود البرمجي لفهم هيكل الاستجابة الناجحة

سنقدم أمثلة برمجية بلغات مختلفة لإرسال رسالة وفهم هيكل الاستجابة الناجحة.

باستخدام Node.js

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

async function sendMessage() {
    const url = 'https://toggaar.whats360.live/api/user/v2/send_message';
    const clientId = 'CLIENT_ID'; // استبدل بمعرف العميل الخاص بك
    const mobile = '919999999999'; // استبدل برقم الهاتف المستلم
    const text = 'Hello world'; // النص المراد إرساله
    const token = 'YOUR_API_KEYS'; // استبدل بمفتاح API الخاص بك

    const body = {
        client_id: clientId,
        mobile: mobile,
        text: text
    };

    const headers = {
        'Content-Type': 'application/json',
        'Authorization': `Bearer ${token}`
    };

    try {
        const response = await fetch(url, {
            method: 'POST',
            headers: headers,
            body: JSON.stringify(body)
        });

        const data = await response.json();

        // فهم هيكل الاستجابة الناجحة
        if (data.success) {
            console.log('Success:', data.message);
            console.log('Data:', data.data);
        } else {
            console.error('Error:', data.message);
        }
    } catch (error) {
        console.error('Network Error:', error);
    }
}

sendMessage();
    

باستخدام Python

import requests
import json

def send_message():
    url = 'https://toggaar.whats360.live/api/user/v2/send_message'
    client_id = 'CLIENT_ID'  # استبدل بمعرف العميل الخاص بك
    mobile = '919999999999'  # استبدل برقم الهاتف المستلم
    text = 'Hello world'  # النص المراد إرساله
    token = 'YOUR_API_KEYS'  # استبدل بمفتاح API الخاص بك

    body = {
        'client_id': client_id,
        'mobile': mobile,
        'text': text
    }

    headers = {
        'Content-Type': 'application/json',
        'Authorization': f'Bearer {token}'
    }

    try {
        response = requests.post(url, headers=headers, json=body)
        data = response.json()

        // فهم هيكل الاستجابة الناجحة
        if data.get('success'):
            print('Success:', data.get('message'))
            print('Data:', data.get('data'))
        else:
            print('Error:', data.get('message'))
    except requests.exceptions.RequestException as error:
        print('Network Error:', error)

send_message()
    

باستخدام PHP

function sendMessage() {
    $url = 'https://toggaar.whats360.live/api/user/v2/send_message';
    $clientId = 'CLIENT_ID'; // استبدل بمعرف العميل الخاص بك
    $mobile = '919999999999'; // استبدل برقم الهاتف المستلم
    $text = 'Hello world'; // النص المراد إرساله
    $token = 'YOUR_API_KEYS'; // استبدل بمفتاح API الخاص بك

    $body = [
        'client_id' => $clientId,
        'mobile' => $mobile,
        'text' => $text
    ];

    $headers = [
        'Content-Type: application/json',
        'Authorization: Bearer ' . $token
    ];

    $options = [
        'http' => [
            'header' => implode("\r\n", $headers),
            'method' => 'POST',
            'content' => json_encode($body)
        ]
    ];

    $context = stream_context_create($options);
    $response = file_get_contents($url, false, $context);

    if ($response === FALSE) {
        echo 'Network Error: Unable to send message.';
    } else {
        $data = json_decode($response, true);

        // فهم هيكل الاستجابة الناجحة
        if ($data['success']) {
            echo 'Success: ' . $data['message'] . "\n";
            echo 'Data: ' . json_encode($data['data']) . "\n";
        } else {
            echo 'Error: ' . $data['message'] . "\n";
        }
    }
}

sendMessage();
    

باستخدام C#

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

class Program
{
    static async Task Main()
    {
        await SendMessage();
    }

    static async Task SendMessage()
    {
        var url = "https://toggaar.whats360.live/api/user/v2/send_message";
        var clientId = "CLIENT_ID"; // استبدل بمعرف العميل الخاص بك
        var mobile = "919999999999"; // استبدل برقم الهاتف المستلم
        var text = "Hello world"; // النص المراد إرساله
        var token = "YOUR_API_KEYS"; // استبدل بمفتاح API الخاص بك

        var body = new
        {
            client_id = clientId,
            mobile = mobile,
            text = text
        };

        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);
                var data = await response.Content.ReadAsAsync();

                // فهم هيكل الاستجابة الناجحة
                if (data.success)
                {
                    Console.WriteLine("Success: " + data.message);
                    Console.WriteLine("Data: " + data.data);
                }
                else
                {
                    Console.WriteLine("Error: " + data.message);
                }
            }
            catch (Exception error)
            {
                Console.WriteLine("Network Error: " + error.Message);
            }
        }
    }
}
    

نصائح لفهم هيكل الاستجابة الناجحة

• تحقق من نجاح العملية: استخدم الحقل success لتحديد ما إذا كانت العملية ناجحة أم لا.
• سجل الاستجابات: قم بتسجيل الاستجابات لأغراض التحليل والمراجعة لاحقًا.
• اختبار النماذج: تأكد من أن النماذج معتمدة من قبل WhatsApp قبل استخدامها.
• إدارة الأخطاء: تعامل مع الأخطاء بشكل صحيح، سواء كانت أخطاء في الشبكة أو أخطاء من الخادم.

الخاتمة

فهم هيكل الاستجابة الناجحة في WhatsApp API من Whats360 هو جزء أساسي من عملية أتمتة التواصل مع العملاء. من خلال فهم كيفية تفسير الاستجابات وأخذ الإجراءات المناسبة، يمكنك تحسين تجربة العملاء وضمان نجاح عمليات الإرسال.

إذا كنت تبحث عن مزيد من التفاصيل أو لديك أسئلة، فلا تتردد في التواصل مع فريق دعم Whats360 أو استشارة الوثائق الرسمية.