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

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

ما هي الاستجابة الناجحة في WhatsApp API؟

عند إرسال رسالة عبر 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. إرسال الرسالة والحصول على الاستجابة

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

2. تفسير الاستجابة الناجحة

الاستجابة الناجحة تأتي بتنسيق JSON وتحتوي على الحقول التالية:

• success: يشير إلى نجاح العملية (true).
• message: وصف نصي للاستجابة.
• 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);
        } 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'))
        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'];
        } else {
            echo 'Error: ' . $data['message'];
        }
    }
}

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);
                }
                else
                {
                    Console.WriteLine("Error: " + data.message);
                }
            }
            catch (Exception error)
            {
                Console.WriteLine("Network Error: " + error.Message);
            }
        }
    }
}
    

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

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

الخاتمة

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

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