WhatsApp Business API

توثيق API الشامل

أرسل واستقبل الرسائل عبر WhatsApp Business API بكل سهولة. يدعم النصوص والصور والفيديو والملفات والمواقع والتصويتات.

GET & POST

HMAC-SHA256

RESTful API

Base URL: https://ultrawhats.com/api

المحتويات

نقاط الوصول (Endpoints)

GET/POST https://ultrawhats.com/api/send

إرسال رسالة نصية أو وسائط أو موقع أو تصويت

GET https://ultrawhats.com/api/status

التحقق من حالة الحساب والاتصال

المعاملات (Parameters)

المعامل

النوع

مطلوب

الوصف

token

String

دائما

توكن الحساب (20 رمز)

receiver

String

دائما

رقم المستقبل (بالصيغة الدولية)

msgtext

String

للنص

نص الرسالة

mediaurl

URL

للوسائط

رابط الصورة/الفيديو/الملف

type

String

اختياري

filename

String

للملفات

اسم الملف المعروض

lat

Float

للموقع

خط العرض

lng

Float

للموقع

خط الطول

location_name

String

للموقع

اسم الموقع

location_address

String

للموقع

عنوان الموقع

poll_question

String

للتصويت

سؤال التصويت

poll_options

Array

للتصويت

خيارات التصويت (comma او array)

poll_select_count

Integer

للتصويت

عدد الاختيارات (افتراضي: 1)

الأمثلة

GET طلب عبر الرابط

https://ultrawhats.com/api/send?receiver=249125181447&msgtext=مرحباً&token=QvnwxFpVV6Af8iFPdtj5

POST JSON Body

{
  "receiver": "249125181447",
  "msgtext": "مرحباً من Ultra Whats",
  "token": "QvnwxFpVV6Af8iFPdtj5"
}

الاستجابة (Response)

استجابة ناجحة 200

{
  "status": true,
  "code": 200,
  "message": "Message sent successfully",
  "data": {
    "receiver": "249125181447",
    "type": "text",
    "msgid": "xxxxx"
  }
}

استجابة خطأ 401

{
  "status": false,
  "code": 401,
  "message": "Invalid or inactive token"
}

Webhook Payload

WEBHOOK يُرسل تلقائياً عند استقبال رسالة

{
  "event": "message_received",
  "account_id": 1,
  "phone": "249900000000",
  "from": "249125181447",
  "name": "محمد أحمد",
  "message": "نص الرسالة الواردة",
  "type": "text",
  "timestamp": "2026-02-25T03:00:00+03:00"
}

التحقق من المصدر

يُرسل مع كل طلب header: X-Webhook-Signature: HMAC-SHA256 للتحقق من أن الطلب قادم من UltraWhats.