ملخص
يقدم هذا المقال أنواع الأحداث المختلفة المتاحة لإجراءات واجهة برمجة التطبيقات (REST API) في Wati. سوف تتعلم متى يتم تشغيل كل حدث وما هي البيانات التي يمكن إرسالها وكيفية استخدامها بشكل صحيح - خاصة عند جمع opinons أو بيانات أو معلومات حول العملاء.
الإرشادات
تتحرك إجراءات واجهة برمجة التطبيقات (REST API) القائمة على الأحداث تلقائيًا عند حدوث حدث معين في محادثة. يتسم كل نوع من أنواع الأحداث بسلوك مختلف، خاصةً فيما يتعلق بالبيانات (المعاملات) التي يمكن إرسالها.
فهم هذه الفروق يساعدك على اختيار الحدث الصحيح وتجنب مشاكل التكوين.
1. أحداث الإبهام向上 / إبهام向ลง
متى يتم تشغيله
يتم تشغيل هذا الحدث عندما ي点击 المستخدم زر الرد ( أو ) في واجهة الدردشة.
سلوك المعاملات
يدعم فقط معاملات ثابتة (محددة)
لا يمكن نقل بيانات المستخدمين الديناميكية
هذا يعني أن جميع القيم في طلب واجهة برمجة التطبيقات يجب أن تكون محددة مسبقًا.
الأحوال الشائعة
تتبع معايير رضا العملاء
إرسال إشعارات Slack عند استلام ردود سلبية
تسجيل أحداث الملاحظات على منصة تحليلات
️ مهم: لا يمكن لأحداث الإبهام向上 وإبهام向ลง إرسال معلومات المستخدمين الديناميكية مثل عناوين البريد الإلكتروني أو الأسماء أو محتوى المحادثة بنفسها.
دمج أحداث الإبهام向上 / إبهام向ลง مع نموذج الرد
إذا كنت بحاجة إلى ملاحظات مفصلة أو معلومات عن المستخدم، يمكنك دمج هذا الحدث مع حدث إرسال النموذج.
كيفية العمل
إنشاء نموذج ملاحظات مخصص
عندما ي点击 المستخدم أو ، يظهر نموذج الرد تلقائيًا
يملأ المستخدم النموذج (على سبيل المثال، سبب الرد أو البريد الإلكتروني)
يمكن تشغيل كلا الحدثين في نفس الوقت:
حدث الإبهام向上 / إبهام向ลง → يرسل بيانات ثابتة
حدث إرسال النموذج → يرسل بيانات النموذج الديناميكية
سيناريو المثال
نصيحة: لجمع البريد الإلكتروني أو الأسباب أو التعليقات، استخدم دائمًا نموذجًا مخصصًا و创建 действие واجهة برمجة التطبيقات (REST API) منفصلًا لحدث إرسال النموذج.
2. حدث إرسال النموذج
متى يتم تشغيله
يتم تشغيل هذا الحدث عندما يكمل المستخدم ويرسل نموذجًا مخصصًا في واجهة الدردشة.
سلوك المعاملات
يدعم معاملات ديناميكية من حقول النموذج
يجب أن يتطابق أسماء حقول النموذج تمامًا مع المحلول المستخدم في تكوين واجهة برمجة التطبيقات (REST API)
كيفية الضبط
الخطوة 1: إنشاء نموذج مخصص
أنشئ نموذجًا مخصصًا بأسماء حقول محددة بوضوح.
على سبيل المثال:
اسم حقل النموذج | نوع الحقل | الوصف |
| البريد الإلكتروني | عنوان البريد الإلكتروني للمستخدم |
| النص | اسم المستخدم الأول |
| النص | اسم الشركة |
| النص | رسالة المستخدم |
الخطوة 2: تكوين действие واجهة برمجة التطبيقات (REST API)
استخدم محلولًا في طلب واجهة برمجة التطبيقات (REST API) حيث يتطابق اللاحقة مع اسم حقل النموذج.
يمكن أن يتضمن المحلول بادئات مثل اتصال. أو وكيل. أو فعل.، ولكن يتطابق فقط بناءً على اللاحقة (الجزء بعد النقطة الأخيرة).
أمثلة:
حقل النموذج
البريد الإلكتروني→{{البريد الإلكتروني}}أو{{اتصال.البريد الإلكتروني}}حقل النموذج
الاسم الأول→{{الاسم الأول}}أو{{اتصال.الاسم الأول}}حقل النموذج
الشركة→{{الشركة}}أو{{اتصال.الشركة}}
قواعد تطابق المعاملات
حقل النموذج | المحلو | التطابق | السبب |
|
| نعم | تطابق مباشر |
|
| نعم | اللاحقة |
|
| نعم | اللاحقة |
|
| نعم | اللاحقة |
|
| لا | تطابق لاحقة غير متطابق (حساس للحالة) |
|
| لا | تطابق لاحقة غير متطابق ( |
️ مهم: يجب أن تتطابق لاحقة المحلول تمامًا مع اسم حقل النموذج، بما في ذلك الحالة. البادئة لا تؤثر على التطابق.
مثال تدفق
3. حدث أخذ الرصيد
متى يتم تشغيله
يتم تشغيل هذا الحدث تلقائيًا بعد 10 دقائق من انتهاء المحادثة، إذا قام وكيل الذكاء الاصطناعي بجمع معلومات الرصيد خلال الدردشة.
سلوك المعاملات
يستخدم هيكل طلب ثابت
لا يمكن تعديل أو تخصيص الحقول المرسلة
هيكل الطلب الثابت
عندما يتم تشغيل هذا الحدث، يرسل Wati تلقائيًا الحمولة التالية:
{
"معرف_الوكيل": "معرف_الوكيل",
"بيانات": {
"معرف_المحادثة": "معرف_المحادثة",
"تفاصيل": "تفاصيل الرصيد",
"البريد الإلكتروني": "[email protected]",
"الاسم الأول": "John",
"الاسم الأخير": "Doe",
"مستوى الرصيد": "ساخن",
"درجة الرصيد": 100,
"ملخص الرصيد": "ملخص الرصيد",
"الدرجة القصوى": 100
},
"الحدث": "رصيد_مأخوذ"
}وصف الحقول
الحقل | الوصف |
| معرف وكيل الذكاء الاصطناعي |
| معرف المحادثة الفريد |
| معلومات الرصيد المجمعة |
| البريد الإلكتروني للمستخدم (إذا كان متاحًا) |
| اسم المستخدم الأول |
| اسم المستخدم الأخير |
| جودة الرصيد (ساخن، دافئ، بارد) |
| درجة الرصيد العددية |
| ملخص الرصيد الذي تم إنشاه بواسطة الذكاء الاصطناعي |
| الدرجة القصوى الممكنة |
ملاحظة: لا تحتاج إلى تعريف جسم_الطلب لأحداث رصيد مأخوذ. سيتم تجاهل أي تكوين جسم طلب مخصص.
الأحوال الشائعة
إنشاء رصيد تلقائيًا في Salesforce أو HubSpot
إرسال بيانات الرصيد إلى أدوات التautomatization التسويقية
تشغيل سير عمل متابعة في نظام إدارة علاقات العملاء
مرجع سريع: مقارنة نوع الحدث
الميزة | إبهام向上 / إبهام向ลง | إرسال النموذج | رصيد مأخوذ |
المعاملات الديناميكية | لا | نعم | هيكل ثابت |
جسم الطلب المخصص | نعم (ثابت فقط) | نعم | لا |
يتطلب إعداد نموذج | لا | نعم | لا |
توقيت التنشيط | فوري | فوري | 10 دقائق بعد انتهاء الدردشة |
تتطلب إجراء المستخدم | نقر على الرد | إرسال النموذج | لا شيء (تلقائي) |
اختيار نوع الحدث الصحيح
استخدم إبهام向上 / إبهام向ลง لتتبع ملاحظات بسيطة
استخدم إرسال النموذج عند الحاجة إلى إدخال ديناميكي للمستخدم
استخدم رصيد مأخوذ لتسليم الرصيد التلقائي بعد المحادثات
اختيار الحدث الصحيح يضمن تشغيل إجراءات واجهة برمجة التطبيقات (REST API) بشكل موثوق و إرسال البيانات المتوقعة.