arrive

جاري التحميل...

wa-icon

تواصل مع الدعم الفني
ArriveWhats
تجربة مجانية

باستخدام واجهة برمجة التطبيقات (API) الخاصة بـ ArriveWhats، يمكنك أتمتة إشعارات واتساب مع أي نظام أساسي.

21 يوليو ، 2023

SEND MESSAGE API
🔗 Base URL
https://arrivewhats.com/api
📋 المعاملات العامة
المعامل النوع مطلوب الوصف
tokenString✅ دائماًتوكن الحساب (20 رمز)
receiverString✅ دائماًرقم المستقبل بالصيغة الدولية
msgtextString✅ للنصنص الرسالة
mediaurlURL✅ للوسائطرابط الصورة / الفيديو / الملف
typeString⬜ اختياريimage | video | audio | file | location | poll
filenameString⬜ للملفاتاسم الملف المعروض
lat / lngFloat✅ للموقعخطوط العرض والطول
location_nameString⬜ للموقعاسم الموقع
poll_questionString✅ للتصويتسؤال التصويت
poll_optionsArray✅ للتصويتخيارات التصويت
poll_select_countInteger⬜ للتصويتعدد الاختيارات (افتراضي: 1)
GET / POST إرسال رسالة نصية
إرسال نص — cURL
curl "https://arrivewhats.com/api/send?token=YOUR_TOKEN&receiver=249100858093&msgtext=مرحباً+بك"
POST — JSON body
{
  "token":    "YOUR_TOKEN",
  "receiver": "249100858093",
  "msgtext":  "مرحباً بك من ArriveWhats"
}
Response
{
  "status":  "success",
  "message": "تم إرسال الرسالة بنجاح"
}
إرسال رسالة نصية عادية إلى رقم واتساب بالصيغة الدولية.
PARAMS
tokenYOUR_TOKEN_HERE
receiver249100858093
msgtextمرحباً بك
GET / POST إرسال صورة / فيديو / ملف
إرسال وسائط — cURL
# صورة
curl "https://arrivewhats.com/api/send?token=YOUR_TOKEN&receiver=249100858093&type=image&mediaurl=https://example.com/image.jpg&msgtext=تعليق+الصورة"

# ملف PDF
curl "https://arrivewhats.com/api/send?token=YOUR_TOKEN&receiver=249100858093&type=file&mediaurl=https://example.com/file.pdf&filename=invoice.pdf"
POST — JSON body (فيديو)
{
  "token":    "YOUR_TOKEN",
  "receiver": "249100858093",
  "type":     "video",
  "mediaurl": "https://example.com/video.mp4",
  "msgtext":  "شاهد هذا الفيديو"
}
Response
{
  "status":  "success",
  "message": "تم إرسال الوسائط بنجاح"
}
إرسال صورة أو فيديو أو صوت أو ملف عبر رابط URL عام.
PARAMS
tokenYOUR_TOKEN_HERE
receiver249100858093
typeimage | video | audio | file
mediaurlhttps://example.com/file.jpg
msgtextتعليق اختياري
filenameاسم الملف (للملفات فقط)
GET / POST إرسال موقع جغرافي
إرسال موقع — cURL
curl "https://arrivewhats.com/api/send?token=YOUR_TOKEN&receiver=249100858093&type=location&lat=15.5527&lng=32.5324&location_name=الخرطوم"
POST — JSON body
{
  "token":         "YOUR_TOKEN",
  "receiver":      "249100858093",
  "type":          "location",
  "lat":           15.5527,
  "lng":           32.5324,
  "location_name": "الخرطوم، السودان"
}
Response
{
  "status":  "success",
  "message": "تم إرسال الموقع بنجاح"
}
مشاركة موقع جغرافي عبر واتساب باستخدام خطوط العرض والطول.
PARAMS
tokenYOUR_TOKEN_HERE
receiver249100858093
typelocation
lat15.5527
lng32.5324
location_nameالخرطوم (اختياري)
POST إرسال تصويت (Poll)
إرسال تصويت — POST JSON
{
  "token":             "YOUR_TOKEN",
  "receiver":          "249100858093",
  "type":              "poll",
  "poll_question":     "ما هو تقييمك لخدمتنا؟",
  "poll_options":      ["ممتاز", "جيد", "متوسط", "ضعيف"],
  "poll_select_count": 1
}
Response
{
  "status":  "success",
  "message": "تم إرسال التصويت بنجاح"
}
إرسال استطلاع رأي تفاعلي عبر واتساب مع إمكانية تحديد عدد الاختيارات المسموح بها.
PARAMS
tokenYOUR_TOKEN_HERE
receiver249100858093
typepoll
poll_questionسؤال التصويت
poll_options["خيار 1","خيار 2","خيار 3"]
poll_select_count1 (افتراضي)
GET حالة الحساب
حالة الحساب — cURL
curl "https://arrivewhats.com/api/status?token=YOUR_TOKEN"
Response
{
  "status":    "success",
  "connected": true,
  "phone":     "249100858093",
  "plan":      "pro"
}
التحقق من حالة اتصال الحساب والمعلومات المرتبطة به.
PARAMS
tokenYOUR_TOKEN_HERE
INSTANCE API
POST إنشاء مثيل جديد
Create Instance
https://app.arrivewhats.com/api/create_instance?access_token=648dcxxxxc4f3
Response
{
  "status":      "success",
  "message":     "تم إنشاء معرف المثيل بنجاح",
  "instance_id": "64E4xxxxxxxxx"
}
قم بإنشاء معرف مثيل جديد لربطه بحساب واتساب.
PARAMS
access_token648dcxxxxc4f3
POST احصل على رمز QR
Get QR Code
https://app.arrivewhats.com/api/get_qrcode?instance_id=609ACF283XXXX&access_token=648dcxxxxc4f3
Response
{
  "status":  "success",
  "message": "Success",
  "base64":  "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
}
عرض رمز QR لتسجيل الدخول إلى واتساب ويب. يمكن استقبال النتائج عبر Webhook.
PARAMS
instance_id609ACF283XXXX
access_token648dcxxxxc4f3
POST جلب كود الربط عبر الرقم
Get Pair Code
https://app.arrivewhats.com/api/get_paircode?phone=966xxxxx&instance_id=8873cxxxx&access_token=658xxxxx
Response
{
  "status":  "success",
  "message": "Success",
  "code":    "HKYC-HNFT"
}
إنشاء كود ربط جديد لتوصيل واتساب عبر رقم الهاتف بدلاً من QR.
PARAMS
instance_id609ACF283XXXX
access_token648dcxxxxc4f3
phone966xxxxx
POST تعيين Webhook للاستقبال
Set Webhook
https://app.arrivewhats.com/api/set_webhook?webhook_url=https%3A%2F%2Fwebhook.site%2Fxxxxxxxx&enable=true&instance_id=609ACF283XXXX&access_token=648dcxxxxc4f3
Response
{
  "status":  "success",
  "message": "Success"
}
استقبال جميع أحداث واتساب (رسائل واردة، صادرة، تغيير حالة الاتصال، ...) عبر Webhook.
PARAMS
webhook_urlhttps://webhook.site/xxxxxxxx
enabletrue
instance_id609ACF283XXXX
access_token648dcxxxxc4f3
POST إعادة تشغيل المثيل
Reboot Instance
https://app.arrivewhats.com/api/reboot?instance_id=609ACF283XXXX&access_token=648dcxxxxc4f3
Response
{
  "status":  "success",
  "message": "Success"
}
تسجيل الخروج من واتساب ويب وإجراء مسح جديد لإعادة الاتصال.
PARAMS
instance_id609ACF283XXXX
access_token648dcxxxxc4f3
POST إعادة تعيين المثيل
Reset Instance
https://app.arrivewhats.com/api/reset_instance?instance_id=609ACF283XXXX&access_token=648dcxxxxc4f3
Response
{
  "status":  "success",
  "message": "Success"
}
تسجيل الخروج من واتساب ويب، تغيير instance_id، وحذف جميع البيانات القديمة للمثيل.
PARAMS
instance_id609ACF283XXXX
access_token648dcxxxxc4f3
POST إعادة الاتصال
Reconnect
https://app.arrivewhats.com/api/reconnect?instance_id=609ACF283XXXX&access_token=648dcxxxxc4f3
Response
{
  "status":  "success",
  "message": "Success"
}
إعادة بدء الاتصال مع واتساب ويب عند انقطاع الاتصال دون الحاجة لمسح QR جديد.
PARAMS
instance_id609ACF283XXXX
access_token648dcxxxxc4f3