تكامل Zendesk

نظرة عامة

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

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

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

• حساب CrewAI AMP مع اشتراك فعّال
• حساب Zendesk بصلاحيات API المناسبة
• ربط حساب Zendesk الخاص بك عبر صفحة التكاملات

إعداد تكامل Zendesk

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

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

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

uv add crewai-tools

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

Note

لاستخدام التكاملات مع Agent(apps=[]), يجب تعيين متغير البيئة CREWAI_PLATFORM_INTEGRATION_TOKEN برمز المؤسسة الخاص بك.

export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"

أو أضفه إلى ملف .env:

CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token

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

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

zendesk/create_ticket

الوصف: إنشاء تذكرة دعم جديدة في 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/update_ticket

الوصف: تحديث تذكرة دعم موجودة في Zendesk.

المعاملات:

• ticketId (string, مطلوب): معرّف التذكرة المراد تحديثها
• requesterName (string, مطلوب): اسم المستخدم الذي طلب هذه التذكرة
• requesterEmail (string, مطلوب): بريد المستخدم الذي طلب هذه التذكرة
• ticketSubject (string, اختياري): موضوع التذكرة المحدّث
• ticketPriority (string, اختياري): الأولوية المحدّثة
• ticketStatus (string, اختياري): الحالة المحدّثة

zendesk/get_ticket_by_id

الوصف: استرجاع تذكرة محددة بواسطة معرّفها.

المعاملات:

• ticketId (string, مطلوب): معرّف التذكرة المراد استرجاعها

zendesk/add_comment_to_ticket

الوصف: إضافة تعليق أو ملاحظة داخلية إلى تذكرة موجودة.

المعاملات:

• ticketId (string, مطلوب): معرّف التذكرة لإضافة التعليق إليها
• commentBody (string, مطلوب): رسالة التعليق
• isInternalNote (boolean, اختياري): عيّن إلى true للملاحظات الداخلية بدلاً من الردود العامة

zendesk/search_tickets

الوصف: البحث عن التذاكر باستخدام فلاتر ومعايير مختلفة.

المعاملات:

• ticketSubject (string, اختياري): تصفية حسب النص في موضوع التذكرة
• ticketStatus (string, اختياري): تصفية حسب الحالة
• ticketPriority (string, اختياري): تصفية حسب الأولوية
• sort_by (string, اختياري): حقل الفرز - الخيارات: created_at, updated_at, priority, status
• sort_order (string, اختياري): اتجاه الفرز - الخيارات: asc, desc

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

zendesk/create_user

الوصف: إنشاء مستخدم جديد في Zendesk.

المعاملات:

• name (string, مطلوب): الاسم الكامل للمستخدم
• email (string, اختياري): عنوان البريد الإلكتروني
• phone (string, اختياري): رقم الهاتف
• role (string, اختياري): دور المستخدم - الخيارات: admin, agent, end-user

zendesk/update_user

الوصف: تحديث معلومات مستخدم موجود.

المعاملات:

• userId (string, مطلوب): معرّف المستخدم المراد تحديثه
• name (string, اختياري): اسم المستخدم المحدّث
• email (string, اختياري): البريد الإلكتروني المحدّث
• role (string, اختياري): الدور المحدّث

zendesk/get_user_by_id

الوصف: استرجاع مستخدم محدد بواسطة معرّفه.

المعاملات:

• userId (string, مطلوب): معرّف المستخدم المراد استرجاعه

zendesk/search_users

الوصف: البحث عن المستخدمين باستخدام معايير مختلفة.

المعاملات:

• name (string, اختياري): تصفية حسب اسم المستخدم
• email (string, اختياري): تصفية حسب البريد الإلكتروني
• role (string, اختياري): تصفية حسب الدور

أدوات إدارية

zendesk/get_ticket_fields

الوصف: استرجاع جميع الحقول القياسية والمخصصة المتاحة للتذاكر.

المعاملات:

• paginationParameters (object, اختياري): إعدادات الترقيم

zendesk/get_ticket_audits

الوصف: الحصول على سجلات التدقيق (السجل للقراءة فقط) للتذاكر.

المعاملات:

• 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()