التوثيق والدليل الفني لمنصة Connecto AI

مرحباً بك في وثائق Connecto AI. تتيح لك المنصة ربط الواتساب بالذكاء الاصطناعي، وأتمتة الردود، وتمرير المحادثات للأنظمة الخارجية مثل n8n و Make والـ CRMs.

المصادقة والـ Instance Token

تستخدم المنصة مفتاح مصادقة X-Instance-Token للوصول المستقل لكل حساب. يجب تضمين هذا المفتاح في ترويسة الطلبات (Header) أو كـ Query Parameter:

X-Instance-Token: usr_YOUR_USER_ID

ربط الـ Webhooks و n8n

عند تفعيل خيار الـ Webhook من لوحة التحكم، سيقوم النظام بإرسال إشعار لحظي لكل رسالة واردة إلى الـ URL المحدد بالشكل التالي:

{ "event": "messages.upsert", "phone": "201224287431", "message": "استفسار عن المنتجات", "image_base64": "", "group_name": "", "timestamp": 1785520000 }

مرجع الـ REST APIs

POST /api/chats/:jid/send

إرسال رسالة نصية مباشرة لعميل أو جروب:

curl -X POST https://connecto.myodooerp.cloud/api/chats/201224287431@s.whatsapp.net/send \ -H "Content-Type: application/json" \ -H "X-Instance-Token: usr_YOUR_ID" \ -d '{"message": "مرحباً بك!"}'

GET /api/chats

جلب قائمة المحادثات النشطة وحالتها.

POST /api/products/upload

رفع شيت منتجات (Excel/CSV) يحتوي على أسماء المنتجات والأسعار وروابط الصور.

حل المشاكل الشائعة

1. عدم ظهور الـ QR Code: اضغط على "تحديث QR Code" من لوحة التحكم أو تأكد أن رقم هاتفك لم يقم بتسجيل الخروج من الجلسات النشطة.

2. توقف البوت في الجروبات: تأكد من تفعيل الجروب المطلوب من قائمة "إدارة الجروبات" وتفعيل زر الـ AI في أعلى الصفحة.