منصة Whats360: دليل شامل لخدمات WhatsApp API وWebhooks وVCash Gateway وإدارة الرسائل والحملات والأجهزة والربط البرمجي

إذا كنت تبحث عن طريقة لربط واتساب بالأنظمة والبرمجيات والمتاجر الإلكترونية، أو تريد إدارة الأجهزة والحملات والمحادثات من منصة واحدة، أو تحتاج إلى ربط الرسائل القصيرة SMS والمحافظ الإلكترونية وتنفيذ أوامر USSD، فإن Whats360 تجمع هذه الاستخدامات داخل طبقة تشغيل وأتمتة واحدة.

لا تقتصر فكرة Whats360 على إرسال رسائل واتساب فقط، بل تمتد إلى إدارة أجهزة WhatsApp، وواجهات API، وWebhooks، والحملات، والتكامل مع n8n وShopify وWooCommerce، بالإضافة إلى خدمة VCash Gateway التي تربط أجهزة Android بالمنصة لاستقبال الرسائل المالية وتحليلها وتنفيذ أوامر USSD.

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

ما هي Whats360 وما المشكلة التي تحلها؟

تظهر الحاجة إلى منصة مثل Whats360 عندما يصبح WhatsApp جزءًا من دورة العمل وليس مجرد وسيلة محادثة يدوية.

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

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

هنا يصبح المطلوب طبقة تكامل تستطيع استقبال الأحداث وإرسال البيانات وتنفيذ العمليات وفق Workflow واضح.

وهذا هو الدور الأساسي الذي يمكن أن تؤديه Whats360 من خلال مجموعة من الأدوات تشمل WhatsApp API وWebhooks وإدارة الأجهزة والحملات، إلى جانب VCash Gateway وواجهاته البرمجية.

من يستفيد من Whats360؟

المنصة تخدم أكثر من نوع من المستخدمين، لكن طبيعة الاستخدام تختلف حسب الهدف.

المطورون ومهندسو التكامل

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

فرق المبيعات وإدارة العملاء

يمكن استخدام المنصة لإدارة محادثات WhatsApp مركزيًا والاستفادة من أدوات CRM والموظفين والأتمتة عندما يكون الهدف تنظيم عملية التواصل والمتابعة.

أصحاب المتاجر والأنشطة التجارية

يستطيع صاحب النشاط استخدام WhatsApp كقناة للتواصل مع العملاء وإرسال الحملات وإدارة المحادثات وربط المتجر بعمليات التواصل.

المسوقون

تخدم أدوات الحملات وإدارة الرسائل من يحتاج إلى تنظيم عمليات المراسلة والمتابعة بدل الاعتماد على عمليات يدوية منفصلة.

كيف تعمل المنصة كطبقة تكامل؟

يمكن تصور البنية بصورة بسيطة:

الفكرة المهمة هنا أن API وWebhook لا يؤديان الوظيفة نفسها.

الـ API يستخدم عندما يريد نظامك أن يطلب تنفيذ عملية، مثل إرسال رسالة أو تشغيل حملة أو الاستعلام عن الأجهزة.

أما Webhook فيستخدم عندما تريد أن يتم إشعار نظام آخر بحدوث حدث، مثل وصول رسالة أو نجاح إرسال أو فشل إرسال أو انتهاء اشتراك.

إدارة أجهزة WhatsApp داخل Whats360

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

تتيح واجهة API نقاط نهاية لإدارة هذه العمليات، ومنها:

WhatsApp API: بوابة المطورين للربط البرمجي

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

تعتمد واجهة WhatsApp API في البيانات التشغيلية المقدمة على إضافة Token داخل الطلب، مع تحديد الجهاز والجهة المستقبلة والمحتوى حسب نوع العملية.

تبدأ الطلبات من العنوان الأساسي:

https://whats360.live

مثال إرسال رسالة نصية:

curl "https://whats360.live/api/v1/send-text?token=[TOKEN_ID]&instance_id=[INSTANCE_ID]&jid=[PHONE_ID]@s.whatsapp.net&msg=Hello"

وتشمل واجهة الرسائل نقاط نهاية لإرسال النصوص والصور والفيديو والصوت والمستندات.

إرسال رسالة WhatsApp من نظام خارجي

في أبسط سيناريو، يحتاج نظامك إلى أربعة عناصر رئيسية: Token، وInstance ID، ورقم المستلم بصيغة JID، ونص الرسالة.

عند بناء التكامل، لا تجعل Frontend هو المسؤول عن حفظ Token. اجعل التطبيق يرسل الطلب إلى Backend الخاص بك، ثم يقوم Backend بتنفيذ طلب API إلى Whats360.

Webhooks: كيف تربط Whats360 بالأنظمة الخارجية؟

Webhooks هي الجزء الذي يحول التكامل من عملية طلب واستجابة إلى نظام قائم على الأحداث.

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

وتتضمن البيانات المتاحة وفق الإعدادات المقدمة متغيرات مثل:

• phone
• message
• sender_name
• instance_id
• timestamp
• message_id
• media_url
• chat_jid

ويمكن أيضًا إضافة Custom Headers واختيار عدد محاولات إعادة الإرسال من مرة إلى خمس مرات مع تحديد الفاصل الزمني بين المحاولات.

Incoming Webhook وOutgoing Webhook

يمكن التفكير في الاتجاهين بطريقة عملية.

Outgoing Webhook: ترسل Whats360 البيانات إلى نظام خارجي عند وقوع حدث.

Incoming Webhook: يستقبل النظام بيانات من خدمة خارجية ثم يستخدمها لإنشاء رسالة WhatsApp وفق Field Mapping.

مثال لطلب Incoming Webhook:

POST /api/instances/[INSTANCE_ID]/webhooks/[IDENTIFIER_ID]/incoming
Content-Type: application/json

{
  "phone": "[PHONE_ID]",
  "message": "Your order #1234 is confirmed!",
  "name": "[PERSON_ID]"
}

والاستجابة المتوقعة:

{
  "status": "success",
  "message": "Webhook received successfully"
}

ربط Whats360 مع n8n

إذا كنت تستخدم n8n لبناء Workflows بدون الحاجة إلى كتابة كل منطق التكامل يدويًا، يمكن استخدام Webhook كنقطة دخول للسيناريو.

يبدأ التكامل بإنشاء Webhook داخل Whats360 ونسخ الرابط، ثم فتح Workflow في n8n وإضافة Webhook Trigger ولصق الرابط وتحديد الإجراءات التالية.

بعد ذلك يمكن بناء Workflow يعتمد على البيانات المستقبلة.

ربط Whats360 مع Shopify

يمكن استخدام Webhook لاستقبال أحداث من متجر Shopify وإرسالها إلى Whats360 لتنفيذ Workflow متعلق بالطلب أو العميل.

من الأحداث التي يمكن اختيارها:

• orders/create
• orders/paid
• orders/updated
• customers/create

يتم إنشاء Webhook استقبال، واختيار قالب Shopify، ثم نسخ الرابط إلى إعدادات إشعارات Shopify، مع استخدام JSON وتحديد الحدث المطلوب.

ومن النقاط التشغيلية المهمة التحقق من ترويسة X-Shopify-Hmac-SHA256 باستخدام Secret Key، مع مراعاة إعادة استجابة 200 خلال المهلة المطلوبة لتقليل احتمالية إعادة المحاولة.

مثال مبسط لحمولة طلب:

{
  "id": [ORDER_ID],
  "order_number": 1234,
  "total_price": "199.00",
  "customer": {
    "first_name": "[PERSON_ID]",
    "phone": "[PHONE_ID]"
  }
}

ربط Whats360 مع WooCommerce

الفكرة نفسها يمكن تطبيقها مع WooCommerce.

يتم إنشاء Webhook استقبال داخل Whats360 واختيار قالب WooCommerce، ثم وضع رابط التسليم داخل إعدادات Webhook المتقدمة في WooCommerce، مع ضبط Secret واختيار الأحداث المطلوبة.

ومن الأحداث الممكنة:

• Order created
• Order updated
• Customer created
• Product updated

عند حدوث مشكلة يمكن الرجوع إلى سجلات Webhook وفحص الطلب والاستجابة، مع التأكد من إرجاع HTTP 200 عند نجاح الاستقبال حتى لا يتم التعامل مع Webhook باعتباره فاشلًا.

{
  "id": [ORDER_ID],
  "status": "processing",
  "total_price": "150.00",
  "billing": {
    "first_name": "[PERSON_ID]",
    "phone": "[PHONE_ID]"
  }
}

إدارة رسائل WhatsApp والحملات

إلى جانب الإرسال الفردي، توفر واجهة API نقاط نهاية لإدارة الحملات.

مثال إنشاء حملة:

curl -X POST "https://whats360.live/api/v1/campaigns/create?token=[TOKEN_ID]&instance_id=[INSTANCE_ID]" \
-H "Content-Type: application/json" \
-d '{"name":"test","message_content":"Hello {{name}}"}'

وبعد إنشاء الحملة وإضافة المستلمين يمكن تشغيلها عبر:

curl -X POST "https://whats360.live/api/v1/campaigns/start?token=[TOKEN_ID]&instance_id=[INSTANCE_ID]&campaign_id=[IDENTIFIER_ID]"

VCash Gateway: ما هي وكيف تعمل؟

VCash Gateway هي خدمة تعتمد على تطبيق Android يربط الهاتف بالمنصة، بحيث يمكن استخدام الهاتف لاستقبال الرسائل المالية وتحليلها وتنفيذ أوامر USSD وإدارة العمليات المرتبطة بالمحافظ الإلكترونية وفق الإعدادات المتاحة.

وتختلف طبيعة VCash عن WhatsApp API؛ فهي تستفيد من جهاز Android وشريحة SIM لتنفيذ العمليات المرتبطة بالرسائل وUSSD.

إعداد تطبيق VCash على هاتف Android

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

بعد ذلك يتم تسجيل الدخول باستخدام بيانات حساب المنصة، ثم الانتقال إلى لوحة Whats360 وفتح قسم أجهزة VCash لإضافة الجهاز.

يجب كذلك التأكد من توفر اتصال مناسب بين الهاتف والخادم وفق البنية المستخدمة، وأن الهاتف قادر على الاستمرار في تشغيل التطبيق في الخلفية.

إعداد فلتر الرسائل المالية

يمكن إعداد فلتر للمرسل داخل إعدادات جهاز VCash حتى لا تمر كل الرسائل الواردة إلى نظام التحليل.

على سبيل المثال يمكن تحديد نصوص مرتبطة بالمرسل مثل vf-cash أو VodafoneCA.

كما يمكن ترك الفلتر فارغًا إذا كان الهدف تمرير جميع الرسائل الواردة وفق إعدادات النظام.

تحليل SMS باستخدام Regex

أحد الأجزاء المهمة في VCash هو تحويل الرسالة النصية إلى بيانات منظمة.

بدل أن تبقى الرسالة المالية مجرد نص، يمكن استخدام Regex لاستخراج عناصر مثل المبلغ ورقم الهاتف ورقم العملية والاسم، ثم استخدام هذه البيانات لتسجيل المعاملة المالية.

وهنا تظهر قيمة Regex في تحويل نص غير منظم إلى حقول يمكن للنظام التعامل معها.

ومن المهم اختبار Regex قبل الحفظ، لأن اختلاف صيغة الرسالة قد يؤدي إلى عدم استخراج الحقول بالطريقة المطلوبة.

تنفيذ أوامر USSD من خلال VCash

يمكن استخدام جهاز VCash لتنفيذ أوامر USSD من خلال تحديد الكود والجهاز والشريحة.

يمكن أن يكون الأمر مثل:

#878*

ثم يتم تحديد الجهاز والشريحة SIM التي ستنفذ الأمر، وتتم قراءة الرد وفق آلية التنفيذ المتاحة.

كما يمكن ضبط رمز PIN ضمن إعدادات الجهاز لاستخدامه تلقائيًا عند الحاجة، مع مراعاة إجراءات الأمان الخاصة بحماية الرمز.

حملات USSD

لا تقتصر VCash على تنفيذ أمر USSD منفرد، بل يمكن إعداد حملات USSD تعتمد على قالب مثل `#phone*amount79*`، بحيث يتم إدخال بيانات الهاتف والمبلغ المطلوب تنفيذه، ثم تُرسل الأوامر إلى الجهاز المحدد بصورة متتابعة وفق الإعدادات المعتمدة.

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

وتساعد آلية التنفيذ المتتابع على متابعة العمليات بصورة منظمة، مع إمكانية إيقاف الحملة مؤقتًا ثم استئنافها عند الحاجة.

السيناريوهات متعددة الخطوات في USSD

عندما تكون العملية المالية أو التشغيلية أكثر تعقيدًا من أمر USSD واحد، يمكن بناء سيناريو يتكون من عدة أوامر متتابعة، بحيث يتم تنفيذ كل أمر بعد الآخر مع وجود فترات انتظار بين الأوامر عند الحاجة.

ويمكن أن يعتمد السيناريو على متغيرات مثل رقم الهاتف والمبلغ، بحيث يتم تمرير القيم نفسها إلى الأوامر المختلفة بدل إعادة إدخالها يدويًا في كل مرحلة.

هذا الأسلوب يجعل USSD جزءًا من Workflow قابل للأتمتة، بدل التعامل معه كأمر منفصل يتم تشغيله يدويًا في كل مرة.

الحسابات والمعاملات المالية في VCash

تتيح المنظومة متابعة الحسابات والمعاملات المالية الناتجة عن الرسائل الواردة والعمليات التي يتم تنفيذها من خلال الأجهزة.

يمكن تسجيل الإيرادات والمصروفات ومراجعة العمليات وفق مجموعة من الفلاتر، مثل الجهاز المستخدم، ونوع العملية، والتاريخ.

وعند توافق رسالة واردة مع قواعد استخراج البيانات المحددة مسبقًا، يمكن تحويل المعلومات المستخرجة إلى معاملة مالية منظمة بدل بقائها مجرد رسالة نصية داخل الهاتف.

أمان أجهزة VCash والبيانات الحساسة

لأن VCash يعتمد على أجهزة Android مرتبطة بالنظام لتنفيذ عمليات SMS وUSSD، فإن إدارة الأجهزة جزء أساسي من التشغيل الآمن.

يتم التعامل مع الجهاز من خلال هوية مخصصة له، كما يمكن استخدام Token خاص بالجهاز أو الاتصال للوصول إلى العمليات البرمجية المرتبطة به وفق آلية النظام.

أما رمز PIN فيجب التعامل معه بحذر، ولا ينبغي إرساله عبر رسائل SMS أو وضعه في أماكن غير آمنة.

وفي حالة فقدان الهاتف أو الجهاز المرتبط بالخدمة، يجب تعطيل الجهاز من لوحة التحكم مباشرة بدل الاستمرار في استخدامه أو تركه متصلًا بالنظام.

تعطيل الجهاز لا يعني بالضرورة حذف بياناته، وإنما يهدف إلى إيقاف قدرته على تنفيذ العمليات من خلال المنظومة إلى أن يتم التعامل مع الحالة بصورة صحيحة.

VCash API للمطورين

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

عنوان API الأساسي هو:

https://whats360.live

ويتم استخدام Authorization Header لإرسال رمز الوصول:

Authorization: Bearer [TOKEN_ID]

وجود طبقة API يعني أن النظام الخارجي يمكنه طلب البيانات أو تنفيذ العمليات دون الحاجة إلى فتح لوحة التحكم في كل مرة، وهو ما يجعل VCash مناسبًا للربط مع أنظمة المحاسبة، والمتاجر، والتطبيقات، والـ CRM، وأنظمة الأتمتة.

عرض أجهزة VCash

يمكن استخدام نقطة النهاية التالية للحصول على الأجهزة المرتبطة بـ VCash:

GET /api/v1/vcash/devices

إرسال SMS من خلال VCash API

يمكن إرسال رسالة SMS باستخدام نقطة النهاية:

POST /api/v1/vcash/sms/send

تنفيذ USSD برمجيًا

لتنفيذ أمر USSD من خلال API يمكن استخدام:

POST /api/v1/vcash/ussd/execute

الحصول على الرصيد

يمكن الاستعلام عن الرصيد من خلال:

GET /api/v1/vcash/balance

الحصول على المعاملات

ولقراءة المعاملات المسجلة يمكن استخدام:

GET /api/v1/vcash/transactions

{
  "success": true,
  "message": "...",
  "data": {}
}

{
  "success": false,
  "error": "error description"
}

أخطاء VCash API وكيفية التعامل معها

وجود نظام واضح للأخطاء مهم عند بناء أي تكامل برمجي، لأن التطبيق الخارجي يجب أن يعرف هل المشكلة في البيانات المرسلة، أم في صلاحية Token، أم في الجهاز، أم في حدود الباقة، أم في الخادم.

لماذا لا تتوقف Whats360 عند VCash؟

قيمة Whats360 تظهر بشكل أكبر عندما يتم النظر إلى المنصة باعتبارها طبقة تكامل وأتمتة، وليس مجرد أداة لإرسال الرسائل.

يمكن للنظام أن يجمع بين WhatsApp وSMS وVCash والأجهزة والـ API والـ Webhooks والأنظمة الخارجية ضمن Workflow واحد.

وهذا يعني أن الحدث الذي يحدث داخل نظام خارجي يمكن أن يصبح سببًا لتنفيذ إجراء داخل Whats360، كما يمكن أن يصبح الحدث داخل Whats360 سببًا لتنفيذ إجراء في نظام خارجي.

بوابة المطورين في Whats360

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

ويتم استخدام Token وInstance ID لتحديد الحساب أو الجهاز الذي سيتم تنفيذ العملية من خلاله.

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

يمكن إرسال رسالة نصية من خلال نقطة النهاية:

GET /api/v1/send-text

وتتضمن المعاملات الأساسية Token وInstance ID وJID والرسالة.

curl "https://whats360.live/api/v1/send-text?token=[TOKEN_ID]&instance_id=[INSTANCE_ID]&jid=[PHONE_ID]@s.whatsapp.net&msg=Hello"

إرسال الصور

GET /api/v1/send-image

وتستخدم مع Token وInstance ID وJID ورابط الصورة، مع إمكانية إضافة Caption.

إرسال الفيديو

GET /api/v1/send-video

ويمكن تمرير رابط الفيديو مع Caption عند الحاجة.

إرسال الصوت

GET /api/v1/send-audio

إرسال المستندات

GET /api/v1/send-doc

وتسمح هذه المجموعة ببناء طبقة إرسال برمجية يمكن لتطبيقك أو نظامك الداخلي استخدامها بدل تنفيذ كل عملية يدويًا من لوحة التحكم.

إدارة أجهزة WhatsApp عبر API

لا تقتصر بوابة المطورين على إرسال الرسائل، بل تشمل أيضًا مجموعة من نقاط النهاية لإدارة Instances.

يمكن الحصول على الأجهزة من خلال:

GET /api/v1/instances

كما توجد نقاط نهاية لإنشاء الجهاز وربطه وفصل الاتصال والتحقق من الحالة والحصول على QR وحذف الجهاز.

وعند إنشاء جهاز جديد يمكن استخدام طلب مشابه:

curl "https://whats360.live/api/v1/instances/create?token=[TOKEN_ID]&id=new-device&name=New+Device"

إدارة الحملات من خلال API

يمكن للمطورين كذلك التعامل مع الحملات برمجيًا بدل إنشاء كل حملة وتشغيلها يدويًا من لوحة التحكم.

وتشمل مجموعة الحملات عمليات عرض الحملات وإنشاء حملة وإضافة المستلمين وبدء الحملة وإيقافها مؤقتًا واستئنافها وإيقافها بالكامل وعرض الحالة وحذف الحملة.

Webhooks في Whats360

إذا كانت API تجعل النظام الخارجي قادرًا على طلب إجراء من Whats360، فإن Webhooks تسمح بالاتجاه العكسي، بحيث ترسل Whats360 بيانات إلى نظام خارجي عندما يحدث Event معين.

وهذه النقطة مهمة جدًا عند بناء الأتمتة، لأن النظام الخارجي لا يحتاج إلى الاستعلام المستمر عن حالة Whats360 لمعرفة ما إذا حدثت رسالة أو عملية جديدة.

يمكن إعداد Webhook لاستقبال أو إرسال البيانات واستخدامه في الإشعارات وحفظ بيانات المحادثات وتشغيل إجراءات آلية في أنظمة أخرى.

الربط مع n8n

يمكن استخدام Webhooks مع أدوات الأتمتة مثل n8n لإنشاء تدفقات عمل تبدأ من حدث داخل Whats360 ثم تنفذ مجموعة من الإجراءات في أنظمة أخرى.

يتم إنشاء Webhook داخل المنصة والحصول على الرابط، ثم استخدامه داخل Webhook Trigger في n8n، وبعد ذلك يمكن إضافة الإجراءات المطلوبة ضمن Workflow.

بهذه البنية يمكن أن يصبح وصول رسالة أو حدوث Event داخل Whats360 نقطة بداية لسلسلة من العمليات البرمجية دون الحاجة إلى تنفيذها يدويًا.

الربط مع Shopify

يمكن ربط Webhooks مع Shopify بحيث تصل أحداث المتجر إلى Whats360 أو النظام الوسيط لتنفيذ إجراءات مرتبطة بالطلبات والعملاء.

ومن الأحداث التي يمكن التعامل معها: إنشاء الطلب orders/create، دفع الطلب orders/paid، تحديث الطلب orders/updated، وإنشاء العميل customers/create.

ويتم استخدام Secret Key للتحقق من صحة الطلبات الواردة من Shopify من خلال التوقيع الموجود في Header المعروف باسم X-Shopify-Hmac-SHA256.

ومن المهم التعامل مع الاستجابة في الوقت المناسب وإرجاع حالة HTTP 200 عند نجاح الاستقبال لتقليل احتمالية إعادة المحاولة.

{
  "id": [ORDER_ID],
  "order_number": 1234,
  "total_price": "199.00",
  "customer": {
    "first_name": "[PERSON_ID]",
    "phone": "[PHONE_ID]"
  }
}

الربط مع WooCommerce

يمكن كذلك استخدام Webhooks مع WooCommerce لربط أحداث المتجر بعمليات Whats360 والأتمتة الخارجية.

بعد إنشاء Webhook داخل WooCommerce يتم تحديد Delivery URL من الإعدادات المتقدمة، ثم استخدام Secret المناسب وتحديد الأحداث التي يجب إرسالها.

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

Webhooks المخصصة في Whats360

يمكن بناء Webhooks مخصصة لأحداث مختلفة، مثل وصول رسالة جديدة، إرسال رسالة، فشل الإرسال، أو انتهاء الاشتراك.

ويمكن إضافة Custom Headers عند الحاجة، كما تتوفر مجموعة من المتغيرات التي يمكن استخدامها داخل البيانات المرسلة.

ومن أمثلة هذه المتغيرات رقم الهاتف، نص الرسالة، اسم المرسل، Instance ID، الوقت، Message ID، رابط الوسائط، وChat JID.

كما يمكن ضبط عدد محاولات إعادة الإرسال والفاصل الزمني بينها، مثل تنفيذ ثلاث محاولات بفاصل ثلاثين ثانية بين كل محاولة وأخرى.

Incoming Webhook

يمكن أيضًا استخدام Incoming Webhook لإرسال بيانات من نظام خارجي إلى Whats360.

ومن البيانات الأساسية التي يمكن تمريرها رقم الهاتف والرسالة والاسم.

POST /api/instances/[INSTANCE_ID]/webhooks/[IDENTIFIER_ID]/incoming

مثال على البيانات:

{
  "phone": "[PHONE_ID]",
  "message": "Your order #1234 is confirmed!",
  "name": "[PERSON_ID]"
}

ويمكن أن تكون الاستجابة عند نجاح الاستقبال:

{
  "status": "success",
  "message": "Webhook received successfully"
}

البنية الموحدة لمنظومة Whats360

عند جمع كل المكونات السابقة، تصبح الصورة أوضح: Whats360 ليست مجرد مكان لإرسال رسالة WhatsApp، وإنما طبقة يمكن أن تتوسط بين الأنظمة المختلفة وتربط الأحداث بالإجراءات.

هذه البنية مناسبة عندما تكون الرسائل جزءًا من عملية أكبر، مثل إشعار عميل بحالة طلب، تسجيل عملية مالية، تشغيل إجراء بعد وصول رسالة، أو إرسال نتيجة من جهاز VCash إلى النظام المركزي.

كيف تختار الباقة المناسبة؟

اختيار الباقة لا يجب أن يعتمد على عدد الرسائل فقط، لأن اختلاف الباقات يرتبط أيضًا بعدد الأجهزة والحملات والموظفين ومساحة التخزين والوظائف المتاحة.

المواصفات والأسعار السابقة هي البيانات المتاحة ضمن هذا المحتوى، وقد تتغير مع تحديث الباقات أو الخدمات.

متى تحتاج إلى Whats360 كطبقة تكامل؟

تظهر الحاجة الحقيقية عندما تصبح الرسائل جزءًا من عملية تشغيلية وليس هدفًا مستقلًا.

فمثلًا، إذا كان لديك متجر ويرسل النظام إشعارًا عند إنشاء الطلب، يمكن ربط الحدث بـ Webhook ثم استخدام Whats360 لإرسال رسالة إلى العميل.

وإذا كان لديك نظام يستقبل بيانات مالية عبر SMS، يمكن استخدام VCash لتحويل الرسالة إلى بيانات منظمة يمكن التعامل معها داخل النظام.

وإذا كان التطبيق الخاص بك يحتاج إلى تنفيذ أمر USSD، يمكن استخدام VCash API بدل تشغيل العملية يدويًا من الهاتف.

أما إذا كان CRM أو النظام الداخلي يحتاج إلى إرسال رسائل WhatsApp، فيمكن استخدام WhatsApp Developer API كطبقة اتصال بين النظام والقناة.

أخطاء شائعة عند تصميم التكامل

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

ومن الأخطاء أيضًا وضع Token داخل كود Frontend أو مستودع عام، وهو ما يعرض بيانات الوصول للخطر.

وفي VCash يجب عدم التعامل مع SMS الخام باعتبارها معاملة مالية جاهزة قبل تحليلها والتحقق من البيانات المستخرجة.

كما يجب اختبار Regex على رسائل فعلية متنوعة قبل اعتماده، لأن اختلاف شكل الرسالة قد يؤدي إلى استخراج قيمة خاطئة أو عدم استخراج البيانات المطلوبة.

وفي Webhooks يجب التحقق من مصدر الطلب والتوقيع عند توفر آلية للتحقق، مع تسجيل الأخطاء ومراقبة الاستجابات.

خريطة تشخيص المشكلة

مثال Workflow متكامل

لنفترض أن لديك نظامًا خارجيًا يستقبل طلب شراء. عند إنشاء الطلب يتم إرسال Event إلى Webhook، ثم يقوم النظام بمعالجة البيانات واختيار الرسالة المناسبة وإرسالها من خلال Whats360.

إذا كانت هناك عملية مالية مرتبطة بالطلب، يمكن أن تدخل بيانات VCash في نفس المنظومة، بحيث يصبح SMS الوارد مصدرًا لبيانات المعاملة.

بعد ذلك يمكن استخدام API لإرسال النتيجة إلى النظام الخارجي، أو استخدام Webhook لإبلاغ نظام آخر بأن العملية اكتملت.

ما الذي يجب تجهيزه قبل بناء التكامل؟

قبل البدء في أي مشروع تكامل، يجب تحديد النظام الذي سيبدأ منه الحدث، والنظام الذي سيستقبل البيانات، والإجراء المطلوب بعد كل Event.

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

وفي حالة VCash يجب تحديد مصدر SMS، وقاعدة Regex، والأوامر المطلوبة في USSD، والجهاز والشريحة، والبيانات التي يجب تحويلها إلى معاملات.

أما في WhatsApp API فيجب تحديد نوع الرسائل المطلوبة، وطريقة تحديد Instance، وآلية تخزين Token، وكيفية التعامل مع الأخطاء والاستجابات.

مراجعة تشغيلية قبل الإطلاق

• التأكد من أن كل جهاز متصل ويظهر بالحالة الصحيحة.
• اختبار إرسال الرسائل قبل تشغيل Workflow كامل.
• اختبار Webhook باستخدام بيانات تجريبية.
• اختبار Regex على أكثر من صيغة SMS.
• اختبار USSD ومراجعة الرد الناتج.
• التأكد من حماية Token وPIN.
• تحديد طريقة تسجيل الأخطاء.
• التأكد من أن النظام يستطيع التعامل مع فشل API أو Webhook.
• مراجعة حدود الباقة قبل تشغيل حملات كبيرة.

لماذا تعتبر Whats360 مناسبة للمطورين وأصحاب الأنظمة؟

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

المطور يستطيع التعامل مع API، ونظام الأتمتة يستطيع استقبال Webhooks، والمتجر يمكن ربطه بالأحداث، وVCash يمكن أن يربط SMS وUSSD بالأجهزة والعمليات المالية.

وبالتالي يمكن بناء حلول تبدأ من حدث بسيط وتنتهي بسلسلة من الإجراءات المترابطة.

الأسئلة الشائعة حول Whats360 وVCash وAPI وWebhooks

ما هي منصة Whats360؟

Whats360 هي منصة لإدارة وأتمتة عمليات WhatsApp، وتوفر أدوات لإدارة الأجهزة والرسائل والحملات، بالإضافة إلى API وWebhooks والتكامل مع الأنظمة الخارجية وخدمة VCash.

ما هي خدمة VCash Gateway؟

VCash Gateway هي خدمة تعتمد على تطبيق Android لربط الهاتف بالمنصة، واستقبال SMS وتنفيذ أوامر USSD بشكل يمكن ربطه بالعمليات البرمجية والمالية.

هل يمكن استخراج البيانات المالية من SMS تلقائيًا؟

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

هل يمكن تنفيذ USSD من خلال API؟

نعم، تتوفر نقطة النهاية /api/v1/vcash/ussd/execute لتنفيذ أوامر USSD برمجيًا.

هل يمكن تنفيذ أكثر من أمر USSD في حملة واحدة؟

نعم، يمكن إعداد حملات USSD تعتمد على قوالب وبيانات متعددة، مع تنفيذ العمليات بصورة متتابعة وإمكانية الإيقاف والاستئناف.

هل يمكن ربط Whats360 مع Shopify؟

نعم، يمكن استخدام Webhooks لربط أحداث Shopify مثل إنشاء الطلب أو دفعه أو تحديثه أو إنشاء العميل مع Workflow خارجي.

هل يمكن ربط Whats360 مع WooCommerce؟

نعم، يمكن استخدام WooCommerce Webhooks وربطها بعنوان الاستقبال المناسب ومتابعة الأحداث من خلال السجلات.

ما الفرق بين API وWebhook؟

API يستخدم عندما يطلب نظامك من Whats360 تنفيذ عملية أو إعادة بيانات، بينما Webhook يستخدم عندما تريد أن ترسل Whats360 Event إلى نظامك عند حدوثه.

هل يمكن استخدام Whats360 مع n8n؟

نعم، يمكن إنشاء Webhook داخل Whats360 واستخدامه مع Webhook Trigger في n8n لبناء Workflow آلي.

هل يمكن إدارة أجهزة WhatsApp من خلال API؟

نعم، توجد نقاط نهاية لعرض الأجهزة وإنشائها وربطها وفصلها ومعرفة حالتها والحصول على QR وحذفها.

هل يمكن إدارة الحملات من خلال API؟

نعم، يمكن إنشاء الحملات وإضافة المستلمين وبدء الحملة وإيقافها مؤقتًا واستئنافها وإيقافها ومعرفة حالتها وحذفها.

ما أهم شيء يجب حمايته عند استخدام API؟

يجب حماية Token ومفاتيح الوصول وبيانات الأجهزة وأي PIN أو بيانات مالية وعدم وضعها في Frontend أو مستودعات عامة.

هل أسعار باقات Whats360 ثابتة؟

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

مقالات ذات صلة

دليل Whats360 API للمطورين

شرح Webhooks في Whats360 وربط الأنظمة

دليل WhatsApp API وربط الأنظمة البرمجية

إدارة WhatsApp وCRM للفرق والشركات

أتمتة USSD وربطها بالأنظمة

استخراج البيانات من SMS باستخدام Regex

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

Whats360، Whats360 API، WhatsApp API، VCash Gateway، VCash API، WhatsApp Webhook، Webhooks، USSD Automation، SMS Parsing، Regex SMS، WhatsApp CRM، WhatsApp Automation، WhatsApp Campaigns، WhatsApp Developer API، ربط Shopify مع WhatsApp، ربط WooCommerce مع WhatsApp، n8n WhatsApp، API Integration، Webhook Integration، إدارة أجهزة WhatsApp، أتمتة الرسائل، بوابة المطورين، الربط البرمجي، الأتمتة المالية، Android VCash، SMS Gateway، إدارة الحملات، إدارة Instances.