أدلة Evnao
إعداد المنتج والوصول إلى API وحل المشكلات.
المفاهيم الأساسية
تُحفظ محادثات الموقع والقنوات الاجتماعية والبريد كتذاكر داخل مساحة عملك، مع الرسائل والمصدر والحالة والأولوية والمسؤول ووضع الرد.
حالة التذكرة ووضع الرد شيئان منفصلان. حلّ التذكرة أو إغلاقها يغلق وضع الرد فيها. أعد فتحها قبل تغيير من يرد.
يمكن للمساعد الرد بالاعتماد على المعرفة المعتمدة وإجراءات القراءة المفعّلة، وفق شروط الرد وحدود الخطة.
تتوقف الردود الآلية أثناء تولّي شخص للمحادثة. اختيار وضع الفريق وحده لا يُسند المحادثة إلى عضو محدد.
تُحفظ الرسائل، لكن لا يُنشأ رد آلي.
انتهت المحادثة. يمكن لأداة الموقع عرض خيار التقييم للزائر بعد حلّها.
تتيح خطتا Starter وPro للزوار والفريق إرفاق الصور والمستندات والفيديو والصوت من الأنواع المسموح بها. حد PDF هو 100 MB وحد الأنواع الأخرى 10 MB. محادثات Free نصية فقط.
تُرفع الملفات إلى تخزين خاص بتصريح رفع مدته 15 دقيقة. لا تصبح متاحة حتى تجتاز فحوص النوع والبنية والحجم ويؤكد فحص البرمجيات الضارة سلامتها. إذا تعذّر إكمال الفحص، يبقى الملف غير متاح؛ اختره مجدداً لإعادة المحاولة.
تنتهي صلاحية مرفقات Starter بعد 30 يوماً ومرفقات Pro بعد 60 يوماً من حلّ المحادثة. يستطيع المالك تصدير الملفات الأصلية المتبقية من إعدادات الخصوصية قبل حذفها. الصوت والفيديو للمراجعة البشرية فقط؛ لا توفر Evnao هنا تفريغاً صوتياً أو تحليلاً للفيديو.
يتطلب الوصول إلى API خطة Pro نشطة. استبدل معرّف التذكرة والمفتاح في المثال بقيمك على الخادم؛ لا تضع مفتاح API في كود المتصفح.
GET /api/v1/tickets يعرض حتى 100 تذكرة في الصفحة، مع مؤشر للصفحة التالية ومرشّحَي status وsource اختياريين. يتطلب صلاحية tickets:read.
GET /api/v1/tickets/:ticketId يعرض تذكرة واحدة وأحدث 100 رسالة غير داخلية، مرتبة من الأقدم إلى الأحدث ضمن هذه المجموعة. يتطلب صلاحية tickets:read.
PATCH /api/v1/tickets/:ticketId يغيّر الحالة أو الأولوية أو وضع الرد، ويتطلب tickets:write وترويسة Idempotency-Key. أعد فتح التذكرة قبل تغيير وضع الرد إذا كانت محلولة أو مغلقة.
curl -X PATCH https://evnao.com/api/v1/tickets/TICKET_ID \
-H "Authorization: Bearer evnao_live_YOUR_KEY" \
-H "Idempotency-Key: ticket-update-123" \
-H "Content-Type: application/json" \
-d '{"status":"RESOLVED"}'