إرسال رسالة واتساب
يرسل رسالة نصية أو ملف وسائط عبر جلسة متصلة. الحقول text و to هي أسماء بديلة مقبولة لـ message و number.
POST/api/send
الجسم (JSON)
| الاسم | النوع | إلزامي | الوصف |
|---|---|---|---|
| access_token | string | نعم | مفتاح API (أو Authorization header). |
| instance_id | string | نعم | معرّف الجلسة المتصلة. |
| number | string | نعم | رقم المستلم بصيغة دولية بدون +. مثال: 9665XXXXXXXX. البديل: to. |
| message | string | اختياري | نص الرسالة (أو استخدم text). إلزامي إذا لم تُرسِل media_url. |
| media_url | string (URL) | اختياري | رابط عام لملف صورة/فيديو/PDF لإرساله. إلزامي إذا لم تُرسِل message. |
| filename | string | اختياري | اسم الملف الظاهر للمستلم (يستخدم مع media_url). |
حقول الاستجابة
| الاسم | النوع | إلزامي | الوصف |
|---|---|---|---|
| message_id | string | نعم | معرّف واتساب الفريد للرسالة (يفيد للتتبّع في السجل). |
| to | string | نعم | الرقم النهائي بصيغة JID الخاصة بواتساب. |
تلميح
إذا كانت الجلسة غير متصلة سيعيد الخادم 409 INSTANCE_NOT_CONNECTED. نفّذ استعلام list_instance قبل الإرسال للتأكد من الحالة.