تكامل Whats360 مع Orange Money لإرسال تفاصيل الدفع عبر واتساب باستخدام Webhooks و HTTP Requests

يعد تكامل Whats360 مع Orange Money وسيلة فعالة لإرسال تفاصيل الدفع تلقائيًا عبر رسائل واتساب، وذلك باستخدام Webhooks و HTTP Requests كبديل لتطبيق واتساب الرسمي. في هذا المقال، سنوضح كيفية إعداد السيناريو بالتفصيل وكيفية الربط بين Whats360 و Orange Money باستخدام هذه الأدوات.

1. المتطلبات المبدئية للتكامل:

قبل البدء في تكامل Whats360 مع Orange Money، يجب أن تكون لديك بعض الأدوات والإعدادات الأساسية:

• حساب Whats360 API: ستحتاج إلى الوصول إلى Whats360 API عبر رابط API الخاص بهم.
• بيانات API Keys: للحصول على المفتاح الخاص API Key من Whats360 الذي ستستخدمه في HTTP Requests.
• حساب Orange Money: تحتاج إلى تكامل Orange Money لتلقي تفاصيل الدفع من خلال خدمة الدفع الخاصة بهم.
• خدمة Webhooks: ستحتاج إلى إعداد Webhooks لتوجيه رسائل الدفع إلى Whats360 API.

2. كيفية ربط Whats360 مع Orange Money:

الخطوة 1: إعداد Webhook في Orange Money

سجل الدخول إلى لوحة تحكم Orange Money وابحث عن خيار Webhooks.

قم بإضافة Webhook جديد مع الرابط الذي سيتلقى إشعارات الدفع من Orange Money.

تأكد من أن Webhook يرسل تفاصيل الدفع (مثل المبلغ، والمرسل، والرقم المرجعي) إلى الرابط الذي سيتم ربطه بـ Whats360 API.

الخطوة 2: تكامل Webhook مع Make.com أو أي أداة أخرى

استخدم Make.com أو Zapier أو أي أداة تكامل أخرى لدعم Webhooks.

في Make.com، يمكنك إعداد سيناريو تلقائي للحصول على البيانات من Webhook. عند تلقي تفاصيل الدفع من Orange Money، يتم إرسال هذه البيانات إلى Whats360.

الخطوة 3: إرسال تفاصيل الدفع عبر Whats360 API

في السيناريو الخاص بك، بعد تلقي البيانات من Orange Money عبر Webhook، يجب استخدام HTTP Request لإرسال رسالة واتساب تحتوي على تفاصيل الدفع.

البيانات التي يجب إرسالها تشمل: الرقم الهاتف المرسل (بصيغة دولية)، النص (محتوى رسالة الدفع)، ورابط الدفع إن كان موجودًا.

3. إعداد HTTP Request في Make.com لإرسال رسالة عبر Whats360

الخطوة 1: إضافة وحدة HTTP في Make.com

قم بإضافة HTTP Module في Make.com لتوجيه POST Request إلى Whats360 API.

الخطوة 2: تحديد محتوى ال Request

Method: POST

URL: https://api.whats360.live/api/user/v2/send_message

Headers:

• Content-Type: application/json
• Authorization: Bearer YOUR_API_KEY

الخطوة 3: إعداد Body لإرسال الرسالة عبر Whats360

{
  "client_id": "YOUR_CLIENT_ID",
  "mobile": "NUMBER_TO_SEND_MESSAGE_TO",
  "text": "Payment details: Amount: 100 USD, Reference: 123456789"
}
  

client_id: معرف العميل الذي تحصل عليه عند التسجيل في Whats360.

mobile: الرقم الذي ستُرسل إليه الرسالة، ويجب أن يكون بصيغة دولية (مثال: +201030741766).

text: النص الذي سيظهر في الرسالة، ويمكنك تخصيصه لعرض تفاصيل الدفع مثل المبلغ، مرجع الدفع، وتاريخ الدفع.

الخطوة 4: اختبار السيناريو

بعد إعداد السيناريو بشكل كامل في Make.com، قم بتشغيله لاختبار إرسال الرسالة عبر Whats360 إلى رقم الهاتف المعني.

4. تفاصيل الاستجابة والتعامل مع الأخطاء

عند إرسال HTTP Request إلى Whats360، ستتلقى استجابة تتضمن ما إذا كانت الرسالة قد تم إرسالها بنجاح أو حدث خطأ. من المهم التعامل مع هذه الاستجابة لضمان عمل السيناريو بشكل صحيح:

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

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

استجابة فاشلة:

{
  "success": false,
  "message": "There was an error sending the message."
}
  

في حالة الخطأ، تأكد من صحة API Key و client_id وكذلك بيانات الرسالة المرسلة.

5. مزايا التكامل

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

6. روابط ذات صلة وشرح مفصل

• شرح نظري مفصل: يمكنك العثور على الشرح المفصل لهذا التكامل في الرابط التالي: Whats360 API Documentation
• فيديو الشرح خطوة بخطوة: شاهد الفيديو على YouTube للتعرف على كيفية إعداد هذا التكامل.

الخلاصة

بتكامل Whats360 مع Orange Money باستخدام Webhooks و HTTP Requests، يمكنك إرسال تفاصيل الدفع عبر واتساب بشكل تلقائي دون الحاجة إلى تطبيق واتساب الرسمي. من خلال Make.com أو أدوات أخرى مثل Zapier، يمكنك تصميم سيناريو مرن يعمل بشكل فعال ويقدم رسائل تخص تفاصيل الدفع في الوقت الفعلي للمستخدمين.