الأشخاص

نشرح في هذا القسم كافة الإمكانات التي تتيحها الواجهة البرمجية لزيتون لإدارة الأشخاص أو جهات الاتصال المسجلين في المركز من استعلام وإضافة وتعديل ودمج وحذف

عرض الأشخاص المسجلين

نشرح في هذا المقال طريقة الحصول على كافة الأشخاص أو جهات الاتصال في مركز المساعدة من خلال الواجهة البرمجية لزيتون، ونطبق الشرح على مركز مساعدة تجريبي يدعى "المناسب al-munasib" له النطاق الفرعي al-munasib.zaetoon.com . عرض الأشخاص المسجلين يمكنك الحصول على قائمة بجهات الاتصال وتحديدًا الأشخاص المسجلة بياناتهم في مركز المساعدة بإرسال طلب من نوع GET إلى نقطة الاتصال contacts/ مع العديد من خيارات الف...

عرض البيانات التفصيلية لشخص

سنشرح في هذا المقال كيفية استرجاع البيانات التفصيلية لشخص معين contact في مركز المساعدة من خلال الواجهة البرمجية لزيتون ونطبق مثال على مركز مساعدة تجريبي يدعى "المناسب" له النطاق الفرعي al-munasib.zaetoon.com . استرجاع البيانات التفصيلية لشخص يمكنك عرض الإعدادات التفصيلية لشخص معين في مركز المساعدة عبر تمرير رقمه التعريفي id كمتغير مسار Path Parameter ضمن عنوان URL للطلب GET الموجه إلى نقطة الاتص...

إضافة شخص جديد

سنشرح في هذا المقال كيفية إضافة شخص جديد إلى مركز المساعدة عبر استخدام واجهة برمجة تطبيقات زيتون ونطبق الشرح عمليًا على مركز مساعدة تجريبي يدعى "المناسب" له النطاق الفرعي al-munasib.zaetoon.com . إضافة شخص جديد تساعدك نقطة الاتصال contacts/ على إضافة شخص جديد إلى جهات اتصال مركز المساعدة، وفق التالي: عنوان URL لنقطة الاتصال : https://{your_subdomain}/api/agent/v1/contacts . نوع الطلب : POST. جسم...

التعديل المتعدد للأشخاص

سنشرح في هذا المقال كيفية تنفيذ تعديلات متعددة على إعدادات مجموعة من الأشخاص في مركز المساعدة دفعة واحدة باستخدام واجهة برمجة تطبيقات زيتون ونطبق أمثلة عملية على أشخاص مسجلين في مركز مساعدة تجريبي يدعى "المناسب al-munasib" له النطاق الفرعي al-munasib.zaetoon.com . التعديل المتعدد للأشخاص يمكنك تعديل إعدادات مجموعة أشخاص معًا بطلب POST واحد بمساعدة نقطة الاتصال contacts/ التي تسمح لك بتعديل الإعدا...

تعديل إعدادات شخص

سنوضح في هذا المقال كيفية تعديل إعدادات شخص معين في مركز المساعدة باستخدام الواجهة البرمجية لزيتون ونوضح بالأمثلة العملية طريقة القيام بذلك ضمن مركز تجريبي يدعى "المناسب" له النطاق الفرعي al-munasib.zaetoon.com . طرق تعديل إعدادات شخص توجد نقطتا نقاط اتصال endpoints لتعديل إعدادات الأشخاص في مركز المساعدة: أولًا: نقطة الاتصال {contacts/{id/ تساعدك نقطة الاتصال {contacts/{id/ على تعديل الإعدادات ا...

إدارة عناوين البريد الإلكتروني للأشخاص

تُعدّ عناوين البريد الإلكتروني من أهم البيانات التي ينبغي لك تسجيلها عن عملائك، وتوفر مراكز مساعدة زيتون خيارات مرنة في إضافتها وحذفها. إضافة عنوان بريد إلكتروني جديد يمكنك إضافة عنوان بريد إلكتروني عناوين الشخص بإرسال طلب POST إلى نقطة الاتصال contacts/{contact_id}/emails/ مع تمرير الرقم التعريفي للشخص contact_id كمتغير مسار ضمن عنوان URL للطلب، وتمرير عنوان البريد الإلكتروني المُراد إضافته emai...

إدارة وسوم الأشخاص

تساعدك الوسوم على تميز الأشخاص في مركز المساعدة تبعًا لمعايير محددة وتُسَهِّل عليك فرزهم والتعامل معهم، وفي مقال اليوم نشرح طريقة إدارة الوسوم من خلال الواجهة البرمجية لزيتون ونعرض أمثلة على إضافة وسوم جديدة أو حذف وسوم موجودة لتمييز العملاء أو تصنيفهم ضمن مركز مساعدة تجريبي يدعى "المناسب" له النطاق الفرعي al-munasib.zaetoon.com . إضافة وسم إلى أحد الأشخاص أرسل طلب من نوع POST إلى نقطة الاتصال co...

إدارة أرقام هواتف الأشخاص

يمكنك إضافة أرقام الجوّال إلى إعدادات الأشخاص في مركز مساعدة زيتون وحذفها منها بسهولة بواسطة عدة نقاط اتصال في واجهة زيتون البرمجية، كما سنشرح تاليًا من خلال الأمثلة العملية على مركز مساعدة تجريبي يدعى "المناسب al-munasib" له النطاق الفرعي al-munasib.zaetoon.com . إضافة رقم جوال إلى إعدادات الشخص يمكنك إضافة رقم جوال جديد إلى إعدادات شخص معين في مركز المساعدة بإرسال طلب POST إلى نقطة الاتصال cont...

إدارة الملاحظات حول الأشخاص

تُسَهِّل الملاحظات تعاملك مع جهات الاتصال في مركز المساعدة، نوضح في الفقرات والأمثلة التالسة كيفية إضافة الملاحظات إلى الأشخاص واسترجاعها وتعديها وحذفها. عرض كافة الملاحظات حول شخص يمكنك عرض قائمة بالملاحظات المكتوبة عن شخص معين باستخدام نقطة الاتصال contacts/{contact_id}/notes/ وفق التالي: عنوان URL لنقطة الاتصال: https://{your_subdomain}/api/agent/v1/contacts/{contact_id}/notes. نوع الطلب : GET...

إدارة فئات الأشخاص

تساعدك فئات جهات الاتصال على تصنيف الأشخاص في مركز المساعدة ضمن فئات معينة تبعًا لأهميتهم أو طبيعة تعاملاتهم مع المركز، ويوفر مركز مساعدة زيتون فئتين معرفتين افتراضيًّا هما: فئة العملاء فئة العملاء المحتملين ويمكنك إنشاء فئات جديدة بسهولة إذا رغبت بذلك باستخدام نقطة الاتصال segments/ . إضافة الشخص إلى فئة معينة أرسل طلب POST إلى نقطة الاتصال contacts/{contact_id}/segments/ لإضافة الشخص ذو الرقم ا...

إضافة حقول جديدة لتعريف الأشخاص

قد تحتاج إلى توسيع إعدادات تعريف الأشخاص في مركز المساعدة وإضافة حقول جديدة لتخزين معلومات إضافية عنهم، وهو ما سنشرحه في هذا المقال من خلال الواجهة البرمجية لزيتون. إضافة حقول جديدة للأشخاص تساعدك نقطة الاتصال contacts/{contact_id}/fields/ على إضافة حقول جديدة إلى إعدادات تعريف الأشخاص في مركز المساعدة مثل روابط مواقع الويب URLs، وهي نوعية الحقول المتاحة حاليًّا. عنوان URL لنقطة الاتصال : https:/...

دمج الأشخاص

توفر لك واجهة زيتون البرمجية إمكانية دمج الأشخاص المكررين في مركز المساعدة ضمن شخص واحد مع الحفاظ على بياناتهم قبل الدمج مثل: الوسوم، وأرقام الجوال، وعناوين البريد الإلكتروني، والروابط وغيرها. دمج الأشخاص يمكنك دمج بيانات عدة أشخاص في بيانات شخص واحد، وذلك باستخدام نقطة الاتصال contacts/{contact_id}/merge/ وفق التالي: عنوان URL لنقطة الاتصال : https://{your_subdomain}/api/agent/v1/contacts/{conta...

حذف الأشخاص واستعادتهم

في بعض الأحيان، قد تحتاج إلى حذف أحد الأشخاص المحفوظين في مركز المساعدة لأسباب مختلفة، مثل تحديث البيانات أو التخلص من سجلات غير ضرورية وهو ما سنشرحه في هذا المقال من خلال مثال عملي على مساعدة تجريبي يدعى "المناسب" له النطاق الفرعي al-munasib.zaetoon.com . حذف شخص إذا احتجت لحذف أحد الأشخاص المحفوظين في مركز المساعدة، فيمكنك إرسال طلب من نوع DELETE إلى نقطة الاتصال {contacts/{id/ وتمرير الرقم الت...

أرشفة الأشخاص واستعادتهم

تتيح لك عملية أرشفة الأشخاص إخفاءهم من مركز المساعدة دون حذفهم نهائيًا ويمكنك استعادة الأشخاص المؤرشفين بسهولة في أي وقت عند الحاجة وهو ما سنشرحه في هذا المقال من خلال تطبيق مثال عملي على مركز مساعدة تجريبي يدعى "المناسب" له النطاق الفرعي al-munasib.zaetoon.com . أرشفة شخص تساعدك نقطة الاتصال contacts/{contact_id}/archive/ على أرشفة شخص معين في مركز المساعدة عبر تمرير رقمه التعريفي contact_id ضمن...

عرض سجل نشاطات الشخص

تتيح لك الواجهة البرمجية لزيتون عرض سجل نشاطات أي شخص (جهة اتصال) في مركز المساعدة كما سنشرح في هذا المقال مع أمثلة عملية لمركز مساعدة تجريبي يدعى "المناسب" له النطاق الفرعي al-munasib.zaetoon.com . عرض سجل نشاطات الشخص يمكنك عرض سجل نشاطات أي شخص (جهة اتصال) في مركز المساعدة باستخدام نقطة الاتصال contacts/{contact_id}/activities/ ويشمل ذلك: رسائله إلى مركز المساعدة، والتقييمات التي منحها لمحادثا...

عرض سجل تغييرات إعدادات شخص

سنتعرف في هذه المقالة على طريقة لاستعراض سجل التغييرات التي نَفَّذها موظفو مركز المساعدة على إعدادات شخص معين، بدايةً من إضافته إلى جهات اتصال المركز، وضبط إعدادته المختلفة وتعديلها، ووصولًا إلى الحذف والأرشفة والدمج وغيرها بالإضافة إلى عمليات تسجيل دخوله إلى المركز. عرض سجل التغييرات على إعدادت شخص يمكنك التحكم بخيارات عرض سجل التغييرات تبعًا لتاريخ الحدث أو نوعه وفق التالي: عنوان URL: https://a...

تسجيل الدخول التلقائي لشخص

سنشرح في هذا المقال طريقة تسجيل الدخول التلقائي لشخص، فعندما يفتح الشخص صفحة مركز المساعدة يُطلب منه إدخال معلوماته الشخصية كالاسم وعنوان البريد الإلكتروني، ويمكن بعدها تسجيل دخوله تلقائيًا إلى مركز المساعدة دون إنشاء حساب ووضع كلمة مرور وتستطيع توجيهه إلى الصفحة الرئيسية للمركز أو صفحة الدردشة المباشرة. طلب تسجيل الدخول التلقائي يمكن تسجيل الدخول التلقائي لشخص في مركز المساعدة بإرسال طلب POST لن...