دليل تكامل

ربط تطبيق خارجي بمؤتمت

خطوات عامة لربط أي نظام خارجي (متجر إلكتروني، CRM، ERP، تطبيق داخلي…) بواجهة مؤتمت لإرسال رسائل الواتساب من الأحداث التي يطلقها نظامك.

1. التحضير في لوحة مؤتمت

1. 1. من لوحة التحكم افتح مفاتيح API واضغط إنشاء مفتاح.
2. 2. أنشئ جلسة واتساب وأعطها اسمًا يعبّر عن استخدامها (مثلًا: store-notifications).
3. 3. اربط رقم الواتساب بمسح رمز QR، ثم انسخ instance_id من قائمة الأجهزة.

2. متغيّرات البيئة

احفظ المفتاح والـ instance في متغيّرات بيئة على خادمك — لا تضعهما في كود العميل:

MOATMT_API_KEY=mmt_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
MOATMT_INSTANCE_ID=wa_9f2b7c11a8

3. إضافة دالة مساعدة

أضف الملف الظاهر في لوحة الكود اليسرى إلى مشروعك تحت مسار مناسب (src/lib/moatmt.server.ts أو ما يعادله). الدالة تكشف واجهة موحّدة لإرسال رسائل نصية أو مع مرفق.

4. الاستدعاء من منطق التطبيق

من أي حدث داخل نظامك (طلب جديد، تأكيد دفع، تذكير موعد، إشعار داخلي…) استدعِ الدالة كما في تبويباستخدام على اليسار. استخدم media_url عند الحاجة لإرفاق صورة أو ملف PDF.

5. الاختبار والمراقبة

• • جرّب أولًا بأمر curl على رقمك الشخصي للتأكد من صحة الإعدادات.
• • راقب سجل الاستخدام في صفحة مفاتيح API لتأكيد وصول الطلبات وعدّاد النجاح/الفشل.
• • عند ظهور INSTANCE_NOT_CONNECTED أعِد ربط الجهاز من صفحة الأجهزة.
• • استرجع أخطاء الاستدعاء وسجّلها في نظامك لتحسين التتبّع (الاعتماد على حقل error الثابت).