טופס יצירת הקשר באתר מולא — והליד לא מופיע ב-CRM. המנהל מגלה על הפנייה מאימייל כעבור חצי שעה ומזין את הנתונים ידנית. בזמן הזה, כל לקוח שלישי עובר למתחרים. הצוות שלנו נתקל במצבים כאלה פעמים רבות: אובדן לידים עקב עיבוד ידני מגיע ל-30%, בעלות של כ-$2 לכל ליד שאבד. אנו מגדירים הגשת לידים אוטומטית כך שהפנייה מגיעה ל-Bitrix24 תוך 2 שניות — מהיר פי 900 מהזנה ידנית. צרו איתנו קשר — נגדיר העברת לידים במפתח פתוח.
הגדרה נכונה מבטלת אובדנים, מזרזת עיבוד ומספקת אטריבוציה מלאה: מאיפה הגיע הלקוח, באיזה טופס השתמש, אילו תגי UTM עבדו. אנו מבטיחים אינטגרציה יציבה. יתרה מכך, REST API גמיש פי 3 מהקונקטור הסטנדרטי — הוא תומך בכל טפסים מותאמים אישית ומעביר עד 50 שדות נוספים. חיסכון בזמן למנהלים לאחר אוטומציה מגיע עד 80%, כלומר מעל $1,500 בחודש לצוות של חמישה. עלות יישום טיפוסית נעה בין $500 ל-$2,000 בהתאם למורכבות.
כיצד להגדיר REST API להעברת לידים?
-
קבלו נקודת קצה של webhook נכנס ב-Bitrix24 דרך לוח הניהול: יישומים → Webhooks → Webhook נכנס. בחרו הרשאות
crm(קריאה/כתיבה) לעבודה עם לידים ואנשי קשר. העתיקו את כתובת ה-webhook — זו נקודת הכניסה ל-JSON-RPC לכל בקשות ה-REST. ה-webhook נוצר פעם אחת ונשאר קבוע; הגנו עליו מפני דליפות. -
במטפל טופס האתר (לדוגמה, פונקציית PHP המעבדת את אירוע שליחת הטופס), השתמשו במבנה הקוד הבא:
use Bitrix\Main\Web\HttpClient; $http = new HttpClient(); $http->setHeader('Content-Type', 'application/json'); $leadData = [ 'TITLE' => 'Заявка с сайта: ' . $formFields['NAME'], 'NAME' => $formFields['NAME'], 'PHONE' => [['VALUE' => $formFields['PHONE'], 'VALUE_TYPE' => 'WORK']], 'EMAIL' => [['VALUE' => $formFields['EMAIL'], 'VALUE_TYPE' => 'WORK']], 'COMMENTS' => $formFields['MESSAGE'], 'SOURCE_ID' => 'WEB', 'SOURCE_DESCRIPTION' => 'Форма: ' . $formName . ' | URL: ' . $pageUrl, ]; $response = $http->post( 'https://your-domain.bitrix24.ru/rest/1/токен/crm.lead.add.json', json_encode(['fields' => $leadData, 'params' => ['REGISTER_SONET_EVENT' => 'Y']]) ); לפרטים נוספים, ראו את התיעוד הרשמי של REST API.
השוואת שיטות העברה
| שיטה | מורכבות | גמישות | זמן הגדרה | תמיכה בשדות מותאמים אישית |
|---|---|---|---|---|
| מודול Bitrix24.Connector | נמוכה | נמוכה (רק טפסי אתר סטנדרטיים) | 2–4 שעות | לא, מוגבל לשדות סטנדרטיים |
| REST API (ידני) | גבוהה | גבוהה (כל טפסים, כל מקורות נתונים, UTM, דה-דופליקציה) | 4–8 שעות | כן, עד 50 שדות נוספים |
| החלפת CommerceML | בינונית | בינונית (סנכרון קטלוג והזמנות, לא בזמן אמת) | 1–2 ימים | מוגבל לסכמת CommerceML |
REST API גמיש יותר למסחר אלקטרוני ו-B2B, שבהם העברת נתונים מורכבת ממקורות שונים היא קריטית. בניגוד להחלפת CommerceML, REST API מאפשר הגשת לידים בזמן אמת עם אטריבוציה מלאה.
למה דה-דופליקציה חשובה?
לפני יצירת ליד, אנו בודקים אנשי קשר קיימים לפי טלפון דרך https://your-domain.bitrix24.ru/rest/1/токен/:
$dupes = $http->post($webhookUrl . 'crm.duplicate.findByComm.json', json_encode([ 'type' => 'PHONE', 'values' => [$formFields['PHONE']], ])); אם נמצא איש קשר, אנו יוצרים עסקה/פעילות על איש הקשר הקיים במקום ליד חדש. זה מונע עומס ב-CRM עם לידים כפולים מלקוחות חוזרים. בפועל, דה-דופליקציה מפחיתה לידים חוזרים ב-30%.
מה העברת לידים אוטומטית מספקת
השוו: לפני ההגדרה — 30 דקות של העברה ידנית, 15% סיכוי לשגיאה, אובדן של כל ליד שלישי. אחרי — 2 שניות, 0 שגיאות, 100% שימור. חיסכון בזמן למנהלים הוא עד 80%.
| פרמטר | לפני ההגדרה | אחרי ההגדרה |
|---|---|---|
| זמן עיבוד פנייה | 30 דקות | 2 שניות |
| אובדן לידים | ~30% | <1% |
| שגיאות הזנה | 15% | 0% |
| אטריבוציה | אין | מלאה (UTM, מקור) |
שגיאות REST API נפוצות ופתרונות
- 403 Forbidden: ודאו שהרשאות
use Bitrix\Main\Web\HttpClient; $http = new HttpClient(); $http->setHeader('Content-Type', 'application/json'); $leadData = [ 'TITLE' => 'Заявка с сайта: ' . $formFields['NAME'], 'NAME' => $formFields['NAME'], 'PHONE' => [['VALUE' => $formFields['PHONE'], 'VALUE_TYPE' => 'WORK']], 'EMAIL' => [['VALUE' => $formFields['EMAIL'], 'VALUE_TYPE' => 'WORK']], 'COMMENTS' => $formFields['MESSAGE'], 'SOURCE_ID' => 'WEB', 'SOURCE_DESCRIPTION' => 'Форма: ' . $formName . ' | URL: ' . $pageUrl, ]; $response = $http->post( 'https://your-domain.bitrix24.ru/rest/1/токен/crm.lead.add.json', json_encode(['fields' => $leadData, 'params' => ['REGISTER_SONET_EVENT' => 'Y']]) );מוגדרות בהיקף ה-webhook. ללא היקף מתאים, יצירת ליד נכשלת. - חסר TITLE/NAME: העבירו לפחות TITLE ושדה איש קשר אחד; אחרת הליד לא נוצר.
- אובדן אטריבוציית UTM: האריכו את חיי הסשן או קראו UTM מפרמטרי URL כדי למנוע אובדן במילוי טפסים ארוך.
- לידים כפולים: תמיד קראו ל-
crm.duplicate.findByCommלפני יצירת ליד. יישמו מפתחות אידמפוטנטיות אם נדרש. - לידים ללא אחראי: הגדירו
$dupes = $http->post($webhookUrl . 'crm.duplicate.findByComm.json', json_encode([ 'type' => 'PHONE', 'values' => [$formFields['PHONE']], ]));כדי להקצות מנהל אחראי אוטומטית. - כשלים שקטים: בדקו את קוד תגובת HTTP ותעדו שגיאות; השתמשו במצב verbose של cURL לניפוי.
שגיאות טיפוסיות בהגדרת REST API להעברת לידים
אינטגרציה לא יציבה נובעת לעיתים קרובות מחוסרים בהגדרה. השגיאות הנפוצות ביותר:
-
הרשאות
crmלא מוגדרות ב-webhook — לידים לא נוצרים כלל, קוד שגיאה 403 Forbidden. - מועבר רק טלפון ללא TITLE ו-NAME — הליד לא נראה ברשימת Bitrix24, היצירה נכשלת.
- תגי UTM נלקחים מהסשן אך הסשן לא הוארך — האטריבוציה נשברת במילוי טפסים ארוך (מעל שעה).
- חסרה דה-דופליקציה — נוצרים 5–10 לידים כפולים לאותו לקוח ממקורות ומכשירים שונים.
- ASSIGNED_BY_ID לא מוגדר — לידים נוצרים אך לא מוקצים למנהלים, מה ששובר את זרימת העבודה.
- המטפל לא בודק את קוד תגובת HTTP — שגיאות לא מתגלות, מנהלים מאבדים לידים.
תוצרים
- ניתוח טפסי האתר הנוכחיים ובלוקי מידע.
- יצירת webhook נכנס עם ההרשאות הנדרשות.
- כתיבת מטפל PHP עם UTM ודה-דופליקציה (JSON-RPC, cURL, אידמפוטנטיות).
- הגדרת הקצאת אחראי (לפי עיר, שירות, זמן) באמצעות
ASSIGNED_BY_ID. - בדיקות על נתונים חיים עם טיפול במגבלות קצב API.
- מסירת תיעוד והדרכת מנהלים.
- שבועיים של תמיכה לאחר השחרור.
גם 1C-Bitrix וגם Bitrix24 תומכים בשיטות אינטגרציה אלה, מה שמשפר את אוטומציית המכירות ויצירת לידים. לצוות שלנו יש ניסיון מעשי של 10+ שנים עם Bitrix ו-Bitrix24, עם למעלה מ-50 אינטגרציות מוצלחות בתעשיות שונות. אנו מבטיחים את כל העבודה — האינטגרציה תהיה יציבה ואמינה. קבלו ייעוץ חינם לפרויקט שלכם — נעריך את ההיקף, לוח הזמנים והעלות.







