التسميات

التسمية اسم ولون تضعهما على محادثة لترتيب صندوق واردك. التسميات خاصة بكل حساب، لا يراها الطرف الآخر، وهي ترافق كل محادثة تقرأها.

لمن هذه التسميات

هذه تسميات Sendveo لا تسميات واتساب للأعمال، والفرق ليس شكليًا. لا تنشر خدمة الرسائل أي واجهة برمجية للتسميات على الإطلاق: لا شيء لسرد تسميات الهاتف، ولا لتطبيق واحدة، ولا لإعلامك عند إضافة أخرى. لم تكن هناك نسخة من هذه الميزة تقرأ تسمياتك الحقيقية، لذلك يقدّم Sendveo العقد نفسه من جانبه هو. التسمية في Sendveo لا تظهر في واتساب على الهاتف، والتسمية الموجودة على الهاتف لا تظهر هنا. وإذا ظهرت يومًا واجهة برمجية للتسميات، فستبقى هذه النقاط النهائية وحقل labels في المحادثة كما هي تمامًا، ولن يتغيّر سوى ما وراءها.

إدارة التسميات

السرد والإنشاء وإعادة التسمية وتغيير اللون والحذف. يظهر chatCount في القائمة ولا يظهر في أي مكان آخر: ففي المحادثة سيكون عدّادًا لكل تسمية في كل صف.

curl -X POST https://api.sendveo.com/v1/labels \
  -H "X-API-KEY: sv_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Quote sent", "color": "teal" }'

{
  "label": { "id": "lbl_m8k3x7q2", "name": "Quote sent", "color": "teal", "chatCount": 0 }
}

حذف التسمية يزيلها من كل محادثة تحملها، ويذكر الرد عددها في chats. فتسمية اختفت من القائمة لكنها ما زالت ظاهرة على أربعين محادثة أسوأ من أي من الحالتين.

وضع تسمية على محادثة

أرسل { labelId } لتسمية تملكها بالفعل، أو { name } لإنشائها وتطبيقها في نداء واحد. صيغة الاسم هي ما يحتاجه حقل الكتابة للإضافة: البديل هو السرد ثم الإنشاء ثم التطبيق، أي ثلاث رحلات ذهاب وإياب لعمل واحد، وفي وسطها تسابق قد ينشئ فيه تبويبان التسمية نفسها.

curl -X POST https://api.sendveo.com/v1/chats/chat_9Fp2/labels \
  -H "X-API-KEY: sv_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Urgent" }'

تطبيق تسمية تحملها المحادثة أصلًا يعطي 200 لا تعارضًا: طلبت حالة، والحالة قائمة. أما إزالة تسمية لا تحملها فتعطي 404. وعدم التماثل مقصود، لأن إزالة تسمية لم تحملها المحادثة قط تعني في الغالب أن المُستدعي يعمل انطلاقًا من قائمة قديمة.

التسميات على محادثة

تحمل كل محادثة وكل مجموعة حقل labels، وهو موجود دائمًا ويكون [] لمن لا تسمية لها. وخلافًا لـ members، ترافق التسميات القائمة كما ترافق القراءة المفردة: فهي ضمّ محلي، أي أن صفحة من خمسين محادثة تكلّف استعلامًا إضافيًا واحدًا بدل خمسين نداءً إلى خدمة الرسائل، وتصفية صندوق الوارد حسب التسمية هي بالضبط ما يفعله الناس بها.

{
  "id": "cht_m8k3x7q2a1b4",
  "chatId": "chat_9Fp2",
  "name": "Khadija Alaoui",
  "labels": [
    { "id": "lbl_m8k3x7q2", "name": "Quote sent", "color": "teal" },
    { "id": "lbl_m8k3wp41", "name": "Urgent", "color": "rose" }
  ]
}

الأسماء والألوان والحدود

color اسم من لوحة ألوان ثابتة، وليس CSS أبدًا: slate وviolet وblue وteal وgreen وamber وorange وrose. وأي قيمة أخرى تعطي 400 VALIDATION_FAILED يذكر اللوحة كاملة. واللون الحر سيكون نصًا يأتي من المُستدعي ليستقر في سمة التنسيق في لوحة التحكم، والقائمة التي يحمل كل صف فيها درجة مختارة يدويًا قائمة لا يستطيع أحد تصفّحها. أغفِل color فيُشتق لون من الاسم اشتقاقًا حتميًا، حتى إن حذف تسمية ثم إعادة إنشائها يعيد اللون نفسه.

تُوحَّد المسافات في الأسماء وتُقلَّم أطرافها، فتصير عرض سعر وعرض سعر تسمية واحدة، وهي فريدة لكل حساب. والتكرار يعطي 409 تذكر details فيه التسمية التي اصطدم بها، فيعرف السكربت الذي يستورد الفئات أي صفوفه كانت جديدة. بحد أقصى 40 حرفًا لكل اسم، و50 تسمية لكل حساب، و20 تسمية لكل محادثة.

النطاقات

قراءة التسميات تتطلّب chats:read، وكل ما يغيّر تسمية يتطلّب chats:manage. ولا يوجد نطاق جديد، وذلك عن قصد: التسمية تُطبَّق على محادثة وتبقى غير مرئية خارج حسابك، وهو أقل ظهورًا من أرشفة محادثة أو كتم صوتها، كما أن أي مفتاح صدر قبل وجود نطاق ما لا يحمله. وإعادة استخدام نطاقات المحادثات تعني أن كل مفتاح أُنشئ منذ وصول المحادثات يعمل مع التسميات فورًا.