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

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

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

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

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

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

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

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

خطوات التعامل مع الاستجابات

1. إرسال الرسالة والحصول على الاستجابة

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

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

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

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

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

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

مثال للاستجابة الفاشلة:

{
  "success": false,
  "message": "Invalid API key.",
  "data": {}
}
    

الكود البرمجي للتعامل مع الاستجابات

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

باستخدام Node.js

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

async function sendMessage() {
    const url = 'https://apis.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://apis.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://apis.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://apis.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 أو استشارة الوثائق الرسمية.