המדריך לשליחת לידים ב-API
שליחת לידים ב-API - POST אחד, מפתח אחד, ליד בוואטסאפ
יש לך מקור לידים מותאם אישית - אפליקציה, מערכת פנימית, או תהליך שלא רץ בדפדפן - ואתה רוצה לשלוח ליד ישירות בלי תג script. המדריך מסביר ברמת עקרונות איך נראית קריאת POST ל-/api/v1/leads, אילו שדות נדרשים, ומה השגיאות הנפוצות שתיתקל בהן - בלי לחשוף פרטי אבטחה פנימיים.
ללא כרטיס אשראי · 7 ימי ניסיון- מפתח אחד לחשבון, לא סוד לכל טופס
- אותו לוח בקרה ואותה הודעת וואטסאפ
- מ-19 ₪/חודש · 7 ימי ניסיון בלי כרטיס אשראי
העקרונות
מתי שולחים ליד ב-API ולא בתג
רוב האתרים לא צריכים API בכלל - תג <script> אחד תופס את הטופס הקיים ועושה את כל העבודה. ה-API רלוונטי כשאין טופס דפדפן בכלל: אפליקציית מובייל, מערכת back-office פנימית, או תהליך שרץ בשרת ומייצר ליד בלי שמישהו לוחץ ״שלח״ בדפדפן. במקרים האלה, קריאת POST ישירה היא הדרך הנכונה.
מבנה הבקשה פשוט בכוונה: קריאת POST לכתובת /api/v1/leads, עם מפתח (API key) שמזהה את החשבון שלך, וגוף בקשה בפורמט JSON עם שדות הליד - שם, טלפון, נושא ולעיתים מקור (source). המפתח הוא מה שמקשר את הליד אליך, והוא נשלח בנפרד מגוף הבקשה כדי לצמצם את הסיכוי שייחשף בשוגג בלוגים או בכלים שמדפיסים בקשות.
חשוב להבין: זו לא תחליף לתג עבור טופס רגיל באתר - זו דרך נוספת לאותה מערכת בדיוק, לאותו לוח בקרה ולאותה שליחת וואטסאפ. אם יש לך גם טופס רגיל וגם מקור ליד מותאם, שניהם יכולים לזרום לאותו חשבון במקביל בלי סתירה.
מה בגוף הבקשה
השדות שסביר שתצטרך לשלוח
ככל שהבקשה פשוטה יותר, כך פחות דברים יכולים להשתבש בצד שלך.
טלפון - שדה חובה
בלי טלפון תקין עם קידומת ישראלית הבקשה נדחית - זה השדה שמאפשר לחזור ללקוח בכלל.
שם
שם הליד, כדי שההודעה שמגיעה לוואטסאפ תהיה אישית ולא רק מספר טלפון יבש.
נושא ומקור
שדה חופשי שמתאר את הפנייה, ושדה מקור (source) שעוזר לדעת מאיפה הליד הגיע כשיש כמה ערוצים.
שדות מותאמים
אפשר לצרף שדות נוספים ספציפיים לעסק שלך - הם יופיעו בלוח הבקרה גם אם אינם חלק מהשדות הבסיסיים.
איך זה עובד בפועל
לשלוח ליד ראשון דרך ה-API
ארבעה שלבים, בלי תלות בדפדפן או בטופס קיים.
- 1
מוצאים את מפתח ה-API של החשבון
המפתח נמצא בהגדרות החשבון בלוח הבקרה - הוא ייחודי לחשבון שלך ומזהה לאן הליד שייך.
- 2
בונים בקשת POST עם גוף JSON
שם, טלפון, נושא ומקור - כשדות בגוף הבקשה, בפורמט JSON תקין.
- 3
שולחים את הבקשה מהשרת או מהאפליקציה
כל שפת תכנות שיודעת לשלוח בקשת HTTP יכולה לבצע את הקריאה - אין תלות בדפדפן.
- 4
בודקים שהליד הופיע בלוח הבקרה ובוואטסאפ
תוך שניות מהבקשה המוצלחת, ההודעה אמורה להגיע לוואטסאפ ולהישמר בלוח.
כשמשהו לא עובד
שגיאות נפוצות ומה הן אומרות
רוב הבעיות בשלב האינטגרציה נופלות לאחת מארבע הקטגוריות האלה.
401 - מפתח לא תקין
המפתח שנשלח שגוי, נמחק או שייך לחשבון אחר. בודקים שהמפתח הועתק כמו שהוא, בלי רווחים מיותרים.
400 - שדה חסר או לא תקין
לרוב טלפון חסר או בפורמט לא תקין. בודקים שהמספר כולל קידומת ישראלית תקינה בגוף JSON תקין.
429 - יותר מדי בקשות
נשלחו יותר בקשות מהמותר בפרק זמן קצר - לרוב סימן לבאג שקורא לבקשה בלולאה, לא לנפח לידים אמיתי.
500 - שגיאת שרת זמנית
תקלה זמנית בצד שלנו. מומלץ לבנות ניסיון חוזר קצר לפני שמוותרים על הבקשה.
לחבר את מקור הלידים שלך ל-API
מפתח אחד, קריאת POST אחת, ואותו לוח בקרה ואותה הודעת וואטסאפ כמו בתג. מ-19 ₪ לחודש, 7 ימי ניסיון בלי כרטיס אשראי.
שאלות נפוצות
מה זה POST /api/v1/leads?
זו נקודת הקצה שדרכה אפשר לשלוח ליד ישירות למערכת בלי תג script בדפדפן - שימושי כשמקור הליד הוא אפליקציה, מערכת פנימית או תהליך שרץ בשרת. הבקשה כוללת מפתח API וגוף JSON עם פרטי הליד.
אילו שדות חובה בבקשת ה-API?
טלפון הוא השדה החיוני - בלעדיו הבקשה נדחית, כי אין למי לחזור. שם ונושא מומלצים מאוד כדי שההודעה שתגיע לוואטסאפ תהיה שימושית, ואפשר לצרף גם שדה מקור (source) ושדות מותאמים לפי הצורך.
איפה מקבלים את מפתח ה-API?
בהגדרות החשבון בלוח הבקרה. המפתח ייחודי לחשבון שלך ומזהה לאן כל ליד שנשלח באמצעותו שייך - חשוב לשמור אותו כמו סיסמה ולא לחשוף אותו בקוד גלוי בצד לקוח.
מה עושים כשמתקבלת שגיאת 400 או 401?
401 אומר שהמפתח שגוי או לא תקין - בודקים שהוא הועתק במדויק. 400 אומר בעיקר ששדה חובה, לרוב טלפון, חסר או בפורמט לא תקין - בודקים שהמספר כולל קידומת ישראלית תקינה בגוף JSON תקין.
כמה בקשות אפשר לשלוח בדקה?
יש הגבלת קצב שמונעת עומס לא סביר על המערכת. שגיאת 429 חוזרת ונשנית היא לרוב סימן לבאג בקוד שקורא לבקשה בלולאה, ולא למגבלה אמיתית על נפח לידים כן.
ה-API מחליף את תג ה-script?
לא, הוא מקביל אליו. תג script נועד לטופס שרץ בדפדפן; ה-API נועד למקורות ליד שאין בהם דפדפן בכלל, כמו אפליקציה או מערכת פנימית. שניהם יכולים לזרום במקביל לאותו חשבון ולוח בקרה.
צריך לדעת לתכנת כדי להשתמש ב-API?
כן, ברמה בסיסית - צריך לדעת לבנות ולשלוח בקשת HTTP מקוד, כמעט כל שפת תכנות תומכת בכך. אם אין לך מקור ליד מותאם ורק רוצה לחבר טופס אתר רגיל, תג script פשוט הרבה יותר ולא דורש קוד בכלל.