مقدمة

تتيح لك Chakra الاستماع إلى أي نوع من التغييرات في النظام وقراءة بياناتها. وتُعد Webhooks الآلية الأساسية لذلك. ولكن قبل التعمق في Webhooks، إليك ملاحظة موجزة حول نموذج البيانات نفسه.

نموذج البيانات

بحسب الحل الذي تستخدمه، قد تتعامل مع كائنات سجلات شائعة مثل العملاء، وكائنات عمليات مثل العملاء المحتملين والتذاكر، أو قد تستخدم كائنات مخصصة صُممت خصيصًا لحلك.

فيما يلي الأنواع الرئيسية للبيانات في نظام Chakra:

1. السجل
2. العملية
3. المهمة

العلاقة

السجل هو الكائن الأكثر دقة الذي يمكنك إنشاؤه. ولا يحتوي على معلومات عن الحالة.

يجب تمثيل الكائنات التي تحتاج إلى معلومات عن الحالة كعمليات. تبدأ العملية وتُنفَّذ على سجل، ثم تُستكمل على سجل. وتتضمن العملية حقلًا للحالة لالتقاط تفاصيل الحالة، بالإضافة إلى حالة عامة يمكن أن تكون OPEN/COMPLETED/CANCELLED

وأخيرًا، تسجل المهام تفاعلات المستخدم التفصيلية المرتبطة بعملية أو سجل أو بكليهما.

المخطط الأساسي:

classDiagram  Process --> Record  Task --> Process  Task --> Record  Process: +json data  Process: +String status  Process: +State state  class Task{    +json data    +String status  }  class Record{    +json data  }

مثال على التنفيذ:

classDiagram  Lead --> Customer  Call --> Lead  Call --> Customer  Lead: +json data  Lead: +String status  Lead: +State state  class Call{    +json data    +String status  }  class Customer{    +json data  }

data

يمكن لكل كائن من كائنات البيانات تخزين البيانات على هيئة أزواج من معرّفات السمات وقيمها، كما يلي

{  "applicant_name": "Harish Test 674",  "lead_id": "EXT-TEST-674",  "utm_source": "google",  "weight": "146",  "existing_customer": true,  "google_coordinates": [    12.323333,    27.188833  ],  "phone_number": "4400000091",  "source_lead_id": "87",  "otp_verified": "true",  "city": 1,  "loan_type": "fresh",  "pincode": "561892",  "loan_amount": 100000,  "customer_id": "dWWWdU-00000969",  "loan_start_time": "16 December,2019 11:00 AM"}

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

يمكنك العثور على مزيد من المعلومات في قسم نموذج البيانات

خطافات الويب الصادرة

أسهل طريقة لتمرير البيانات من Chakra إلى نظامك هي عبر خطافات الويب الصادرة. ويمكن إعداد خطافات الويب لأحداث دورة حياة الكائنات الموضحة أعلاه. يمكنك إرسال جميع الأحداث إلى API الخاص بك، أو إرسال الأحداث التي تستوفي شروطًا محددة.

graph LRA0(Chakra) -->AA[event] -->D[External Api 1]A -->C[Lifecycle Rule 2]C --> E[External Api 2]D-->F1(Your System)E-->F1

الحدث

فيما يلي الأحداث المتاحة لخطافات الويب

1. العملية
2. process:create
3. process:update
4. process:state-change
5. المهمة
6. task:create
7. task:update
8. السجل
9. record:create
10. Record:update

قاعدة دورة الحياة

تتيح لك قواعد دورة الحياة الاستماع إلى أحداث محددة تقع في النظام. فعلى سبيل المثال، بدلًا من الاستماع إلى جميع تحديثات العملاء المحتملين، يمكنك الاستماع فقط إلى العملاء المحتملين الذين يجري تحويلهم.

سيكون شرط القاعدة في هذه الحالة state: CONVERTED

قواعد دورة الحياة هي محرك القواعد القياسي لجميع عمليات الأتمتة على المنصة.

واجهة API خارجية

كما يوحي الاسم، هذه واجهات API خارجية يمكنك إعدادها في نظام Chakra. ويمكن ربطها بإجراء خطاف ويب في قاعدة دورة الحياة. وهذا ما يتيح للبيانات الوصول إلى أنظمتك في نهاية المطاف. عليك تحديد ما يلي لواجهة API خارجية:

1. المضيف
2. المسار
3. الرؤوس (بما فيها رؤوس التفويض)
4. المتن (في حالة خطافات الويب الصادرة، سيكون كائن الحدث بأكمله)