<?php // /local/api/chat-to-crm.php require_once $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php'; $payload = json_decode(file_get_contents('php://input'), true); if (!$payload) { http_response_code(400); exit; } $name = trim($payload['visitor']['name'] ?? $payload['name'] ?? ''); $email = trim($payload['visitor']['email'] ?? $payload['email'] ?? ''); $phone = trim($payload['visitor']['phone'] ?? $payload['phone'] ?? ''); $text = buildTranscript($payload); // собираем историю переписки // Базовая валидация: хотя бы email или телефон if (!$email && !$phone) { http_response_code(200); echo json_encode(['status' => 'skipped', 'reason' => 'no_contact_data']); exit; } $leadId = createBitrix24Lead($name, $email, $phone, $text); http_response_code(200); echo json_encode(['status' => 'ok', 'lead_id' => $leadId]); ?> 

<?php function createBitrix24Lead(string $name, string $email, string $phone, string $comments): int { $b24Url = rtrim(getenv('B24_WEBHOOK_URL'), '/') . '/'; $fields = [ 'TITLE' => 'Chat: ' . ($name ?: $email ?: $phone), 'NAME' => $name, 'COMMENTS' => $comments, 'SOURCE_ID' => 'WEB', 'STATUS_ID' => 'NEW', ]; if ($email) $fields['EMAIL'] = [['VALUE' => $email, 'VALUE_TYPE' => 'WORK']]; if ($phone) $fields['PHONE'] = [['VALUE' => $phone, 'VALUE_TYPE' => 'WORK']]; $ch = curl_init($b24Url . 'crm.lead.add.json'); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => http_build_query(['fields' => $fields]), CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10, ]); $response = json_decode(curl_exec($ch), true); curl_close($ch); return (int)($response['result'] ?? 0); } ?> 

לצורך ניפוי באגים, השתמשו ברישום לקובץ או במערכת ניטור. אנו מבטיחים שה-handler מטפל נכון בשגיאות רשת ובכפילויות.

שיטה 2: מחבר Bitrix24 מקורי

ל-JivoSite, LiveChat ועוד כמה פלטפורמות יש מחבר מוכן במרקטפלייס של Bitrix24. התקנה: Bitrix24 → מרקטפלייס → מצאו את הצ'אט הנדרש → התקינו. בצעו הרשאת מחבר בחשבון הצ'אט שלכם, הגדירו איזו שורת פתיחה תקבל את הפניות.

מגבלה של מחברים מקוריים: הנתונים מועברים כפי שהפלטפורמה מספקת אותם. שדות מותאמים אישית (לדוגמה, נתוני עגלה מ-Bitrix) לא ניתנים להעברה דרך מחבר מקורי — רק דרך Webhook עם handler מותאם אישית.

שיטה 3: ערוץ דואר אלקטרוני של CRM

האפשרות הפשוטה ביותר לצ'אטים ללא Webhook: הגדירו שליחת תמליל השיחה לכתובת דואר אלקטרוני ש-Bitrix24 עוקב אחריה כערוץ דואר של CRM. Bitrix24 מזהה את איש הקשר לפי כתובת הדואר בהודעה ויוצר ליד אוטומטית.

הגדרה: Bitrix24 → CRM → הגדרות → ערוצי דואר → הוספת ערוץ. ציינו את תיבת הדואר שממנה מגיעות הודעות הצ'אט. שימו לב: רק המידע מהדואר האלקטרוני ייכנס לליד — מספר טלפון ושם אם הוזנו ידנית.

מניעת כפילויות לידים

כפילויות הן בעיה נפוצה באינטגרציית צ'אט. אם לקוח כותב מספר פעמים, ללא בדיקה תקבלו עשרות לידים זהים. פתרון: לפני קריאה ל-crm.lead.add, בדקו קיום איש קשר קיים לפי דואר אלקטרוני או טלפון באמצעות crm.lead.list. ב-handler שלנו אנו משתמשים בפונקציה <?php // /local/api/chat-to-crm.php require_once $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php'; $payload = json_decode(file_get_contents('php://input'), true); if (!$payload) { http_response_code(400); exit; } $name = trim($payload['visitor']['name'] ?? $payload['name'] ?? ''); $email = trim($payload['visitor']['email'] ?? $payload['email'] ?? ''); $phone = trim($payload['visitor']['phone'] ?? $payload['phone'] ?? ''); $text = buildTranscript($payload); // собираем историю переписки // Базовая валидация: хотя бы email или телефон if (!$email && !$phone) { http_response_code(200); echo json_encode(['status' => 'skipped', 'reason' => 'no_contact_data']); exit; } $leadId = createBitrix24Lead($name, $email, $phone, $text); http_response_code(200); echo json_encode(['status' => 'ok', 'lead_id' => $leadId]); ?> ששולחת שאילתה ל-API עם פילטר לפי EMAIL ו-PHONE. אם ליד כבר קיים, אנו מעדכנים אותו או מוסיפים תגובה, במקום ליצור חדש. זה מפחית כפילויות ב-95%.

העברת נתונים נוספים דרך UTM

לצורך ייחוס ליד למקור תנועה, העבירו תגי UTM ב-Webhook:

// На стороне сайта: читаем UTM из URL и сохраняем в sessionStorage const params = new URLSearchParams(window.location.search); ['utm_source', 'utm_medium', 'utm_campaign'].forEach(k => { if (params.get(k)) sessionStorage.setItem(k, params.get(k)); }); 

<?php // В Webhook-обработчике: достаём UTM из данных чата // (большинство чат-платформ передают referrer и custom_data) $utmSource = $payload['visitor']['utm_source'] ?? ''; $utmMedium = $payload['visitor']['utm_medium'] ?? ''; $utmCampaign = $payload['visitor']['utm_campaign'] ?? ''; $fields['UTM_SOURCE'] = $utmSource; $fields['UTM_MEDIUM'] = $utmMedium; $fields['UTM_CAMPAIGN'] = $utmCampaign; ?> 

תהליך העבודה שלנו

1. ניתוח: בחינת ארכיטקטורת הפורטל, רשימת פלטפורמות הצ'אט, דרישות הנתונים.
2. תכנון: בחירת שיטת אינטגרציה, מיפוי שדות, תכנית הסרת כפילויות.
3. פיתוח: כתיבת handler ל-Webhook, הגדרת מחבר או ערוץ דואר.
4. בדיקות: בדיקה בפורטל בדיקה, יצירת לידים לבדיקה, סקירת לוגים.
5. פריסה: מעבר לסביבת ייצור, הפעלת ניטור, מסירת תיעוד.

טבלת השוואה

לוחות זמנים אופייניים ליישום

אימות האינטגרציה

צרו דיאלוג בדיקה בצ'אט, הזינו שם, דואר אלקטרוני וטלפון. ודאו שמופיע ליד חדש ב-CRM עם הפרטים האלה. בדקו מילוי תגי UTM והיעדר כפילויות בבקשות חוזרות. אם הליד לא נוצר, בדקו את לוגי ה-handler ואת הרשאות הגישה ל-Webhook.

מה כלול בעבודה?

• הגדרת handler ל-Webhook או התקנת מחבר מקורי
• יצירת שדות מותאמים אישית ב-CRM (אם נדרש)
• אינטגרציה עם המקור: JivoSite, Chatra, Talk-Me, LiveChat וכו'
• תיעוד תפעולי ומסירת גישה
• חודש תמיכה טכנית לאחר ההשקה

לוח זמנים ועלות

לוחות הזמנים של האינטגרציה תלויים במורכבות ובשיטה הנבחרת: מיום אחד (ערוץ דואר) עד שבוע (Webhook עם לוגיקה מותאמת אישית). העלות מחושבת באופן פרטני לאחר ניתוח הפרויקט שלכם. מחירים לדוגמה: ערוץ דואר מ-$350, מחבר מקורי מ-$500, Webhook מותאם אישית מ-$1200. צרו קשר לייעוץ חינמי והערכת עלות. הזמינו הגדרת אינטגרציה מצ'אט ל-CRM — נבחר את השיטה האופטימלית וניישם אותה במפתח מלא. למהנדסים שלנו יש ניסיון של למעלה מ-8 שנים עם Bitrix24 ואוטומציה של מכירות.