الانتقال إلى المحتوى الرئيسي
POST
إعادة توجيه الرسالة

التفويضات

Authorization
string
header
مطلوب

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

الترويسات

X-Device-Id
string

معرف الجهاز لدعم الأجهزة المتعددة. مطلوب عند تسجيل أجهزة متعددة. إذا تم تسجيل جهاز واحد فقط، فسيتم استخدامه كجهاز افتراضي. يمكن أيضا توفيره كعامل استعلام device_id.

مثال:

"my-device-id"

معلمات المسار

message_id
string
مطلوب

معرف الرسالة المصدر من وحدة تخزين الدردشة

الجسم

application/json

الحقول الاختيارية التي تجمل الرسالة بدلا من إرسالها الآن. تعيين scheduled_at إلى الجدول الزمني؛ بدونها يتم إرسال الرسالة فوراً. عامل خلفية يرسلها في الوقت المقرر، إعادة المحاولة بينما الجهاز غير متصل أو غير مسجل الدخول. يتم تخزين الوسائط التي تم تحميلها على خادم حتى ينتهي الجدول. في محتوى طلبات multipart/form-data، أرسل weekdays كحقل متكرر (weekdays=1، weekdays=3).

phone
string
مطلوب

الوجهة رقم الهاتف أو مجموعة JID

مثال:

"6289685024051@s.whatsapp.net"

scheduled_at
string<date-time>

RFC3339 وقت الإرسال الأول. يجب أن يكون في المستقبل. يحدث الإرسال الأول دائمًا في هذا الموعد، حتى إذا وقع خارج weekdays أو day_of_month؛ فهذان الحقلان يحددان مرات التكرار التالية.

مثال:

"2026-10-01T09:00:00+07:00"

timezone
string

المنطقة الزمنية للوكالة الدولية للطاقة المستخدمة لحساب العمليات المتكررة مطلوب عند تعيين الـ scheduled_at

مثال:

"Asia/Jakarta"

recurrence
enum<string>
افتراضي:once

كم مرة تكرر إرسال

الخيارات المتاحة:
once,
daily,
weekly,
monthly
weekdays
integer[]

أيام الإرسال ، 0=الأحد خلال 6=يوم السبت. مطلوب عندما يكون التكرار أسبوعيا.

النطاق المطلوب: 0 <= x <= 6
مثال:
day_of_month
integer

يوم من الشهر الذي سيتم إرساله، ضغطت إلى اليوم الأخير من الشهر. مطلوب عندما يكون التكرار شهرياً.

النطاق المطلوب: 1 <= x <= 31
مثال:

15

end_at
string<date-time>

التكرار فقط. لا يرسل بعد هذا الوقت؛ يجب أن يكون بعد الموعد المحدد.

مثال:

"2026-12-31T23:59:59+07:00"

occurrence_limit
integer

التكرار فقط. توقف بعد هذا العديد من الإرسالات.

النطاق المطلوب: x >= 1
مثال:

10

duration
integer

تجاوز مدة الرسائل المختفية اختياريا (0، 86400، 604800، 7776000)

مثال:

0

force_reupload
boolean

تخطي إعادة استخدام مرجع الوسائط وإعادة تحميل الوسائط قبل الإرسال

مثال:

false

الاستجابة

حسناً

code
string
مثال:

"SUCCESS"

message
string
مثال:

"Success"

results
object