مرحباً بك في وثائق TurboMsg

واجهة TurboMsg تمنحك القدرة على دمج واتساب في تطبيقاتك بسهولة. هذه الوثائق ستساعدك على البدء، سواء كنت تريد إرسال أول رسالة لك أو تبني نظاماً معقداً للمحادثات الآلية.

المصادقة (Authentication)

ملاحظة: يجب إدراج API Key و Token في كل العمليات.

قم بتسجيل الدخول لرؤية مفاتيح الـ API الخاصة بك هنا.

تسجيل الدخول
POST

إرسال رسالة نصية

Endpoint بسيط لإرسال رسائل نصية مباشرة إلى أي رقم واتساب.

									
        curl -X POST https://sahab4tech.com/message/sendText/YOUR_INSTANCE \
          -H "apikey: YOUR_API_KEY" \
          -H "Content-Type: application/json" \
          -d '{
          "number": "201027247788",     # رقم واتساب مع كود الدولة
          "text": "Hello from Turbo Message API!"
          }'
      

POST

إرسال وسائط (صور، ملفات)

إرسال ملفات PDF، صور، أو مستندات عبر رابط مباشر.


 curl -X POST https://sahab4tech.com/message/sendMedia/YOUR_INSTANCE \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "201027247788",
    "type": "image",   # أنواع أخرى: document, video, audio
    "url": "https://example.com/file.jpg",
    "caption": "Here is your image!"  # اختياري
  }'
                                   

POST

الحصول على رمز QR

الحصول على رمز الاستجابة السريعة (QR Code) لربط الجهاز.


curl -X GET "https://sahab4tech.com/instance/connect/YOUR_INSTANCE" \
-H "apikey: YOUR_API_KEY"

                                   

نموذج الاستجابة (Response)

{
    "message_status": "Success",
    "data": {
        "from": "SENDER_NUMBER",
        "to": "RECEIVER_NUMBER",
        "status_code": 200,
        "message_id": "wamid.HBgLM..."
    }
}

أكواد الخطأ (Error Codes)

الكود المعنى الوصف
401 Unauthorized مفتاح التطبيق (App Key) أو مفتاح المصادقة (Auth Key) غير صحيح.
403 Forbidden حسابك غير نشط أو ليس لديك رصيد كافٍ.
404 Not Found المسار المطلوب غير موجود.
422 Validation Error خطأ في البيانات المرسلة (مثل رقم هاتف غير صحيح أو حقل مفقود).
500 Server Error خطأ داخلي في الخادم، يرجى المحاولة لاحقاً.

هيكلية بيانات Webhook (Incoming Message)

عند استقبال رسالة جديدة، سيقوم النظام بإرسال طلب POST إلى رابط الـ Webhook الخاص بك يحتوي على البيانات التالية:


	{
    "event": "message",
    "instanceId": "12345",
    "data": {
        "id": "false_1234567890@c.us_3EB0...",
        "from": "1234567890@c.us",
        "to": "0987654321@c.us",
        "body": "Hello World",
        "type": "chat",
        "timestamp": 1672531200,
        "notifyName": "John Doe",
        "isGroupMsg": false
    }
}