دليل شامل لاستخدام واتساب API من واتس 360

1. مقدمة

1.1 ما هو واتساب API؟

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

1.2 مميزات واتس 360 API

منصة واتس 360 توفر واجهة برمجية متكاملة تتيح لك:

• إرسال رسائل نصية ووسائط متعددة.
• جدولة الرسائل لإرسالها في أوقات محددة.
• إدارة الحملات التسويقية بشكل فعال.
• تتبع تفاعل العملاء مع الرسائل.
• دمج API مع أنظمة أخرى مثل WordPress وShopify.

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

قبل البدء، تأكد من توفر المتطلبات التالية:

• API Keys و Client ID من واتس 360.
• بيئة برمجية جاهزة (Node.js, Python, PHP, C#).
• مكتبات برمجية مثل node-fetch لـ Node.js أو requests لـ Python.

2. إعداد البيئة

2.1 تثبيت الأدوات اللازمة

لبدء استخدام واتساب API، تحتاج إلى تثبيت الأدوات التالية:

• Node.js: يمكنك تنزيله من الموقع الرسمي.
• Python: يمكنك تنزيله من الموقع الرسمي.
• PHP: يمكنك تنزيله من الموقع الرسمي.
• C#: يمكنك استخدام Visual Studio من الموقع الرسمي.

2.2 الحصول على API Keys

للحصول على API Keys و Client ID، قم بالتسجيل في منصة واتس 360 من خلال رابط التسجيل. بعد التسجيل، ستتمكن من الوصول إلى لوحة التحكم حيث يمكنك إنشاء API Keys الخاصة بك.

3. إرسال رسالة نصية

3.1 إرسال رسالة نصية باستخدام GET Request

لإرسال رسالة نصية باستخدام طلب GET، يمكنك استخدام الكود التالي:

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

async function sendMessage() {
    const url = 'https://toggaar.whats360.live/api/v1/send-text';
    const token = 'YOUR_API_TOKEN';
    const instanceId = 'YOUR_INSTANCE_ID';
    const jid = '919999999999@s.whatsapp.net';
    const msg = 'مرحبًا، هذا تذكير بموعدك غدًا الساعة 10 صباحًا.';

    const queryParams = new URLSearchParams({ token, instance_id: instanceId, jid, msg });
    const apiUrl = `${url}?${queryParams}`;

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

sendMessage();

يمكنك أيضًا استخدام مولد أكواد واتساب API الشامل لإنشاء أكواد مخصصة بسهولة.

3.2 إرسال رسالة نصية باستخدام POST Request

لإرسال رسالة نصية باستخدام طلب POST، يمكنك استخدام الكود التالي:

import requests

def send_message():
    url = 'https://toggaar.whats360.live/api/v1/send-text'
    params = {
        'token': 'YOUR_API_TOKEN',
        'instance_id': 'YOUR_INSTANCE_ID',
        'jid': '919999999999@s.whatsapp.net',
        'msg': 'مرحبًا، هذا تذكير بموعدك غدًا الساعة 10 صباحًا.'
    }

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

send_message()

يمكنك أيضًا استخدام مولد أكواد واتساب API الشامل لإنشاء أكواد مخصصة بسهولة.

4. إرسال رسالة نموذج (Template Message)

4.1 ما هي الرسائل النموذجية؟

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

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

لإرسال رسالة نموذجية، يمكنك استخدام الكود التالي:

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

async function sendTemplateMessage() {
    const url = 'https://toggaar.whats360.live/api/v1/send-template';
    const token = 'YOUR_API_TOKEN';
    const instanceId = 'YOUR_INSTANCE_ID';
    const jid = '919999999999@s.whatsapp.net';
    const templateId = 'YOUR_TEMPLATE_ID';

    const response = await fetch(url, {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({ token, instance_id: instanceId, jid, template_id: templateId })
    });

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

sendTemplateMessage();

يمكنك أيضًا استخدام مولد أكواد واتساب API الشامل لإنشاء أكواد مخصصة بسهولة.

5. التعامل مع الاستجابات

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

عند إرسال رسالة ناجحة، ستتلقى استجابة بالشكل التالي:

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

5.2 التعامل مع الأخطاء

في حالة حدوث خطأ، قد تتلقى استجابة مثل:

{
  "success": false,
  "message": "Invalid API token.",
  "error_code": 401
}

6. أمثلة متقدمة

6.1 إرسال رسائل إلى عدة أرقام

يمكنك إرسال رسائل إلى قائمة من الأرقام باستخدام طلب POST مع مصفوفة من الأرقام.

6.2 إرسال رسائل مخصصة باستخدام المتغيرات

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

7. أفضل الممارسات

7.1 تأمين API Keys

تأكد من تخزين API Keys بشكل آمن باستخدام أدوات مثل Vault أو Environment Variables.

7.2 تحسين الأداء

استخدم التخزين المؤقت (Caching) لتقليل عدد الطلبات إلى API.

8. استكشاف الأخطاء وإصلاحها

8.1 الأخطاء الشائعة

• 400 Bad Request: تأكد من صحة البيانات المرسلة.
• 401 Unauthorized: تأكد من صحة API Keys.

9. المراجع

9.1 روابط مفيدة

• توثيق واتس 360 API
• رابط التسجيل في واتس 360

10. الخاتمة

10.1 ملخص

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

10.2 الخطوات التالية

يمكنك الآن البدء في دمج واتساب API في مشاريعك لتحسين التواصل مع العملاء وزيادة كفاءة عمليات التسويق.