جدول المحتويات
تدفق الاتصالات: المعلمات
محدث بواسطة Susan Swier
يستخدم Respond.io معلمات تدفق الاتصال المخصصة لتعزيز وظائف التطبيق's لتلبية حالات الاستخدام المتعددة.
في تدفق الحوار، تستخدم المعلمات بشكل عام لربط الكلمات والعبارات في استجابة المستخدم للكيانات. إذا قال أحدهم "عيد ميلادي هو في 13 مارس," سيتم الكشف تلقائياً عن العبارة "مارس 13" ومعالجتها ككيان تاريخي. يمكنك قراءة المزيد عن المعلمات في تدفق الحوار على صفحة التوثيق الخاصة بهم.
مع المنصة المجيبة، يمكنك استخدام البارامترات لتغطية المزيد من حالات الاستخدام. يمكنك استخدامها لحفظ وجمع المعلومات المقدمة من جهات الاتصال الخاصة بك، على سبيل المثال بواسطة تعيين العلامات الديناميكية، إعداد الحقول المخصصة. يمكنك حتى إبلاغ ممثلي الدعم عندما يتطلب الاتصال المساعدة. يمكنك أيضًا استخدام منصة الاستجابة لتخزين و إدارة ردود النوايا الخاصة بك بسهولة.
هناك الكثير الذي يمكن تحقيقه عندما تستخدم منصة الإستجابة.io بالتزامن مع معلمات "نوايا التدفق".
مرجع المعلمة
قائمة المعلمات التي يمكنك استخدامها على Dialogflow للتواصل مع المنصة المجيبة.
اسم المعلمة | القيمة | الوصف |
| إضافة العلامات(ات) المحددة إلى ملف الاتصال على منصة الرد | |
| إزالة العلامات(ات) المحددة من ملف الاتصال على منصة الرد | |
| إيقاف تشغيل البوت لجهة الاتصال المحددة. هذا مفيد في الحالات التي تريد فيها تمرير المحادثة من بوت إلى إنسان. | |
| يفتح أو يغلق محادثة لجهة اتصال. وهذا أمر مفيد للدعم. يفتح محادثة لجهات الاتصال التي لا تزال تتوقع شيئا، مع إغلاق المحادثة يعني جهات الاتصال التي تمت رعايتها. | |
| يرسل إشعار إلى البشر على منصة الاستجابة ، مشفوعا برسالة إشعار | |
| يشترك في جهة اتصال أو يلغي اشتراكها. جهات الاتصال غير المشتركة لن تتلقى رسائل البث. | |
| ملء حقل الاسم الأول من ملف الاتصال بالقيمة المحددة | |
| ملء حقل الاسم الأخير من ملف الاتصال بالقيمة المحددة | |
| ملء حقل الاسم الكامل لملف الاتصال بالقيمة المحددة | |
| يملأ حقل عنوان البريد الإلكتروني لملف الاتصال بالقيمة المحددة | |
| ملء حقل رقم الهاتف من الملف الشخصي جهة الاتصال بالقيمة المحددة | |
| ملء حقل اللغة من ملف الاتصال بالقيمة المحددة، على سبيل المثال en-us | |
| يضيف حقل مخصص إلى ملف الاتصال's مع القيمة المحددة. ويستخدم هذا على أفضل وجه للحصول على معلومات غير دينامية، مثل البريد الإلكتروني وعيد الميلاد وما إلى ذلك. | |
| إزالة الحقول المخصصة المحددة من جهات الاتصال على المنصة | |
| تعيين جهة الاتصال إلى مستخدم واحد في فريقك | |
| يرسل كتلة الكود المحددة إلى جهة الاتصال | |
| يرسل الملف المحدد المخزن على المنصة إلى جهة الاتصال |
وضع العلامات
يمكن تخزين جهات الاتصال' المعلومات في شكل علامات. يمكن إضافة/إزالة العلامات يدوياً في وحدة جهات الاتصال أو وحدة الرسائل، تمت إضافة/إزالة برمجية باستخدام سير العمل، وإضافة/إزالة باستخدام معلمات في عناصر تدفق الحوار.
استخدام معلمات العلامات
إضافة العلامات
باستخدام معلمة RB_ADDTAGS
، يمكنك تعيين علامة لجهة اتصال. سيتم إضافة العلامات إلى جهة الاتصال استناداً إلى قيمة المعلمة . لديك الخيار لإضافة وسوم متعددة عن طريق فصلها بفواصل.
إزالة العلامات
باستخدام معلمة RB_REMOVETAGS
، يمكنك إزالة العلامة من جهة الاتصال. سيتم إضافة العلامات إلى جهة الاتصال استناداً إلى قيمة المعلمة . لديك خيار إزالة العلامات المتعددة عن طريق فصلها بفواصل.
أفضل الممارسات
عند إنشاء علامات جديدة، من الجيد تعريف أسماء قصيرة ولكن ذات مغزى يسهل التعرف عليها. من الناحية المثالية، تريد من الآخرين أن يكونوا قادرين على فهم العلامات المرتبطة بالمستخدم.
مع ملء الخانة باستخدام الكيانات، لديك خيار إنشاء علامات جديدة بشكل ديناميكي. غير أن ذلك لا ينصح به لأنه سيؤدي بسرعة إلى تلويث العلامات.
للحد من التلوث بالعلامات، حاول ألا تكون محددة جداً أو سخية جداً مع العلامة من أجل الحفاظ على عدد العلامات عند الحد الأدنى.
عند استخدام العلامات لتتبع موضوع المستخدم ، يمكنك استخدام نفس العلامة في عدة نوايا لها نفس الموضوع. وهذا يمكن أن يحدد أن لدى المستخدم اهتماما أو قلقا محددين في الوقت الذي يقلل فيه من التلوث بالعلامات العلمية.
إيقاف تشغيل بوت
يمكن تشغيل/إيقاف وكيل تدفق الاتصال يدوياً في وحدة الرسائل. وبالإضافة إلى ذلك، يمكن إيقاف تشغيل بوت باستخدام معلمات في نوايا التدفق.
يمكن استخدام استخدام "التدفق" لتشغيل جهة اتصال's Bot Status معطلة من أجل إنشاء منفذ بشري في سير عمل البوت الخاص بك.
عندما يتم تعطيل بوت لجهة اتصال، لا يتم إرسال أي رسائل إلى تدفق الحوار. ستظهر جهات الاتصال مع بوت معطل على المنصة تحت قسم غير معين في لوحة التحكم.
استخدام معلمة حالة بوت
مع RB_BOTSTATUS
، يمكنك إيقاف تشغيل البوت للمستخدم المحدد عن طريق تعيين القيمة إلى خاطئ
.
أفضل الممارسات
والقصد الارتداد لا يتضمن مكانا لإضافة معلمات. عند إيقاف تشغيل البوت من تدفق الحوار، يجب عليك إنشاء رد سريع في قصدك الخلفي بسؤال جهة الاتصال إذا كانوا يريدون التحدث مع إنسان. إذا كان الاتصال يستجيب لـ نعم الرد السريع، فيجب أن ينقلهم ذلك إلى النية مع معلمة RB_BOTSTATUS
.
عند استخدام هذه المعلمة لتعطيل البوت، قد ترغب أيضًا في تحديث حالة المستخدم على المنصة مع RB_MARKDONE
وإرسال إشعار على المنصة مع معلمة RB_NOTIFY
ضمن مقصد واحد.
إغلاق المحادثة
تعيين وإغلاق نظام المحادثة فتح محادثة جديدة لجميع جهات الاتصال الجديدة وجميع جهات الاتصال مع رسائل جديدة. هذا يضمن أن جميع جهات الاتصال التي تحتاج إلى مساعدة تظهر في القائمة غير المعينة.
يمكن فتح أو إغلاق محادثة لجهة اتصال يدوياً في وحدة جهات الاتصال أو وحدة الرسائل، تم فتحه أو إغلاقه برمجياً باستخدام سير العمل، وأغلق باستخدام معلمات في حركات التدفق.
لإغلاق محادثة جهة اتصال من Dialogflow، استخدم معلمة RB_MARKDONE
في دليل التدفق الخاص بك.
استخدام المعلمة المعلمة
لإغلاق محادثة مع جهة اتصال، استخدم معلمة RB_MARKDONE
في القصد من تدفق الاتصال وقم بتعيين القيمة إلى true
.
أي جهة اتصال تقوم بتفعيل نية باستخدام معلمة RB_MARKDONE
بقيمة true
سيتم إغلاق محادثتهم على الرد. o المنصة.
أفضل الممارسات
بشكل افتراضي، جميع جهات الاتصال الجديدة مع الرسائل الجديدة ستفتح محادثة جديدة. أنت'سوف تريد إضافة RB_MARKDONE
ك صحيح
للنوايا التي لا تتطلب عاملا بشريا عند تشغيلها.
قد ترغب في التفكير في استخدام هذا القصد بالترادف مع RB_NOTIFY
لتفعيل إشعار عند فتح محادثة لجهة اتصال. يمكن استخدام رسالة الإشعار لنقل المعلومات حول ما يجب عمله لجهة الاتصال المحددة.
تعيين
لتعيين جهة اتصال لمستخدم من Dialogflow، استخدم معلمة RB_USER_ASSIGN
في معامل التدفق الخاص بك.
استخدام معلمة التعيين
لتعيين جهة اتصال للمستخدم، استخدم معلمة RB_USER_ASSIGN
في القصد من تدفق الاتصال الخاص بك وتعيين القيمة كبريد إلكتروني لمستخدم المنصة الذي ترغب في تعيينه له.
يتم تعيين أي جهة اتصال تقوم بتفعيل نية باستخدام معلمة RB_USER_ASSIGN
مع بريد إلكتروني صالح للمستخدم بالقيمة لذلك المستخدم على الرد. o المنصة.
إرسال إشعارات مخصصة
بشكل افتراضي، نظام الإشعارات سوف يرسل الإشعارات إلى مستخدمي المنصة عندما يقوم جهة الاتصال بإرسال رسالة جديدة. يمكن إنشاء إشعارات إضافية وإرسالها إلى مستخدمي المنصة باستخدام معلمات في دفق الحوار.
لإرسال إشعار إلى مستخدمي المنصة استخدم معامل RB_NOTIFY
في Intent(ات) تدفق الحوار الخاص بك.
استخدام معلمة الإشعارات
يمكن إرسال إشعار إلى المنصة باستخدام RB_NOTIFY
كاسم المعلمة. سيتم إرسال قيمة المعلمة كإخطار.
أفضل الممارسات
استخدم المتغير الديناميكي $contactمن أجل تمكين مستخدم المنصة من معرفة أي جهة اتصال تحتاج إلى الاهتمام.
استخدم RB_NOTIFY
مع RB_BOTSTATUS
و RB_MARKDONE
لضمان حصول جهة الاتصال على الاهتمام الذي تحتاج إليه.
إلغاء الاشتراك
كل الآن ومن ثم سيكون لديك نص الاتصال الخاص بك "STOP". هذا على الأرجح لأنهم لم يعودوا يرغبون في استقبال البث. سيؤدي تعيين RB_SUBSCRIBE
كـ خاطئ
في Dialogflow إلى إلغاء اشتراك جهات الاتصال من جميع عمليات البث المستقبلية.
استخدام معلمة الاشتراك
مع RB_SUBSCRIBE
، يمكنك الاشتراك أو إلغاء اشتراك جهة اتصال للبوت عن طريق تعيين القيمة إلى true
أو false
على التوالي. جهات الاتصال غير المشتركة مستبعدة من نشرات المنصة المستقبلية.
أفضل الممارسات
إذا كنت تستخدم معلمة RB_SUBSCRIBE
لإدارة أذونات البث يجب عليك إنشاء حقل مخصص استجابة لذلك. o لعرض حالة اشتراك جهة اتصال'ثانية. يمكن القيام بذلك باستخدام RB_FIELD_[NAME]
مع RB_SUBSCRIBE
.
حقول الاتصال والقيم
جهات الاتصال' المعلومات يمكن تخزينها في شكل قيم في حقول جهات الاتصال.
بالإضافة إلى الحقول الافتراضية، الحقول المخصصة يمكن إضافتها & في وحدة الإعدادات. يمكن أيضا إنشاء حقول مخصصة جديدة من Dialogflow.
يمكن تغيير قيم حقل جهة الاتصال يدوياً في وحدة جهات الاتصال أو وحدة الرسائل، تم تغييرها برمجياً باستخدام سير العملأو تم تغييرها باستخدام معلمات في نوادي التدفق.
استخدام معلمات الحقل
اعداد قيم الحقل
يمكنك تعديل قيمة حقل الاتصال's المخصص مع RB_FIELD_[FIELD_ID]
حيث يتم استبدال "[FIELD_ID]" بمعرف الحقل المخصص. يتم إنشاء معرف الحقل المخصص كاسم للحقل المخصص في SNAKE_CASING. سيتم تعيين قيمة الحقل المخصص كقيمة في البارامترات. على سبيل المثال، إذا كنت تجمع أنواع الدم من جهات الاتصال و جهة الاتصال لديها نوع دم إيجابي AB، سوف ترسل المعلمة RB_FIELD_BLOODTYPE
مع قيمة AB+.
الحقول الافتراضية
يمكن القيام بنفس الشيء لأي من حقول الاتصال الافتراضية. على سبيل المثال، يمكن استخدام المعلمة RB_FIELD_PHONE
لتحديث قيمة رقم الهاتف الخاص بجهة الاتصال's.
بشكل افتراضي، جهات الاتصال على الاستبيان. تحتوي على حقول الاتصال التالية:
اسم الحقل | ID | الوصف |
الاسم الأول | المصادقة | الاسم الأول من جهة الاتصال |
اسم العائلة | لاستنمي | اسم العائلة لجهة الاتصال |
الاسم الكامل | FULLNAME | الاسم الكامل لجهة الاتصال، أي الاسم الأول + اسم العائلة |
عنوان البريد الإلكتروني | البريد الإلكتروني | عنوان البريد الإلكتروني الخاص بجهة الاتصال |
رقم الهاتف | مشاهدة | رقم الهاتف الخاص بجهة الاتصال |
اللغة | اللغة | لغة جهة الاتصال |
مسح الحقول
لمسح قيمة حقل لجهة اتصال، يمكنك استخدام المعلمة RB_REMOVEFIELDS
. ستكون القيمة هي أسماء الحقول التي تريد إزالتها. لديك خيار مسح العديد من الحقول مرة واحدة عن طريق فصلها بفواصل.
الردود السريعة
يستخدم نظام كتل الكود لتخزين محتوى الردود الشائعة الاستخدام على منصة الإستجابة.io.
يمكن إرسال كتل الكود يدويًا في وحدة الرسائل للحد من الكتابة أو إرسالها باستخدام معلمات في دفق الحوار.
بإرسال كتل الكود في وكيل تدفق الحوار الخاص بك، يمكنك تخزين محتوى ردود النوايا الخاصة بك على الرد. o منصة حيث يمكن إدارتها وتحريرها بسهولة.
يمكن أن تستخدم مقاطع متعددة نفس الكتلة أيضًا. في هذه الحالة، تحرير كتلة الكود سوف يقوم بتحديث محتوى الاستجابة عبر جميع النواتج.
لإرسال كتلة كتلة الكود باستخدام دفق الحوار، استخدم معلمة RB_SNIPPET
. النوايا المشغلة سوف تستجيب مع محتوى كتلة الكود.
استخدام معلمة كتلة الكود
مع RB_SNIPPET
، يمكنك إرسال كتلة كود. عيّن قيمة المعلمة إلى معرف كتلة الكود الذي ترغب في إرساله.
إرسال الملفات
يمكن إرسال الملفات يدوياً في وحدة الرسائل أو إرسالها باستخدام معلمات في دليل التدفق.
باستخدام معلمة RB_FILE
، يمكنك إرسال الملفات المخزنة في مدير الملفات إلى جهات الاتصال التي تشغل تدفق الحوار.
استخدام معلمة الملف
قبل أن تتمكن من إرسال ملف، يجب عليك تحميل الملف (الملفات) إلى المستجيب.io مدير الملفات. ثم استخدم معلمة RB_FILE
مع معرف الملف كقيمة لإرسال ملف إلى جهة الاتصال.