أمثلة متقدمة لاستخدام WhatsApp API من موقع Whats360

أمثلة متقدمة لاستخدام WhatsApp API من موقع Whats360

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

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

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

  • حساب 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. إرسال رسالة نصية مع متغيرات

يمكنك إرسال رسالة نصية تحتوي على متغيرات لتحسين تجربة المستخدم. على سبيل المثال، يمكنك إرسال رسالة ترحيبية تحتوي على اسم المستلم.

باستخدام 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 = 'مرحبًا {{1}}، شكرًا لتواصلك معنا!'; // النص المراد إرساله
    const token = 'YOUR_API_KEYS'; // استبدل بمفتاح API الخاص بك

    const body = {
        client_id: clientId,
        mobile: mobile,
        text: text,
        variables: JSON.stringify({
            "1": "محمد" // استبدل بالقيمة المطلوبة
        })
    };

    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();
        console.log('Response:', data);
    } catch (error) {
        console.error('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 = 'مرحبًا {{1}}، شكرًا لتواصلك معنا!'  # النص المراد إرساله
    token = 'YOUR_API_KEYS'  # استبدل بمفتاح API الخاص بك

    body = {
        'client_id': client_id,
        'mobile': mobile,
        'text': text,
        'variables': json.dumps({
            "1": "محمد"  # استبدل بالقيمة المطلوبة
        })
    }

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

    try:
        response = requests.post(url, headers=headers, json=body)
        data = response.json()
        print('Response:', data)
    except requests.exceptions.RequestException as error:
        print('Error:', error)

send_message()
    

2. إرسال رسالة مع مرفقات (صور، مستندات)

يمكنك إرسال رسالة تحتوي على مرفقات مثل الصور أو المستندات.

باستخدام PHP


function sendMessageWithAttachment() {
    $url = 'https://toggaar.whats360.live/api/user/v2/send_message';
    $clientId = 'CLIENT_ID'; // استبدل بمعرف العميل الخاص بك
    $mobile = '919999999999'; // استبدل برقم الهاتف المستلم
    $text = 'مرحبًا، هذه صورة من منتجاتنا.'; // النص المراد إرساله
    $token = 'YOUR_API_KEYS'; // استبدل بمفتاح API الخاص بك
    $attachmentUrl = 'https://example.com/image.jpg'; // رابط المرفق

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

    $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);
    }
}

sendMessageWithAttachment();
    

3. إرسال رسالة نموذجية مع متغيرات

يمكنك إرسال رسالة نموذجية تحتوي على متغيرات لتحسين تجربة المستخدم.

باستخدام 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,
            variables = new
            {
                "1": "محمد" // استبدل بالقيمة المطلوبة
            }
        };

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

نصائح للاستخدام المتقدم

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

الخاتمة

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

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


Leave a comment

لن يتم نشر عنوان بريدك الإلكتروني. الحقول الإلزامية مشار إليها بـ *