Webhooks والـ API — ربط WA Web Plus بأنظمتك

Webhooks والـ API — ربط WA Web Plus بأنظمتك

يدعم WA Web Plus التكامل ثنائي الاتجاه مع الأنظمة الخارجية عبر webhooks. يمكنك استقبال طلبات API واردة لتشغيل إجراءات داخل واتساب، أو إرسال طلبات صادرة إلى خادمك الخاص عند وقوع أي حدث.

Webhooks الواردة (REST API)

تتيح لك Webhooks الواردة إرسال طلبات HTTP مصرّح بها إلى WA Web Plus لتنفيذ إجراءات — مثل إرسال الرسائل، تشغيل الحملات، أو وضع تصنيفات على المحادثات — مباشرة من نظامك أو CRM أو أداة الأتمتة.

يجب أن يتضمن كل طلب رمز التفويض في الترويسات. الجسم عبارة عن كائن JSON يحتوي على حقل action يحدد الإجراء المطلوب.

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

{
  "action": "send-message",
  "type": "text",
  "content": "مرحباً بك في WA Web Plus",
  "phone": "905366365288"
}

إرسال رسالة وسائط

{
  "action": "send-message",
  "type": "media",
  "content": "مرحباً بك في WA Web Plus",
  "phone": "905366365288",
  "attachments": ["https://example.com/image.jpg"]
}

إرسال قالب محفوظ

{
  "action": "send-template",
  "template": "رسالة ترحيب",
  "phone": "120363020166629872@g.us"
}

استخدم اللاحقة @g.us للمجموعات.

وضع تصنيف على محادثة

{
  "action": "label-chat",
  "label": "عميل مهتم",
  "phone": "905366365288"
}

إزالة تصنيف

{
  "action": "unlabel-chat",
  "label": "غير مشترك",
  "phone": "905366365288"
}

حظر جهة اتصال

{
  "action": "block-chat",
  "phone": "905366365288"
}

أرشفة محادثة

{
  "action": "archive-chat",
  "phone": "905366365288"
}

تشغيل حملة إرسال جماعي

{
  "action": "run-broadcast",
  "broadcast": "حملة الأحد المجدولة"
}

تشغيل سير عمل رد ذكي

{
  "action": "run-workflow",
  "workflow": "سير عمل الاسترداد",
  "phone": "905366365288"
}

Webhooks الصادرة

تتيح Webhooks الصادرة لـ WA Web Plus إرسال بيانات الأحداث إلى خادمك في الوقت الفعلي — مثلاً عند استلام رسالة، أو انضمام مستخدم لمجموعة، أو تشغيل رد ذكي.

يمكنك تخصيص طريقة HTTP (POST، GET، UPDATE، DELETE)، الترويسات المخصصة (بصيغة JSON)، وتخصيص الـ payload المرسل إلى نقطة النهاية بالكامل. استخدم زر @ في محرر الـ payload لإدراج أي من متغيرات الحدث المتاحة.

متغيرات الحدث المتاحة:

• •m_id — المعرف الفريد للرسالة
• •m_type — نوع الرسالة
• •m_datetime — التاريخ والوقت المنسّق
• •m_timestamp — الطابع الزمني unix
• •m_user — رقم هاتف المرسل
• •m_phone — رقم هاتف المرسل
• •m_content — محتوى الرسالة
• •m_text — نص الرسالة أو التعليق
• •m_cname — اسم جهة الاتصال
• •m_uname — اسم العرض في واتساب للمرسل
• •m_gname — اسم المجموعة التي استُلمت فيها الرسالة
• •m_gid — المعرف الفريد للمجموعة
• •m_platform — منصة المرسل
• •w_id — المعرف الفريد لسير العمل الذي شغّل الـ webhook
• •c_labels — تصنيفات المحادثة
• •c_image — صورة المحادثة
• •m_location — إحداثيات الموقع
• •m_order — عناصر الطلب

للمساعدة في إعداد التكامل، تواصل معنا على support@wawplus.com.

هل تريد تشغيل Webhooks دون فتح المتصفح؟

تتطلب Webhooks في WA Web Plus أن يكون واتساب ويب مفتوحاً في متصفحك. إذا كنت تريد تشغيل webhooks وأتمتتك على السحابة على مدار الساعة — دون الحاجة إلى إبقاء حاسوبك يعمل — جرّب Botassium، حلّنا السحابي الذي يبقي كل شيء يعمل دون الحاجة إلى متصفح.