الرسائل

أرسل رسائل إلى مركز الشريك الخاص بالمستخدمين النهائيين.

إرسال رسالة

POST /api/v1/messages

ينشئ رسالة مركز مستقلة (وليست محادثة دعم).

الترويسات

Authorization: Bearer <api_key>
Content-Type: application/json

معاملات الجسم

الحقل	النوع	مطلوب	الوصف
phone	string	نعم	وجهة E.164
body	string	*	نص الرسالة / التسمية التوضيحية (مطلوب للنوع text)
content_type	string	لا	القيمة الافتراضية: text. راجع أنواع الوسائط
template_code	string	لا	يُنشأ باستخدام vars
vars	object	لا	متغيرات القالب
priority	string	لا	otp · notification · chat · …
idempotency_key	string	لا	إزالة تكرار المحاولات
media_url	string	*	عنوان URL لملف بعيد لأنواع الوسائط
media_base64	string	*	ملف base64 بدلًا من عنوان URL
media_filename	string	لا	الاسم المعروض
media_mimetype	string	لا	نوع MIME
link_url / url	string	*	للنوع content_type=link
link_label / cta	string	لا	تسمية الزر
link_title	string	لا	عنوان البطاقة
link_description	string	لا	وصف البطاقة
link_image_url	string	لا	صورة البطاقة
html	string	*	للنوع content_type=html
subject	string	لا	عنوان النشرة الإخبارية (html)
preview	string	لا	معاينة بنص عادي (html)

مثال نصي

curl -X POST "$API/messages" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+228XXXXXXXX",
    "body": "Votre dossier est en cours de traitement.",
    "priority": "notification",
    "idempotency_key": "seed-dossier-1001"
  }'

الاستجابة 201

{
  "message_id": 142,
  "ref": "52c22ee01478…",
  "phone": "+228XXXXXXXX",
  "partner": "seed",
  "direction": "out",
  "content_type": "text",
  "body": "Votre dossier est en cours de traitement.",
  "state": "delivered",
  "priority": "notification",
  "created_at": "2026-07-21 07:10:00"
}

الحصول على رسالة

GET /api/v1/messages/{message_id}

يُرجع الرسالة ومحاولات التسليم الاختيارية.

سرد الرسائل

GET /api/v1/messages

معامل الاستعلام	الوصف
phone	التصفية حسب هاتف الحساب
state	queued · delivered · read · …
q	البحث في النص / جهة الاتصال
limit	حجم الصفحة

وضع علامة مقروءة / غير مقروءة (أدوات الشركاء)

POST /api/v1/messages/{id}/read
POST /api/v1/messages/{id}/unread
POST /api/v1/messages/read

إرسال دردشة من وكيل

POST /api/v1/agent/messages

يستخدمه وكلاء Partner Hub. ويمكن ربطه بمحادثة دعم مفتوحة عند الاقتضاء. فضّل /messages لإشعارات المركز الآلية.