مرحباً بك في وثائق 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
}
}