مرحباً بك في وثائق TurboMsg
واجهة TurboMsg تمنحك القدرة على دمج واتساب في تطبيقاتك بسهولة. هذه الوثائق ستساعدك على البدء، سواء كنت تريد إرسال أول رسالة لك أو تبني نظاماً معقداً للمحادثات الآلية.
المصادقة (Authentication)
ملاحظة: يجب إدراج API Key و Token في كل العمليات.
قم بتسجيل الدخول لرؤية مفاتيح الـ API الخاصة بك هنا.
تسجيل الدخول
POST
إرسال رسالة نصية
Endpoint بسيط لإرسال رسائل نصية مباشرة إلى أي رقم واتساب.
Bash
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، صور، أو مستندات عبر رابط مباشر.
Bash
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",
"url": "https://example.com/file.jpg",
"caption": "Here is your image!"
}'
GET
الحصول على رمز QR
الحصول على رمز الاستجابة السريعة (QR Code) لربط الجهاز.
Bash
curl -X GET "https://sahab4tech.com/instance/connect/YOUR_INSTANCE" \
-H "apikey: YOUR_API_KEY"
نموذج الاستجابة (Response)
JSON · 200 OK
{
"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 الخاص بك.
JSON · Webhook Payload
{
"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
}
}