الـ Webhooks

تم إنشاء/تحديث تصنيف

يتم إطلاقه عند إضافة أو تعديل تصنيف واتساب بيزنس.

توصيات

  • استخدم متغيرات البيئة لبيانات الاعتماد الحساسة مثل رموز الوصول.

  • قم بتنفيذ معالجة قوية للأخطاء ومنطق إعادة المحاولة.

تصنيف التفاعل: إتقان ويب هوك تحديث التصنيفات

في عالم إدارة واتساب بيزنس، التنظيم هو محرك الكفاءة. التصنيفات هي أداة التصنيف الأصلية لنظام واتساب، وتسمح للوكلاء بتحديد أولويات محادثاتهم وتقسيمها بصرياً. ويب هوك تم إنشاء/تحديث تصنيف (Upsert) هو الإشارة الأساسية لتطور تصنيفات مؤسستك. سواء تم إنشاء تصنيف "مبيعات ذات أولوية" جديد أو تمت إعادة تسمية تصنيف "قيد المراجعة" الحالي، يوفر حدث [label.upsert] لبنيتك التحتية البيانات الفورية المطلوبة للحفاظ على مزامنة مثالية بين واجهة واتساب ونظام CRM المركزي الخاص بك.

🏗️ الفلسفة المعمارية: التصنيفات كبيانات هيكلية

لبناء تكامل مؤسسي متميز، يجب أن يعامل نظامك التصنيفات كـ "مفاتيح أساسية للتقسيم". يتكون التصنيف من ثلاث خصائص أساسية: معرف (ID) فريد، اسم (عنوان الفئة)، و لون (الأولوية البصرية).

1. جسر التصنيفات

يجب التعامل مع حدث تحديث التصنيف كـ تحديث للإعدادات.

  • مزامنة CRM: يجب أن يعكس نظامك هذه التصنيفات كـ "وسوم" أو "مجلدات حالة" داخل نظام CRM الخاص بك. عندما يتغير اسم تصنيف في واتساب، يجب أن يقوم نظام CRM بتحديث اسم العرض الخاص به فوراً لضمان عدم تعرض الوكلاء لـ "عدم تطابق السياق".
  • التحديث الذري: بما أن الحمولة تحتوي على كائن التصنيف الكامل، يمكن لطبقة الاستيعاب لديك استخدام منطق "تحديث أو إدراج". إذا كان معرف التصنيف جديداً، أضفه؛ وإذا كان موجوداً، فقم بتحديث بياناته.

2. النبض البصري (الألوان كأولوية)

تستخدم تصنيفات واتساب أكواد ألوان لتمثيل الأولوية. يقوم المهندس المتميز برسم خرائط لهذه الألوان لمستويات الأولوية الداخلية. على سبيل المثال، قد يطلق التصنيف "الأحمر" تنبيهاً ذا أولوية أعلى في قناة Slack الداخلية من التصنيف "الأزرق".

🚀 حالات الاستخدام الاستراتيجية

1. التزامن التلقائي لوسوم CRM

بالنسبة للشركات التي تنتقل من استخدام الهاتف اليدوي إلى سير عمل مؤتمت، يعد هذا الويب هوك هو "الجسر التاريخي". عندما يقوم الوكلاء بإنشاء تصنيفات على هواتفهم، يستمع نظامك الخلفي لها ويقوم تلقائياً بإنشاء "شرائح" مقابلة في برامج التسويق أو تتبع العملاء المتوقعين.

2. الاتساق البصري عبر لوحات التحكم المخصصة

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

🎯 أفضل الممارسات التشغيلية

  • ربط اللون بالخطورة: احتفظ بجدول ربط داخلي: مثلاً #DFE5E7 (رمادي فاتح) = مؤرشف، #FFD700 (ذهبي) = مميز.
  • تحذير "الرموز التعبيرية": تدعم تصنيفات واتساب الرموز التعبيرية. تأكد من أن قاعدة بياناتك تدعم ترميز UTF-8 بالكامل حتى لا يصبح التصنيف "🚀 مبيعات" هو "؟ مبيعات".
  • التنسيق مع الحذف: يخبرك هذا الويب هوك بتحديث التصنيف نفسه، لكنه لا يخبرك إذا تمت إزالته من دردشة معينة. استخدمه دائماً بالتنسيق مع [label.chat.deleted].

الردود المتوقعة

استكشف كافة الردود والنتائج المحتملة من الخادم. قمنا بتوثيق كل كود حالة (Status Code) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.

Webhook Payload Example
application/json
string *
number *
string *
object *
string *
string *
object *
object *

Example

{
"id": "evt_01...",
"timestamp": 1634567890123,
"session": "default",
"metadata": {
  "user.id": "123",
  "user.email": "email@example.com"
  },
"engine": "WEBJS",
"event": "label.upsert",
"payload": {
  "label": {
    "id": "1",
    "name": "New Customer",
    "color": "#DFE5E7"
    }
  },
"me": {
  "id": "11111111111@c.us",
  "lid": "123@lid",
  "pushName": "Instance"
  }
}
الموضوع السابقرفض المكالمة
الموضوع التاليتم حذف تصنيف

Command Palette

Search for a command to run...