מערכת הלידים שלך מהווה כלי מרכזי לניהול לקוחות פוטנציאליים. לעיתים, עולה הצורך לשלוח לידים באופן מיידי מצד הלקוח, ישירות מהדפדפן - למשל, בעקבות מילוי טופס או אינטראקציה אחרת באתר. חשוב לדעת כי ה-API הסטנדרטי של המערכת אינו מיועד לקליטת לידים מצד שרת ואינו פתוח לקריאות AJAX ישירות, וזאת מטעמי אבטחת מידע קפדניים.
כדי לאפשר שליחת לידים בצורה מאובטחת ויעילה באמצעות JavaScript, פיתחנו את ה-
JS API. זוהי מעטפת נוחה וידידותית לשימוש עבור ה-API הרגיל, המאפשרת לבצע שליחת לידים ישירות מקוד צד הלקוח. השימוש ב- JS API כפוף להנחיות המפורטות בפרטי הערוץ הרלוונטי וכן בלשונית קליטת הלידים במערכת הלידים שלכם, שם תוכלו למצוא את מספר הערוץ, מפתח האבטחה ושמות הפרמטרים הנדרשים.
כיצד להשתמש ב-JS API?
תהליך השימוש ב-JS API כולל שני שלבים פשוטים: הטמעת ה-Loader ושליחת הליד באמצעות פונקציית `leadim`.
שלב 1: הטמעת ה-Loader
את קטע הקוד הבא יש להוסיף
מיד לאחר תגית ה-`<body>` הפותחת בקוד ה-HTML של האתר שלכם:
<script>
//Loader. Should be placed after opening BODY tag
(function(l,e,a,d,i,m,s){l[i]=
l[i]||function(){
(l[i].q=l[i].q||[]).push(
arguments)};m=e.createElement(
a),s=e.getElementsByTagName(a)
[0];m.async=0;m.src=d;s.
parentNode.insertBefore(m,s)
})(window,document,'script','/
/
cdn.lead.im/api/v3/leadim.api.js','leadim');
</script>
חשוב לזכור: ה- Loader זהה ל- Loader המשמש בסקריפט מדידת השיחות של המערכת. לכן,
אם כבר הטמעתם את סקריפט מדידת השיחות באתר שלכם, אין צורך להטמיע את קטע הקוד הזה פעם נוספת. הוא כבר ייטען כחלק ממדידת השיחות.
שלב 2: שליחת הליד
כדי לשלוח ליד בפועל, יש להשתמש בפונקציה `leadim('lead', {})`. קטע הקוד הבא מציג דוגמה בסיסית לשליחת ליד:
//Send Lead with lead.im.JS.API, should be called whenever lead should be sent to the system
leadim('lead', {
channelID: XXXXX, //lm_form
channelKey: 'YYYYYYYYYY', //lm_key
fields: { //Dynamic fields. According to the standard POST API parameters and values
'name': '11',
'email': '2@2.2',
'phone': '0523213213',
..........
},
callback: function () { //callback called when lead is sent
alert ('The lead has been successfully sent!');
}
});
הקפידו להחליף את הפרטים הבאים:
* את `XXXXX`
במספר הערוץ הייעודי לקליטת לידים.
* את `'YYYYYYYYYY'`
במפתח האבטחה של אותו הערוץ.
* את השדות בתוך האובייקט `fields`
בשמות הפרמטרים המדוייקים, כפי שהם מוגדרים במערכת הלידים עבור הערוץ הספציפי.
הפונקציה `callback` תופעל לאחר שהליד יישלח בהצלחה למערכת, ובדוגמה זו תוצג התראה למשתמש.
לסיכום
ה-JS API מספק פתרון נוח, יעיל ומאובטח לשליחת לידים ישירות מהדפדפן. על ידי הטמעת ה- Loader ושימוש בפונקציית ה- `leadim`, תוכלו לשפר את תהליך קליטת הלידים באתר שלכם ולאפשר אינטגרציה גמישה עם קוד JavaScript בצד הלקוח. זכרו תמיד להתייחס להנחיות העדכניות המופיעות במערכת הלידים עבור הערוץ הרלוונטי כדי להבטיח שליחה תקינה של הלידים.