شرح كيفية إرسال رسالة نموذجية باستخدام طلب POST مع WhatsApp API من Whats360

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

ما هي الرسالة النموذجية (Template Message)؟

الرسالة النموذجية هي رسالة مُعدة مسبقًا يتم الموافقة عليها من قبل WhatsApp. تُستخدم عادةً لإرسال رسائل تلقائية مثل إشعارات التسليم، تأكيدات الحجوزات، أو العروض الترويجية. هذه الرسائل يجب أن تكون متوافقة مع سياسات WhatsApp ولا يمكن أن تحتوي على محتوى تفاعلي مباشر من المستخدم.

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

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

• حساب WhatsApp Business API: يمكنك الحصول عليه من خلال مزودي خدمات WhatsApp API مثل Whats360.
• API Keys: المفتاح الخاص بك للوصول إلى API.
• Client ID: معرف العميل الخاص بك.
• Template ID: معرف النموذج الذي تمت الموافقة عليه من قبل WhatsApp.

خطوات إرسال رسالة نموذجية باستخدام طلب POST

1. إعداد الطلب (Request)

لإرسال رسالة نموذجية، سنستخدم POST Request مع البيانات التالية:

• client_id: معرف العميل.
• mobile: رقم الهاتف المستلم (بالتنسيق الدولي، مثل 919999999999).
• templet_id: معرف النموذج الذي تريد إرساله.
• API Keys: المفتاح الخاص بك للوصول إلى API.

2. الكود البرمجي

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

باستخدام Node.js

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

async function sendTemplateMessage() {
    const url = 'https://toggaar.whats360.live/api/user/v2/send_templet';
    const clientId = 'CLIENT_ID'; // استبدل بمعرف العميل الخاص بك
    const mobile = '919999999999'; // استبدل برقم الهاتف المستلم
    const templateId = 1; // استبدل بمعرف النموذج الخاص بك
    const token = 'YOUR_API_KEYS'; // استبدل بمفتاح API الخاص بك

    const body = {
        client_id: clientId,
        mobile: mobile,
        templet_id: templateId
    };

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

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

        if (!response.ok) {
            throw new Error('Request failed');
        }

        const data = await response.json();
        console.log('Response:', data);
    } catch (error) {
        console.error('Error:', error);
    }
}

sendTemplateMessage();
    

باستخدام Python

import requests
import json

def send_template_message():
    url = 'https://toggaar.whats360.live/api/user/v2/send_templet'
    client_id = 'CLIENT_ID'  # استبدل بمعرف العميل الخاص بك
    mobile = '919999999999'  # استبدل برقم الهاتف المستلم
    template_id = 1  # استبدل بمعرف النموذج الخاص بك
    token = 'YOUR_API_KEYS'  # استبدل بمفتاح API الخاص بك

    body = {
        'client_id': client_id,
        'mobile': mobile,
        'templet_id': template_id
    }

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

    try:
        response = requests.post(url, headers=headers, json=body)
        response.raise_for_status()  # يرفع استثناء إذا كان هناك خطأ في الطلب
        data = response.json()
        print('Response:', data)
    except requests.exceptions.RequestException as error:
        print('Error:', error)

send_template_message();
    

باستخدام PHP

function sendTemplateMessage() {
    $url = 'https://toggaar.whats360.live/api/user/v2/send_templet';
    $clientId = 'CLIENT_ID'; // استبدل بمعرف العميل الخاص بك
    $mobile = '919999999999'; // استبدل برقم الهاتف المستلم
    $templateId = 1; // استبدل بمعرف النموذج الخاص بك
    $token = 'YOUR_API_KEYS'; // استبدل بمفتاح API الخاص بك

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

    $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 'Error: Unable to send message.';
    } else {
        $data = json_decode($response, true);
        echo 'Response: ';
        print_r($data);
    }
}

sendTemplateMessage();
    

باستخدام 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 SendTemplateMessage();
    }

    static async Task SendTemplateMessage()
    {
        var url = "https://toggaar.whats360.live/api/user/v2/send_templet";
        var clientId = "CLIENT_ID"; // استبدل بمعرف العميل الخاص بك
        var mobile = "919999999999"; // استبدل برقم الهاتف المستلم
        var templateId = 1; // استبدل بمعرف النموذج الخاص بك
        var token = "YOUR_API_KEYS"; // استبدل بمفتاح API الخاص بك

        var body = new
        {
            client_id = clientId,
            mobile = mobile,
            templet_id = templateId
        };

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

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

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

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

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

4. نصائح لتحسين الأداء

• تحقق من صحة البيانات: تأكد من أن جميع الحقول المطلوبة (مثل client_id, mobile, templet_id) صحيحة وقبل إرسال الطلب.
• إدارة الأخطاء: قم بمعالجة الأخطاء بشكل صحيح لتجنب تعطل التطبيق.
• اختبار النماذج: قبل الإرسال الفعلي، تأكد من أن النموذج معتمد من قبل WhatsApp ويعمل كما هو متوقع.

الخاتمة

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

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