واجهة برمجة تطبيقات FlowHunt JS: تخصيص متقدم للشات بوت

اكتشف ميزات FlowHunt المتقدمة: خصص باستخدام متغيرات التدفق، وتتبع بلواحق الروابط، واستخدم معالجات الأحداث، وتحكم في تفعيل الدردشة لتجربة مستخدم مصممة خصيصًا.

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

متغيرات التدفق: خصص تجربة الدردشة

توفر متغيرات التدفق وسيلة لتمرير بيانات ديناميكية إلى الشات بوت ليصبح أكثر تخصيصًا. يمكنك تخزين أي شيء داخل هذه المتغيرات؛ فقد تكون بيانات مستخدم، أو بيانات جلسة، أو أي معلومات ذات صلة.

كيفية استخدام flowVariable

يعد flowVariable جزءًا من إعدادات FHChatbot.initChatbot(). إنه كائن حيث يحدد كل زوج مفتاح-قيمة متغيرًا وقيمته. مثال — تمرير عنوان IP الخاص بالمستخدم ومعرف المستخدم:

<script type="text/javascript" id="fh-chatbot-script-8f1fd880-8e9c-4cb1-a1f2-291c0329612b">
(function(d, src, c) { 
  var t=d.scripts[d.scripts.length - 1],s=d.createElement('script');
  s.async=true;s.src=src;s.onload=s.onreadystatechange=function(){
    var rs=this.readyState;
    if(rs&&(rs!='complete')&&(rs!='loaded')){return;}
    c(this);
  };
  t.parentElement.insertBefore(s,t.nextSibling);
})(document,
  'https://app.flowhunt.io/fh-chat-widget.js',
  function(e){ 
    FHChatbot.initChatbot({
      chatbotId: '8f1fd880-8e9c-4cb1-a1f2-291c0329612b',
      workspaceId: 'e31db667-893b-4e47-92c3-bb1f93c1b594',
      headerTitle: 'URLsLab FAQ Generator',
      maxWindowWidth: '700px',
      "flowVariable": {
        "ip": /* Code to obtain IP Address */ ,
        "userId":  /* Code to obtain User ID */
      }
    });
  }
);
</script>

ملاحظات هامة:

  • استبدل /* Code to obtain IP Address */ و /* Code to obtain User ID */ بمنطقك الفعلي لجلب هذه القيم من نظامك. غالبًا ما يتطلب ذلك الوصول إلى متغيرات الخادم، أو التخزين المحلي، أو الاعتماد على طرق مصادقة أخرى.
  • بمجرد تمريرها، تصبح هذه المتغيرات متاحة داخل منطق الشات بوت الخاص بك، مما يسمح بردود ديناميكية وتدفقات عمل مخصصة.
  • يمكن لمنطق الشات بوت قراءة هذه المتغيرات واستخدامها لتخصيص المحادثات وجعلها أكثر وعيًا بالسياق.

urlSuffix: تتبع وتحليل تفاعلات الشات بوت

يتيح لك معامل urlSuffix إضافة سلسلة استعلام إلى نهاية كل رابط يتم استدعاؤه بواسطة الشات بوت. هذا ضروري لتتبع مصدر وفعالية تفاعلات الشات بوت باستخدام أدوات التحليلات مثل Google Analytics.

كيفية استخدام urlSuffix

ببساطة، قم بتعيين خاصية urlSuffix إلى سلسلة الاستعلام التي تريدها، كما يلي:

<script type="text/javascript" id="fh-chatbot-script-8f1fd880-8e9c-4cb1-a1f2-291c0329612b">
(function(d, src, c) { 
  var t=d.scripts[d.scripts.length - 1],s=d.createElement('script');
  s.async=true;s.src=src;s.onload=s.onreadystatechange=function(){
    var rs=this.readyState;
    if(rs&&(rs!='complete')&&(rs!='loaded')){return;}
    c(this);
  };
  t.parentElement.insertBefore(s,t.nextSibling);
})(document,
  'https://app.flowhunt.io/fh-chat-widget.js',
  function(e){ 
    FHChatbot.initChatbot({
      chatbotId: '8f1fd880-8e9c-4cb1-a1f2-291c0329612b',
      workspaceId: 'e31db667-893b-4e47-92c3-bb1f93c1b594',
      headerTitle: 'URLsLab FAQ Generator',
      maxWindowWidth: '700px',
      "urlSUffix": "?utm_source=your-custom-source"
    });
  }
);
</script>

في هذا المثال، سيتم إضافة ?utm_source=your-custom-source إلى جميع الروابط التي يبدأها الشات بوت، مما يتيح لك تتبع حركة الشات بوت في منصة التحليلات الخاصة بك.

الفوائد

  • تتبع التحويلات: راقب أي من تفاعلات الشات بوت تؤدي إلى أكبر عدد من التحويلات على موقعك.
  • تحليل سلوك المستخدم: افهم كيف يتنقل المستخدمون في موقعك بعد التفاعل مع الشات بوت.
  • نسبة الحملات: قس مدى فعالية الحملات التي تشجع المستخدمين على التفاعل مع الشات بوت.

معالجات الأحداث: الاستجابة لإجراءات الشات بوت

يتيح لك Flowhunt إعداد معالجات أحداث تقوم بتشغيل وظائف مخصصة عند حدوث أحداث معينة في الشات بوت. تمنحك هذه المعالجات تحكمًا دقيقًا في تجربة المستخدم. من معالجات الأحداث الرئيسية:

  • onSessionCreated: يتم تشغيله عند بدء جلسة شات بوت جديدة (إعادة تشغيل الجلسة تُحتسب أيضًا!).
  • onWindowOpened: يتم تشغيله عند فتح نافذة الشات بوت.
  • onWindowClosed: يتم تشغيله عند إغلاق نافذة الشات بوت.
  • onError: يتم تشغيله عند حدوث خطأ في الشات بوت.
  • onMessageReceived: يتم تشغيله عندما يرسل البوت رسالة أو عندما يرسل المستخدم إدخالاً.
  • onMessageSent: يتم تشغيله عندما يرسل المستخدم رسالة.

كيفية استخدام معالجات الأحداث

يمكنك إعداد المعالجات باستخدام متغير fhChatbot الذي يتم إرجاعه من FHChatbot.initChatbot، وإضافة المستمعين مثل fhChatbot.onSessionCreated(). إليك مثال:

<script type="text/javascript" id="fh-chatbot-script-8f1fd880-8e9c-4cb1-a1f2-291c0329612b">
// catch event when chatbot is ready on your page
window.addEventListener("onFHChatbotReady", (e) => {
  console.log("Chatbot is ready, chat button should be visible at this time ready to be clicked.");
});

(function(d, src, c) { 
  var t=d.scripts[d.scripts.length - 1],s=d.createElement('script');
  s.async=true;s.src=src;s.onload=s.onreadystatechange=function(){
    var rs=this.readyState;
    if(rs&&(rs!='complete')&&(rs!='loaded')){return;}
    c(this);
  };
  t.parentElement.insertBefore(s,t.nextSibling);
})(document,
  'https://app.flowhunt.io/fh-chat-widget.js',
  function(e){ 
    const fhChatbot = FHChatbot.initChatbot({
      chatbotId: '8f1fd880-8e9c-4cb1-a1f2-291c0329612b',
      workspaceId: 'e31db667-893b-4e47-92c3-bb1f93c1b594',
      headerTitle: 'URLsLab FAQ Generator',
      maxWindowWidth: '700px',
      "urlSUffix": "?utm_source=asdfsdfgsdg"
    }); 
    
    fhChatbot.onSessionCreated(function () {
      // Custom logic when the session is created, could fire API calls, or store data
      console.log("session started");
    });
    
    fhChatbot.onWindowOpened(function () {
      // custom logic when the window opens, or show some content above the chat
      console.log("window opened");
    });
    
    fhChatbot.onWindowClosed(function () {
      // custom logic when the window is closed, or show some content above the chat
      console.log("window closed");
    });
    
    fhChatbot.onError(function (e) {
      // custom logic when an error is fired, could track it on error tracking tool.
      console.log(e.metadata);
      console.log("window error");
    });
    
    fhChatbot.onMessageReceived(function (e) {
      // custom logic when the bot answered.
      console.log("chatbot answered");
    });
    
    fhChatbot.onMessageSent(function (e) {
      // custom logic when the user sent an input.
      console.log("user sent an input");
    });
  }
);
</script>

يمكن لكل دالة من معالجات الأحداث تنفيذ منطق مخصص لجعل الشات بوت يتفاعل ديناميكيًا مع سلوك المستخدم.

حالات الاستخدام:

  • التحليلات والتقارير: تتبع بدء الجلسات واستخدام الشات بوت باستخدام أحداث مثل onSessionStart وغيرها لإرسال مقاييس قيمة.
  • تحديثات واجهة المستخدم ديناميكيًا: عدل صفحتك بناءً على أحداث الشات بوت (مثلاً: عرض رسالة مختلفة عند تفعيل الدردشة).
  • معالجة الأخطاء: اكتشف واستجب لأخطاء الشات بوت، لتعزيز تجربة المستخدم.
  • تدفقات مستخدم مخصصة: نفذ منطقًا خاصًا بناءً على تفاعلات المستخدم مع الدردشة.

تفعيل الدردشة المخصص: افتح وأغلق وفقًا لمنطقك

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

كيفية استخدام التفعيل المخصص

  1. تعطيل الزر الافتراضي: أضف في خيارات FHChatbot.initChatbot(): showChatButton: false.
  2. التحكم برمجيًا: استخدم طريقتي fhChatbot.openChat() وfhChatbot.closeChat() للتحكم في الظهور بناءً على أحداثك المخصصة.
<script type="text/javascript" id="fh-chatbot-script-8f1fd880-8e9c-4cb1-a1f2-291c0329612b">
(function(d, src, c) { 
  var t=d.scripts[d.scripts.length - 1],s=d.createElement('script');
  s.async=true;s.src=src;s.onload=s.onreadystatechange=function(){
    var rs=this.readyState;
    if(rs&&(rs!='complete')&&(rs!='loaded')){return;}
    c(this);
  };
  t.parentElement.insertBefore(s,t.nextSibling);
})(document,
  'https://app.flowhunt.io/fh-chat-widget.js',
  function(e){ 
    const fhChatbot = FHChatbot.initChatbot({
      chatbotId: '8f1fd880-8e9c-4cb1-a1f2-291c0329612b',
      workspaceId: 'e31db667-893b-4e47-92c3-bb1f93c1b594',
      headerTitle: 'URLsLab FAQ Generator',
      maxWindowWidth: '700px',
      "urlSUffix": "?utm_source=asdfsdfgsdg",
      "showChatButton": false
    }); 
    
    // Example: if user clicks on a button 
    const customChatButton = document.getElementById("myCustomChatButton")
    customChatButton.addEventListener("click", () => {
      fhChatbot.openChat();
    });

    // Example: if user closes by using a custom close button
    const customCloseChatButton = document.getElementById("myCustomCloseChatButton")
    customCloseChatButton.addEventListener("click", () => {
      fhChatbot.closeChat();
    });
  }
);
</script>

في هذا المثال، أضفنا مستمعين لأزرار مخصصة إما لفتح أو إغلاق الدردشة.

الفوائد:

  • تصميم مخصص: دمج الشات بوت مع هوية وتصميم موقعك، باستخدام زر مخصص أو محفزات أخرى لبدء الدردشة.
  • التحكم في تدفق المستخدم: أطلق الشات بوت في نقاط محددة أثناء رحلة المستخدم لتعزيز الدعم السياقي.
  • وضع استراتيجي: استخدم الرسوم المتحركة أو المؤثرات البصرية لجذب انتباه المستخدم نحو الشات بوت في الوقت المناسب.

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

الأسئلة الشائعة

ما هي متغيرات التدفق في FlowHunt؟

تسمح لك متغيرات التدفق بتمرير بيانات ديناميكية — مثل معلومات المستخدم أو الجلسة — إلى شات بوت FlowHunt الخاص بك. هذا يمكّن من إجراء محادثات مخصصة وواعية بالسياق مصممة لكل مستخدم.

كيف يمكنني تتبع تفاعلات الشات بوت باستخدام FlowHunt؟

استخدم معامل urlSuffix لإضافة سلاسل استعلام مخصصة إلى كل رابط يتم استدعاؤه بواسطة الشات بوت. هذا يسهل تتبع الحركة والتحويلات التي ينشئها الشات بوت في أدوات التحليلات مثل Google Analytics.

ما هي معالجات الأحداث المتوفرة في واجهة FlowHunt JS؟

يدعم FlowHunt معالجات الأحداث مثل onSessionCreated، onWindowOpened، onWindowClosed، onError، onMessageReceived، وonMessageSent، مما يمنحك تحكمًا كاملاً في تفاعلات المستخدم التي يقودها الشات بوت.

كيف أقوم بتفعيل أو التحكم في شات بوت FlowHunt برمجيًا؟

قم بتعيين 'showChatButton' إلى false لإخفاء الزر الافتراضي، ثم استخدم fhChatbot.openChat() و fhChatbot.closeChat() لفتح أو إغلاق الشات بوت بناءً على منطقك المخصص أو إجراءات المستخدم.

ما هي فوائد التخصيص المتقدم للشات بوت في FlowHunt؟

يتيح لك التخصيص المتقدم تخصيص رحلات المستخدمين، ودمج التحليلات، وتنفيذ إجراءات ديناميكية، ومطابقة تجربة الشات بوت بسلاسة مع تصميم موقعك واحتياجات عملك.

جرّب تخصيص الشات بوت المتقدم من FlowHunt

ارتقِ بشات بوتك إلى المستوى التالي مع الميزات المتقدمة لواجهة FlowHunt JS. خصص، وحلل، وتحكم في كل جانب من جوانب شات بوت الذكاء الاصطناعي الخاص بك.

اعرف المزيد

FlowHunt 2.6.12: تكامل Slack، تصنيف النوايا والمزيد
FlowHunt 2.6.12: تكامل Slack، تصنيف النوايا والمزيد

FlowHunt 2.6.12: تكامل Slack، تصنيف النوايا والمزيد

يقدم FlowHunt 2.6.12 تكامل Slack، وتصنيف النوايا، ونموذج Gemini، مما يعزز وظائف شات بوت الذكاء الاصطناعي، وفهم العملاء، وسير العمل في الفريق....

2 دقيقة قراءة
FlowHunt AI Chatbot +5
إنشاء ألعاب مصغرة بالذكاء الاصطناعي باستخدام مولد ألعاب AI في FlowHunt
إنشاء ألعاب مصغرة بالذكاء الاصطناعي باستخدام مولد ألعاب AI في FlowHunt

إنشاء ألعاب مصغرة بالذكاء الاصطناعي باستخدام مولد ألعاب AI في FlowHunt

تعلّم كيفية بناء مولد ألعاب جافاسكريبت بالذكاء الاصطناعي في FlowHunt باستخدام وكيل استدعاء الأدوات، وعقدة البرمبت، ونموذج لام أنثروبيك. دليل خطوة بخطوة بناءً عل...

3 دقيقة قراءة
AI Game Generator +5