مقال تعليمي مفصل: كيفية تكامل Whats360 مع منصة Xero لإرسال إشعارات الفواتير والدفع عبر واتساب

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

لماذا استخدام Whats360 مع Xero؟

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

المتطلبات:

  • حساب في Whats360 للحصول على API Key.
  • حساب في Xero لإدارة الفواتير.
  • منصة Make.com (أو بدائل أخرى) لإعداد السيناريو باستخدام HTTP Requests.

الخطوات التفصيلية لتكامل Whats360 مع Xero

الخطوة 1: إعداد حساب Whats360 للحصول على API Key

  1. قم بزيارة موقع Whats360.
  2. سجل للحصول على حساب جديد أو سجل دخولك إذا كان لديك حساب بالفعل.
  3. بعد تسجيل الدخول، توجه إلى لوحة التحكم الخاصة بك وابحث عن قسم API.
  4. انسخ API Key الخاص بك. ستحتاج إلى هذا المفتاح في الخطوات التالية.

الخطوة 2: إعداد حساب Xero وتفعيل Webhooks

  1. قم بتسجيل الدخول إلى حسابك على Xero.
  2. توجه إلى قسم Developer في إعدادات الحساب.
  3. أنشئ تطبيقًا جديدًا للحصول على Client ID و Client Secret.
  4. قم بتفعيل Webhooks من إعدادات الإشعارات في Xero ليتم إرسال إشعارات عند إنشاء الفواتير أو تحديثها.

الخطوة 3: إعداد سيناريو في Make.com باستخدام HTTP Requests

  1. افتح Make.com (أو منصات أخرى مثل Zapier أو Integromat).
  2. أنشئ سيناريو جديد:
    • اختر HTTP Request كأول خطوة.
    • حدد POST كطريقة للإرسال.
    • أدخل عنوان URL التالي لـ Whats360 API:
      https://api.whats360.live/api/user/v2/send_message
    • في Headers، أضف:
      • Authorization: Bearer YOUR_API_KEY
      • Content-Type: application/json
    • في Body، أدخل البيانات كالتالي:
      {
        "client_id": "YOUR_CLIENT_ID",
        "mobile": "MOBILE_NUMBER",
        "text": "Your invoice has been generated. Please check your email for details. Invoice ID: {{invoice_id}}"
      }
                
    • قم بتعديل “MOBILE_NUMBER” ليكون رقم العميل المستهدف بصيغة دولية (مثال: +201030741766).
    • قم بربط البيانات مثل invoice_id عبر Webhooks المرسلة من Xero.

الخطوة 4: إعداد Webhook لربط Xero بـ Make.com

  1. قم بتحديد أحداث Webhook في Xero، مثل:
    • عند إنشاء فاتورة جديدة.
    • عند دفع فاتورة.
  2. في Make.com، أضف Webhook Module واختار Custom Webhook.
  3. انسخ الرابط الذي سيظهر في Make.com.
  4. عد إلى Xero وأدخل الرابط الذي حصلت عليه من Make.com في إعدادات Webhooks الخاصة بـ Xero.
  5. تأكد من اختيار الأحداث المناسبة مثل Invoice Created أو Invoice Paid.

الخطوة 5: إرسال رسائل واتساب تلقائيًا

  1. بعد إعداد Webhook، سيقوم Xero بإرسال البيانات تلقائيًا إلى Make.com.
  2. سيناريو Make.com سيستقبل البيانات مثل invoice_id ورقم العميل.
  3. يتم استخدام هذه البيانات في HTTP Request لإرسال رسالة عبر Whats360 إلى العميل مع تفاصيل الفاتورة.

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

  1. قم بإنشاء فاتورة في Xero أو إجراء دفع لاختبار السيناريو.
  2. تأكد من أن Whats360 يرسل الرسالة عبر واتساب تلقائيًا إلى العميل عند إنشاء الفاتورة أو دفعها.
  3. تحقق من استجابة Whats360 API وتأكد من أن الرسالة تم إرسالها بنجاح عبر واتساب.

شرح مفصل للسيناريو

المشغل الأول: يتم تفعيل Webhook من Xero عندما يتم إنشاء أو دفع فاتورة.

المشغل الثاني: تستقبل Make.com البيانات عبر Webhook، مثل رقم الهاتف و رقم الفاتورة.

المرحلة الثالثة: يتم إرسال HTTP Request إلى Whats360 API باستخدام البيانات التي تم الحصول عليها.

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

الفوائد من استخدام Whats360 مع Xero

  • إرسال إشعارات فورية للعملاء عبر واتساب دون الحاجة لتطبيق واتساب الرسمي.
  • تحسين تجربة العملاء من خلال إشعارات سريعة حول الفواتير والمدفوعات.
  • توفير الوقت والجهد باستخدام الأتمتة التامة لعملية إرسال الرسائل.
  • تكامل سهل ومرن باستخدام HTTP Requests و Webhooks.

روابط ذات صلة:

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

Leave a comment

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