ملخص

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

كيف يعمل هذا الإجراء

عند تشغيل هذا الإجراء:

تبحث Astra عن شخص (Person) في Pipedrive باستخدام البريد الإلكتروني للعميل.
إذا تم العثور عليه، فإنه يتحقق من وجود عميل متوقع (Lead) مرتبط.
بناءً على إعداداتك، سيتم:
- إنشاء شخص أو عميل متوقع جديد (إذا لم يكن موجودًا)، أو
- تحديث عميل متوقع موجود بأحدث المعلومات.

تعليمات

اتبع هذه الخطوات لتكوين الإجراء:

الخطوة 1: افتح قالب Pipedrive لإنشاء/تحديث جهة الاتصال

سجل الدخول إلى حسابك في Astra.
انتقل إلى مكتبة الإجراءات (Action Library).
حدد إجراء Pipedrive - إنشاء جهة اتصال أو تحديثها.
افتح خطوة التكوين (Configuration).

الخطوة 2: قم بإعداد هدف الإجراء

ماذا تفعل:
- أدخل اسم الإجراء (action name) والهدف (intent) بوضوح.
- انقر فوق تعديل هدف الإجراء (Edit action intent) في أي وقت لتحديثه.

ماذا يحدث:
- يساعد الهدف المحدد جيدًا الوكيل على فهم متى يتم تشغيل هذا الإجراء.

المزامنة دون اتصال (Offline Sync):
- حافظ على هذا الخيار إيقاف (OFF) لتشغيل الإجراء أثناء المحادثة.
- قم بتشغيله تشغيل (ON) إذا كنت تريد تشغيل الإجراء بعد انتهاء المحادثة.

الخطوة 3: حدد حساب Pipedrive الخاص بك

ماذا تفعل:
- اختر حسابًا موجودًا أو انقر فوق إضافة حساب (Add account) لتوصيل حساب جديد.

ماذا يحدث:
- سيتم حفظ جميع البيانات التي تم إنشاؤها أو تحديثها بواسطة هذا الإجراء في الحساب المحدد.

الخطوة 4: تكوين إنشاء جهات الاتصال وتحديثها

السماح بإنشاء جهات اتصال جديدة وتحديثها

عند التشغيل (ON):
- يتم إنشاء شخص جديد إذا لم يكن موجودًا.
- يتم إنشاء عميل متوقع جديد إذا لم يكن هناك أي عميل متوقع موجود.
- تحديث كامل للعملاء المتوقعين الذين تم إنشاؤهم من خلال Astra.

عند الإيقاف (OFF):
- لا يتم إنشاء أشخاص أو عملاء متوقعين جدد.

السماح بتحديث الحقول الموجودة

عند التشغيل (ON):
- يتم تحديث الحقول المعينة للعملاء المتوقعين الموجودين بالفعل في Pipedrive، حتى إذا لم يتم إنشاؤها بواسطة Astra.

عند الإيقاف (OFF):
- لا يتم تعديل حقول العميل المتوقع الموجودة.
- يتم تحديث حقل الملخص (summary) فقط (إذا تم تكوينه).

الخطوة 5: تعيين الحقول (Pipedrive → Astra)

يحدد تعيين الحقول كيفية تدفق البيانات من Astra إلى Pipedrive.

ماذا تفعل:
- لكل صف:
  - حدد حقل Pipedrive (الجانب الأيسر).
  - طابقه مع حقل Astra (الجانب الأيمن).

ماذا يحدث:
- عند تشغيل الإجراء، ترسل Astra البيانات المعينة إلى حقول العميل المتوقع المقابلة في Pipedrive.

الحقول المطلوبة

يجب عليك تعيين:
- البريد الإلكتروني (Email)
- الاسم الأخير (Last name)

لن يتم تشغيل الإجراء بدون هذه الحقول.

إضافة المزيد من الحقول

انقر فوق تعيين حقل (Map field) لإضافة المزيد من عمليات التعيين.
يمكنك تعيين:
- الحقول القياسية (البريد الإلكتروني، الهاتف، إلخ.)
- حقول مخصصة من Pipedrive

ملاحظة: يتم دعم الحقول المخصصة من النوع النصي (text-type custom fields) فقط ضمن عميل متوقع/صفقة (Lead/Deal).

إنشاء حقول Astra جديدة

يمكنك إنشاء حقول Astra جديدة أثناء التعيين.
ستكون هذه الحقول:
- متاحة في تكوين الوكيل
- تظهر كسمات لجهات الاتصال للاختيار

استخدام حقل الملخص

إذا قمت بتعيين حقل Pipedrive إلى ملخص (Summary):
- ستكتب Astra ملخصًا للمحادثة في هذا الحقل.
- ستتم أيضًا إضافة ملاحظة ذات صلة إلى العميل المتوقع.

كيف يبدو السلوك الشامل من البداية إلى النهاية

إليك ما يحدث عند تشغيل الإجراء:

تبحث Astra عن شخص (Person) باستخدام البريد الإلكتروني المعين.
تبحث عن عميل متوقع (Lead) مرتبط بهذا الشخص.
إذا لم تكن هناك بيانات موجودة:
- فإنه ينشئ سجلات فقط إذا سمحت بذلك إعداداتك.
إذا كان العميل المتوقع موجودًا:
- فإنه يحدث العميل المتوقع بناءً على إعدادات التبديل الخاصة بك.
- إذا كانت التحديثات الكاملة مقيدة، فقد تحدث تحديثات متعلقة بالملخص فقط.

ميزة إضافية: المزامنة دون اتصال

تتيح لك المزامنة دون اتصال تشغيل الإجراء بعد انتهاء المحادثة.

عند التمكين:
- يتم تشغيل الإجراء مرة واحدة بعد اكتمال المحادثة.
شروط انتهاء المحادثة:
- وكيل نصي: بعد 10 دقائق من آخر رسالة
- الوكيل الصوتي: عند انتهاء المكالمة