نظرة عامة
مكّن وكلاءك من إدارة عمليات دعم العملاء عبر Zendesk. أنشئ التذاكر وحدّثها، وأدر المستخدمين، وتتبع مقاييس الدعم، وبسّط سير عمل خدمة العملاء باستخدام الأتمتة المدعومة بالذكاء الاصطناعي.المتطلبات الأساسية
قبل استخدام تكامل Zendesk، تأكد من توفر ما يلي:- حساب CrewAI AMP مع اشتراك فعّال
- حساب Zendesk بصلاحيات API المناسبة
- ربط حساب Zendesk الخاص بك عبر صفحة التكاملات
إعداد تكامل Zendesk
1. ربط حساب Zendesk الخاص بك
- انتقل إلى تكاملات CrewAI AMP
- ابحث عن Zendesk في قسم تكاملات المصادقة
- انقر على Connect وأكمل عملية OAuth
- امنح الصلاحيات اللازمة لإدارة التذاكر والمستخدمين
- انسخ رمز المؤسسة من إعدادات التكامل
2. تثبيت الحزمة المطلوبة
3. إعداد متغير البيئة
لاستخدام التكاملات مع
Agent(apps=[]), يجب تعيين متغير البيئة
CREWAI_PLATFORM_INTEGRATION_TOKEN برمز المؤسسة الخاص بك..env:
الأدوات المتاحة
إدارة التذاكر
zendesk/create_ticket
zendesk/create_ticket
الوصف: إنشاء تذكرة دعم جديدة في Zendesk.المعاملات:
ticketSubject(string, مطلوب): سطر موضوع التذكرةticketDescription(string, مطلوب): أول تعليق يظهر على التذكرةrequesterName(string, مطلوب): اسم المستخدم الذي يطلب الدعمrequesterEmail(string, مطلوب): بريد المستخدم الذي يطلب الدعمticketType(string, اختياري): نوع التذكرة - الخيارات: problem, incident, question, taskticketPriority(string, اختياري): مستوى الأولوية - الخيارات: urgent, high, normal, lowticketStatus(string, اختياري): حالة التذكرة - الخيارات: new, open, pending, hold, solved, closed
zendesk/update_ticket
zendesk/update_ticket
الوصف: تحديث تذكرة دعم موجودة في Zendesk.المعاملات:
ticketId(string, مطلوب): معرّف التذكرة المراد تحديثهاrequesterName(string, مطلوب): اسم المستخدم الذي طلب هذه التذكرةrequesterEmail(string, مطلوب): بريد المستخدم الذي طلب هذه التذكرةticketSubject(string, اختياري): موضوع التذكرة المحدّثticketPriority(string, اختياري): الأولوية المحدّثةticketStatus(string, اختياري): الحالة المحدّثة
zendesk/get_ticket_by_id
zendesk/get_ticket_by_id
الوصف: استرجاع تذكرة محددة بواسطة معرّفها.المعاملات:
ticketId(string, مطلوب): معرّف التذكرة المراد استرجاعها
zendesk/add_comment_to_ticket
zendesk/add_comment_to_ticket
الوصف: إضافة تعليق أو ملاحظة داخلية إلى تذكرة موجودة.المعاملات:
ticketId(string, مطلوب): معرّف التذكرة لإضافة التعليق إليهاcommentBody(string, مطلوب): رسالة التعليقisInternalNote(boolean, اختياري): عيّن إلى true للملاحظات الداخلية بدلاً من الردود العامة
zendesk/search_tickets
zendesk/search_tickets
الوصف: البحث عن التذاكر باستخدام فلاتر ومعايير مختلفة.المعاملات:
ticketSubject(string, اختياري): تصفية حسب النص في موضوع التذكرةticketStatus(string, اختياري): تصفية حسب الحالةticketPriority(string, اختياري): تصفية حسب الأولويةsort_by(string, اختياري): حقل الفرز - الخيارات: created_at, updated_at, priority, statussort_order(string, اختياري): اتجاه الفرز - الخيارات: asc, desc
إدارة المستخدمين
zendesk/create_user
zendesk/create_user
الوصف: إنشاء مستخدم جديد في Zendesk.المعاملات:
name(string, مطلوب): الاسم الكامل للمستخدمemail(string, اختياري): عنوان البريد الإلكترونيphone(string, اختياري): رقم الهاتفrole(string, اختياري): دور المستخدم - الخيارات: admin, agent, end-user
zendesk/update_user
zendesk/update_user
الوصف: تحديث معلومات مستخدم موجود.المعاملات:
userId(string, مطلوب): معرّف المستخدم المراد تحديثهname(string, اختياري): اسم المستخدم المحدّثemail(string, اختياري): البريد الإلكتروني المحدّثrole(string, اختياري): الدور المحدّث
zendesk/get_user_by_id
zendesk/get_user_by_id
الوصف: استرجاع مستخدم محدد بواسطة معرّفه.المعاملات:
userId(string, مطلوب): معرّف المستخدم المراد استرجاعه
zendesk/search_users
zendesk/search_users
الوصف: البحث عن المستخدمين باستخدام معايير مختلفة.المعاملات:
name(string, اختياري): تصفية حسب اسم المستخدمemail(string, اختياري): تصفية حسب البريد الإلكترونيrole(string, اختياري): تصفية حسب الدور
أدوات إدارية
zendesk/get_ticket_fields
zendesk/get_ticket_fields
الوصف: استرجاع جميع الحقول القياسية والمخصصة المتاحة للتذاكر.المعاملات:
paginationParameters(object, اختياري): إعدادات الترقيم
zendesk/get_ticket_audits
zendesk/get_ticket_audits
الوصف: الحصول على سجلات التدقيق (السجل للقراءة فقط) للتذاكر.المعاملات:
ticketId(string, اختياري): الحصول على سجلات التدقيق لتذكرة محددة
مستويات أولوية التذاكر
فهم مستويات الأولوية:- urgent - مشاكل حرجة تتطلب اهتماماً فورياً
- high - مشاكل مهمة يجب معالجتها بسرعة
- normal - أولوية قياسية لمعظم التذاكر
- low - مشاكل ثانوية يمكن معالجتها عند الإمكان
سير عمل حالة التذكرة
تقدم حالة التذكرة القياسي:- new - أُنشئت حديثاً، لم تُعيّن بعد
- open - يتم العمل عليها بنشاط
- pending - في انتظار رد العميل أو إجراء خارجي
- hold - متوقفة مؤقتاً
- solved - تم حل المشكلة، في انتظار تأكيد العميل
- closed - اكتملت التذكرة وأُغلقت
