الانتقال إلى المحتوى الرئيسي

نظرة عامة

مكّن وكلاءك من إدارة عمليات دعم العملاء عبر Zendesk. أنشئ التذاكر وحدّثها، وأدر المستخدمين، وتتبع مقاييس الدعم، وبسّط سير عمل خدمة العملاء باستخدام الأتمتة المدعومة بالذكاء الاصطناعي.

المتطلبات الأساسية

قبل استخدام تكامل Zendesk، تأكد من توفر ما يلي:

إعداد تكامل Zendesk

1. ربط حساب Zendesk الخاص بك

  1. انتقل إلى تكاملات CrewAI AMP
  2. ابحث عن Zendesk في قسم تكاملات المصادقة
  3. انقر على Connect وأكمل عملية OAuth
  4. امنح الصلاحيات اللازمة لإدارة التذاكر والمستخدمين
  5. انسخ رمز المؤسسة من إعدادات التكامل

2. تثبيت الحزمة المطلوبة

uv add crewai-tools

3. إعداد متغير البيئة

لاستخدام التكاملات مع Agent(apps=[]), يجب تعيين متغير البيئة CREWAI_PLATFORM_INTEGRATION_TOKEN برمز المؤسسة الخاص بك.
export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"
أو أضفه إلى ملف .env:
CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token

الأدوات المتاحة

إدارة التذاكر

الوصف: إنشاء تذكرة دعم جديدة في Zendesk.المعاملات:
  • ticketSubject (string, مطلوب): سطر موضوع التذكرة
  • ticketDescription (string, مطلوب): أول تعليق يظهر على التذكرة
  • requesterName (string, مطلوب): اسم المستخدم الذي يطلب الدعم
  • requesterEmail (string, مطلوب): بريد المستخدم الذي يطلب الدعم
  • ticketType (string, اختياري): نوع التذكرة - الخيارات: problem, incident, question, task
  • ticketPriority (string, اختياري): مستوى الأولوية - الخيارات: urgent, high, normal, low
  • ticketStatus (string, اختياري): حالة التذكرة - الخيارات: new, open, pending, hold, solved, closed
الوصف: تحديث تذكرة دعم موجودة في Zendesk.المعاملات:
  • ticketId (string, مطلوب): معرّف التذكرة المراد تحديثها
  • requesterName (string, مطلوب): اسم المستخدم الذي طلب هذه التذكرة
  • requesterEmail (string, مطلوب): بريد المستخدم الذي طلب هذه التذكرة
  • ticketSubject (string, اختياري): موضوع التذكرة المحدّث
  • ticketPriority (string, اختياري): الأولوية المحدّثة
  • ticketStatus (string, اختياري): الحالة المحدّثة
الوصف: استرجاع تذكرة محددة بواسطة معرّفها.المعاملات:
  • ticketId (string, مطلوب): معرّف التذكرة المراد استرجاعها
الوصف: إضافة تعليق أو ملاحظة داخلية إلى تذكرة موجودة.المعاملات:
  • ticketId (string, مطلوب): معرّف التذكرة لإضافة التعليق إليها
  • commentBody (string, مطلوب): رسالة التعليق
  • isInternalNote (boolean, اختياري): عيّن إلى true للملاحظات الداخلية بدلاً من الردود العامة
الوصف: البحث عن التذاكر باستخدام فلاتر ومعايير مختلفة.المعاملات:
  • ticketSubject (string, اختياري): تصفية حسب النص في موضوع التذكرة
  • ticketStatus (string, اختياري): تصفية حسب الحالة
  • ticketPriority (string, اختياري): تصفية حسب الأولوية
  • sort_by (string, اختياري): حقل الفرز - الخيارات: created_at, updated_at, priority, status
  • sort_order (string, اختياري): اتجاه الفرز - الخيارات: asc, desc

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

الوصف: إنشاء مستخدم جديد في Zendesk.المعاملات:
  • name (string, مطلوب): الاسم الكامل للمستخدم
  • email (string, اختياري): عنوان البريد الإلكتروني
  • phone (string, اختياري): رقم الهاتف
  • role (string, اختياري): دور المستخدم - الخيارات: admin, agent, end-user
الوصف: تحديث معلومات مستخدم موجود.المعاملات:
  • userId (string, مطلوب): معرّف المستخدم المراد تحديثه
  • name (string, اختياري): اسم المستخدم المحدّث
  • email (string, اختياري): البريد الإلكتروني المحدّث
  • role (string, اختياري): الدور المحدّث
الوصف: استرجاع مستخدم محدد بواسطة معرّفه.المعاملات:
  • userId (string, مطلوب): معرّف المستخدم المراد استرجاعه
الوصف: البحث عن المستخدمين باستخدام معايير مختلفة.المعاملات:
  • name (string, اختياري): تصفية حسب اسم المستخدم
  • email (string, اختياري): تصفية حسب البريد الإلكتروني
  • role (string, اختياري): تصفية حسب الدور

أدوات إدارية

الوصف: استرجاع جميع الحقول القياسية والمخصصة المتاحة للتذاكر.المعاملات:
  • paginationParameters (object, اختياري): إعدادات الترقيم
الوصف: الحصول على سجلات التدقيق (السجل للقراءة فقط) للتذاكر.المعاملات:
  • ticketId (string, اختياري): الحصول على سجلات التدقيق لتذكرة محددة

مستويات أولوية التذاكر

فهم مستويات الأولوية:
  • urgent - مشاكل حرجة تتطلب اهتماماً فورياً
  • high - مشاكل مهمة يجب معالجتها بسرعة
  • normal - أولوية قياسية لمعظم التذاكر
  • low - مشاكل ثانوية يمكن معالجتها عند الإمكان

سير عمل حالة التذكرة

تقدم حالة التذكرة القياسي:
  • new - أُنشئت حديثاً، لم تُعيّن بعد
  • open - يتم العمل عليها بنشاط
  • pending - في انتظار رد العميل أو إجراء خارجي
  • hold - متوقفة مؤقتاً
  • solved - تم حل المشكلة، في انتظار تأكيد العميل
  • closed - اكتملت التذكرة وأُغلقت

أمثلة الاستخدام

إعداد Agent أساسي لـ Zendesk

from crewai import Agent, Task, Crew
from crewai import Agent, Task, Crew

# Create an agent with Zendesk capabilities
zendesk_agent = Agent(
    role="Support Manager",
    goal="Manage customer support tickets and provide excellent customer service",
    backstory="An AI assistant specialized in customer support operations and ticket management.",
    apps=['zendesk']  # All Zendesk actions will be available
)

# Task to create a new support ticket
create_ticket_task = Task(
    description="Create a high-priority support ticket for John Smith who is unable to access his account after password reset",
    agent=zendesk_agent,
    expected_output="Support ticket created successfully with ticket ID"
)

# Run the task
crew = Crew(
    agents=[zendesk_agent],
    tasks=[create_ticket_task]
)

crew.kickoff()

إدارة التذاكر المتقدمة

from crewai import Agent, Task, Crew

ticket_manager = Agent(
    role="Ticket Manager",
    goal="Manage support ticket workflows and ensure timely resolution",
    backstory="An AI assistant that specializes in support ticket triage and workflow optimization.",
    apps=['zendesk']
)

# Task to manage ticket lifecycle
ticket_workflow = Task(
    description="""
    1. Create a new support ticket for account access issues
    2. Add internal notes with troubleshooting steps
    3. Update ticket priority based on customer tier
    4. Add resolution comments and close the ticket
    """,
    agent=ticket_manager,
    expected_output="Complete ticket lifecycle managed from creation to resolution"
)

crew = Crew(
    agents=[ticket_manager],
    tasks=[ticket_workflow]
)

crew.kickoff()