الانتقال إلى المحتوى الرئيسي
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"

الجسم

multipart/form-data

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

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

phone
string

رقم الهاتف مع رمز البلد

مثال:

"6289685028129@s.whatsapp.net"

sticker
file

ملف صورة الملصق (jpg/jpeg/png/webp/gif)

sticker_url
string

عنوان URL لصورة الملصق لإرسالها

مثال:

"https://example.com/sticker.png"

duration
integer

اختفاء مدة الرسالة في ثواني. القيم المسموح بها: صفر (بدون انتهاء الصلاحية)، 400 86400 (24 ساعة)، 604800 (7 د)، 000 776 (90 د).

مثال:

86400

reply_message_id
string

معرف الرسالة الذي تريد الرد عليه

مثال:

"3EB089B9D6ADD58153C561"

is_forwarded
boolean

سواء كان هذا ملصق معاد توجيهه

مثال:

false

الاستجابة

حسناً

code
string
مثال:

"SUCCESS"

message
string
مثال:

"Success"

results
object