المنصة

التكاملات والربط البرمجي: API وWebhooks وواتساب والاستيراد

التكاملات في أركان هي الطرق التي يتصل بها النظام بما حوله: واجهة برمجية (REST API) يقرأ منها نظامك الآخر ويكتب بمفتاح مستخدم وصلاحياته، وWebhooks ترسل المستند إلى عنوانك لحظة حفظه أو اعتماده، وواتساب للأعمال لمراسلة العملاء من النظام، ومنصة فاتورة لزاتكا، وبوابات الدفع والبريد، واستيراد البيانات من Excel. وكلها تعمل بصلاحيات المستخدم نفسه، فلا يصل التكامل إلى أكثر مما يصل إليه صاحب المفتاح.

  • REST API بمفتاح وسر لكل مستخدم
  • Webhooks عند الحفظ أو الاعتماد أو الإلغاء
  • واتساب للأعمال برسائل وقوالب معتمدة
  • استيراد Excel يقرأ ملفات الأنظمة القديمة

ماذا يقدّم التكاملات والربط البرمجي

  • واجهة REST API

    لكل شاشة في النظام واجهة برمجية بصيغة JSON: قراءة المستندات وإنشاؤها وتعديلها واستدعاء العمليات المسموحة. ويدخل التكامل بمفتاح وسر يولَّدان لمستخدم، أو عبر OAuth 2، فيعمل بصلاحياته ومراكز تكلفته وحدها.

  • Webhooks عند كل حدث

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

  • واتساب للأعمال

    ربط مع WhatsApp Business Cloud API من Meta: استقبال رسائل العملاء، وإرسال النصوص والوسائط والقوالب المعتمدة ومتابعة حالتها (أُرسلت، وصلت، قُرئت)، ورسائل جماعية، وإشعار واتساب عند حدث في مستند مع إرفاق طباعته PDF، كالفاتورة عند اعتمادها. ويظهر في إدارة علاقات العملاء أيضًا.

  • بوابات الدفع

    تطبيق المدفوعات يربط بوابات مثل Stripe وPayPal وBraintree وRazorpay وGoCardless، فيُرسل للعميل طلب دفع برابط ويُسجَّل السداد حين يتم، ويستخدمه المتجر الإلكتروني في الدفع.

  • بريد الشركة

    حساب بريد الشركة، من Gmail أو Outlook أو Hostinger أو أي خادم IMAP وSMTP، للإرسال والاستقبال، مع قوالب الرسائل وسجل الإرسال وطابوره. وإلى أن يُضاف حساب الشركة يُرسل البريد من صندوق المنصة ويُنبَّه المدير بذلك.

  • زاتكا

    ربط مباشر مع منصة «فاتورة» لاعتماد الفواتير الضريبية والإبلاغ عن المبسطة، بالتوقيع ورمز QR ومتابعة حالة كل فاتورة وسبب رفضها.

  • استيراد أي بيانات

    أداة الاستيراد تُدخل سجلات جديدة أو تحدّث القائمة لأي شاشة من Excel أو CSV أو رابط Google Sheets، بقالب يُنزَّل. وخطوة «إصلاح المشكلات» تطابق ما يسميه الملف بما في النظام، كمجموعة أصناف برقمها أو باسمها بأي تهجئة. وملفات الأنظمة القديمة المحفوظة نصًا باسم xls وبترميز Windows العربي تُقرأ كما هي.

  • مستوردات جاهزة للانتقال

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

  • الاتصالات وأجهزة البصمة

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

كيف يسير العمل

  1. 1

    تحديد الربط

    يُحدَّد ما يُقرأ من النظام وما يُكتب فيه، وأي حدث يجب أن يصل إلى النظام الآخر.

  2. 2

    مستخدم التكامل

    يُنشأ مستخدم بصلاحيات ما يحتاجه فقط، ويُولَّد له مفتاح وسر.

  3. 3

    الإعداد

    تُضبط Webhooks الأحداث، أو حساب واتساب وقوالبه، أو بوابة الدفع، أو حساب البريد.

  4. 4

    المتابعة

    تُقرأ سجلات واتساب والبريد والأخطاء، ويظهر إنشاء أي مفتاح API جديد في مراقبة النظام.

أسئلة عن التكاملات والربط البرمجي

هل لدى أركان واجهة برمجية API؟

نعم، واجهة REST بصيغة JSON لكل شاشة، يدخلها التكامل بمفتاح وسر لمستخدم أو عبر OAuth 2، ويعمل بصلاحيات ذلك المستخدم.

هل يمكن ربط متجر إلكتروني خارجي أو تطبيق توصيل؟

يمكن لمطوّر ربطه عبر API وWebhooks، ولا توجد حاليًا موصلات جاهزة لمنصات بعينها. وللبيع على الإنترنت دون ربط، يوجد المتجر الإلكتروني المدمج.

هل يرسل النظام الفواتير عبر واتساب؟

نعم، بعد ربط حساب واتساب للأعمال وقالب رسالة معتمد من Meta، يُرسل إشعار عند اعتماد الفاتورة مع طباعتها PDF.

كيف أنقل بياناتي من برنامجي القديم؟

تُصدَّر من البرنامج القديم إلى Excel وتُستورد بأداة الاستيراد أو بالمستوردات الجاهزة للأرصدة والمخزون والأسعار والموظفين، حتى لو كان الملف نصًا محفوظًا باسم xls.

هل الربط آمن؟

التكامل يعمل بصلاحيات مستخدمه فقط، والمفتاح يُبطَل بتوليد غيره، وطلبات Webhooks موقّعة بسر، وكل مفتاح API جديد يُرصد في مراقبة النظام.