انتقل إلى المحتوى
أدلة المستخدم أدلة كيفية الاستخدام الدعم طلب عرض توضيحي تسجيل الدخول
Pushwoosh.com

إعادة تسمية

POST https://api.pushwoosh.com/messaging/v2/rename

يعيّن أو يمسح اسم الحملة لرسالة تم إنشاؤها مسبقًا، محددة بواسطة message_code الخاص بها. لا يتغير أي شيء آخر في الرسالة. يبقى المحتوى والجمهور والجدول الزمني تمامًا كما كانوا.

إعادة التسمية متاحة فقط عندما تكون الرسالة لا تزال معلقة — تم إنشاؤها ولكن لم يتم التقاطها بعد للإرسال. الرسالة التي انتقلت إلى waiting أو processing أو أي حالة لاحقة لم يعد بالإمكان إعادة تسميتها. في لوحة التحكم، تظهر هذه الحالة في عمود الحالة باسم مجدولة وليس حرفيًا “Pending”. انظر حالات الرسائل.

للتحقق مما إذا كانت الرسالة لا تزال في حالة قابلة لإعادة التسمية، انظر التحقق من حالة الرسالة.

الطلب

Anchor link to

قم بالمصادقة باستخدام رمز Server API token الخاص بك في ترويسة Authorization: Token <API_TOKEN>.

الحقلالنوعمطلوبالوصف
message_codestringنعمرمز الرسالة (Message code) للرسالة المراد إعادة تسميتها، كما تم إرجاعه بواسطة Notify في result.message_code.
campaign_namestringنعماسم الحملة الجديد. يتم اقتطاعه وقصّه إلى 255 حرفًا. السلسلة الفارغة تمسح الاسم.

مثال على الطلب

Anchor link to
Terminal window
curl -X POST https://api.pushwoosh.com/messaging/v2/rename \
  -H "Authorization: Token YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "message_code": "XXXX-XXXXXXXX-XXXXXXXX",
    "campaign_name": "Flash_Sale_Push"
  }'

الاستجابة

Anchor link to

عند النجاح، تُرجع HTTP 200 مع جسم JSON فارغ.

{}

الأخطاء

Anchor link to

تستخدم الأخطاء غلاف الخطأ القياسي لـ gRPC-Gateway: { "code": ..., "message": ..., "details": [...] }.

حالة HTTPالشرط
400message_code مفقود.
400الرسالة ليست في حالة قابلة لإعادة التسمية (لم تعد pending).
403الرسالة تنتمي إلى حساب آخر.
404لا توجد رسالة لـ message_code المحدد.
500حدث خطأ داخلي أثناء تحميل الرسالة أو تطبيق الاسم الجديد. أعد محاولة الطلب.

مثال

إعادة تسمية رسالة بدأ إرسالها بالفعل تُرجع HTTP 400:

{
  "code": 9,
  "message": "message status \"waiting\" is not renamable",
  "details": []
}

التحقق من حالة الرسالة

Anchor link to

قبل إعادة التسمية، يمكنك التحقق مما إذا كانت الرسالة لا تزال في حالة قابلة لإعادة التسمية. بالإضافة إلى قراءة عمود الحالة (Status) في جدول الرسائل في لوحة التحكم (الحملات ← الرسائل لمرة واحدة)، حيث تظهر الرسالة القابلة لإعادة التسمية باسم مجدولة وليس حرفيًا “Pending”، يمكنك الاستعلام عن الحالة برمجيًا باستخدام messages:list:

  • مرر message_code في مصفوفة filters.messages_codes (إلى جانب filters.application المطلوب).
  • اقرأ حقل status للإدخال المطابق في items[].

مواضيع ذات صلة

Anchor link to
Notify
Update
Cancel
إحصائيات الرسائل
نظرة عامة على Messaging API v2
الترحيل من v1