دليل الربط البرمجي (API Documentation)

هذا هو التوثيق التقني الرسمي لمنصة FastWhats، متوافق بنسبة 100% مع واجهة النظام. قم باستخدام المعاملات الموضحة أدناه للربط مع تطبيقاتك.

مفتاح الوصول الخاص بك (Access Token):
تجده في لوحة التحكم الخاصة بك (Team ID)

إدارة المثيلات (Instance API)

POST

Create Instance

https://fastwhats.com/api/create_instance?access_token=YOUR_TOKEN

إنشاء معرف مثيل (Instance ID) جديد لحسابك.

المعاملالوصف
access_tokenمعرف الوصول الخاص بك (Team ID)
POST

Send Pedido (Order Sync)

https://fastwhats.com/api/send_pedido?instance_id=ID&access_token=TOKEN

إرسال وتحديث الوضع الخاص بالطلبات (Notifications) برمجياً.

المعاملالوصف
instance_idمعرف الحساب المختار
access_tokenمفتاح الوصول الخاص بالفريق
POST

Get QR Code

https://fastwhats.com/api/get_qrcode?instance_id=ID&access_token=TOKEN

الحصول على رمز QR لتسجيل الدخول إلى واتساب ويب واستقبال الردود عبر Webhook.

POST

Set Receving Webhook

https://fastwhats.com/api/set_webhook?webhook_url=YOUR_URL&enable=true&instance_id=ID&access_token=TOKEN

الحصول على كافة قيم الردود (حالة الاتصال، الرسائل القادمة، البطارية، إلخ) عبر Webhook.

المعاملالوصف
webhook_urlرابط موقعك الذي سيستقبل البيانات
enableتفعيل أو تعطيل (true/false)
عمليات الصيانة (Maintenance)
Reboot Instance
https://fastwhats.com/api/reboot?instance_id=ID&access_token=TOKEN

تسجيل الخروج من واتساب ويب للقيام بعملية مسح (Scan) جديدة.

Reset Instance
https://fastwhats.com/api/reset_instance?instance_id=ID&access_token=TOKEN

مسح كافة البيانات السابقة نهائياً وتغيير معرف المثيل.

Reconnect
https://fastwhats.com/api/reconnect?instance_id=ID&access_token=TOKEN

إعادة محاولة الاتصال من التطبيق إلى واتساب ويب عند فقدان الاتصال.

إرسال المراسلات (Messaging API)

POST

Send Text

https://fastwhats.com/api/send?number=9665XXXXX&type=text&message=Hello&instance_id=ID&access_token=TOKEN 
{
    "number": "9665XXXXXXXX",
    "type": "text",
    "message": "Message Test",
    "instance_id": "INST_ID",
    "access_token": "TOKEN"
}
POST

Send Media & File

https://fastwhats.com/api/send?number=966XXX&type=media&message=Hello&media_url=URL&filename=test.pdf&instance_id=ID&access_token=TOKEN 
{
    "number": "9665XXXXXXXX",
    "type": "media",
    "message": "Caption",
    "media_url": "https://i.pravatar.cc",
    "filename": "file_test.pdf",
    "instance_id": "INST_ID",
    "access_token": "TOKEN"
}

* ملاحظة: استخدم `filename` فقط عند إرسال المستندات (Documents).

إدارة المجموعات (Group API)

POST

Get Groups

جلب قائمة بكافة المجموعات التي يتواجد بها هذا المثيل.

https://fastwhats.com/api/get_groups?instance_id=ID&access_token=TOKEN
POST

Send Text Group

{
    "group_id": "8498762XXXX@g.us",
    "type": "text",
    "message": "Group message test",
    "instance_id": "INST_ID",
    "access_token": "TOKEN"
}