دليل شامل لشرح مفهوم الرسائل النموذجية وكيفية استخدامها في WhatsApp API من واتس 360

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

ما هي الرسائل النموذجية (Templates)؟

الرسائل النموذجية هي رسائل معتمدة من WhatsApp يتم إعدادها مسبقًا وإرسالها إلى العملاء. تُستخدم هذه الرسائل في حالات محددة مثل:

• إشعارات الترحيب: لإرسال رسائل ترحيبية عند انضمام عميل جديد.
• التذكيرات: لتذكير العملاء بالمواعيد أو الفواتير المستحقة.
• التحديثات: لإرسال تحديثات حول الطلبات أو الشحنات.
• العروض الترويجية: لإرسال عروض خاصة أو خصومات للعملاء.

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

لماذا نستخدم الرسائل النموذجية؟

• الالتزام بسياسات WhatsApp: يجب استخدام الرسائل النموذجية عند إرسال رسائل غير مطلوبة من العميل (Outbound Messages).
• تخصيص المحتوى: يمكن إضافة متغيرات ديناميكية لتخصيص الرسائل لكل عميل.
• تحسين تجربة العميل: الرسائل النموذجية تكون أكثر احترافية ومنظمة، مما يعزز تجربة العميل.

كيفية إنشاء رسالة نموذجية في واتس 360

1. تسجيل الدخول إلى واتس 360:
   • قم بزيارة موقع واتس 360 وقم بتسجيل الدخول إلى حسابك.
2. الوصول إلى قسم القوالب:
   • انتقل إلى قسم إدارة القوالب في لوحة التحكم.
3. إنشاء قالب جديد:
   • اختر إنشاء قالب جديد وأدخل التفاصيل المطلوبة مثل:
     • اسم القالب: اسم يصف الغرض من القالب.
     • نص القالب: المحتوى الأساسي للرسالة.
     • المتغيرات: أجزاء من النص يمكن استبدالها بقيم ديناميكية.
4. إرسال القالب للموافقة:
   • بعد إنشاء القالب، يتم إرساله إلى WhatsApp للموافقة عليه. قد تستغرق هذه العملية بضع ساعات.

كيفية إرسال رسالة نموذجية باستخدام WhatsApp API

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

1. إرسال رسالة نموذجية باستخدام Node.js

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

async function sendTemplateMessage() {
    const url = 'https://toggaar.whats360.live/api/user/v2/send_templet';
  
    const body = {
      client_id: 'CLIENT_ID', // استبدلها بـ Client ID الخاص بك
      mobile: '919999999999', // رقم الهاتف المستهدف
      templet_id: 1,          // معرّف القالب (Template ID)
      variables: {            // المتغيرات (اختياري)
        name: 'John',
        order_id: '12345'
      }
    };
  
    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);
    }
}
  
sendTemplateMessage();
    

شرح الكود:

• يتم إرسال طلب POST إلى الـ API مع إضافة البيانات (client_id, mobile, templet_id, variables) في جسم الطلب (body).
• يتم استخدام Authorization header لإرسال الـ API Key.

2. إرسال رسالة نموذجية باستخدام Python

import requests

def send_template_message():
    url = 'https://toggaar.whats360.live/api/user/v2/send_templet'
    
    body = {
        'client_id': 'CLIENT_ID',  # استبدلها بـ Client ID الخاص بك
        'mobile': '919999999999',  # رقم الهاتف المستهدف
        'templet_id': 1,           # معرّف القالب (Template ID)
        'variables': {             # المتغيرات (اختياري)
            'name': 'John',
            'order_id': '12345'
        }
    }
    
    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_template_message();
    

شرح الكود:

• يتم إرسال طلب POST باستخدام مكتبة requests في Python.
• يتم إضافة الـ API Key في Authorization header.

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

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

sendTemplateMessage();
    

شرح الكود:

• يتم إرسال طلب POST باستخدام cURL في PHP.
• يتم إضافة الـ API Key في Authorization header.

4. إرسال رسالة نموذجية باستخدام C#

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

public static async Task SendTemplateMessage()
{
    var url = "https://toggaar.whats360.live/api/user/v2/send_templet";
    
    var body = new
    {
        client_id = "CLIENT_ID", // استبدلها بـ Client ID الخاص بك
        mobile = "919999999999", // رقم الهاتف المستهدف
        templet_id = 1,          // معرّف القالب (Template ID)
        variables = new           // المتغيرات (اختياري)
        {
            name = "John",
            order_id = "12345"
        }
    };
    
    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 SendTemplateMessage();
    

شرح الكود:

• يتم إرسال طلب POST باستخدام HttpClient في C#.
• يتم إضافة الـ API Key في Authorization header.

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

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

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

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

• الرسائل النموذجية
• WhatsApp API
• واتس 360
• إرسال رسائل WhatsApp
• Node.js
• Python
• PHP
• C#
• إدارة القوالب
• إرسال رسائل تلقائية
• متغيرات الرسائل
• إشعارات الترحيب
• تذكيرات العملاء
• عروض ترويجية

الخلاصة

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

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