אינטגרציה אמינה בין מחשבון ל-CRM: הימנעו מאובדן לידים

אינטגרציה אמינה בין מחשבון ל-CRM: מניעת אובדן לידים

תארו לעצמכם: 50 מבקרים בשעה באתר שלכם, כל אחד מבצע חישוב—ו-5 לידים נעלמים ללא עקבות. נשמע מוכר? הסיבה היא המגבלות הקפדניות של REST API של Bitrix24. התעריף הענני מאפשר 2 בקשות בשנייה ו-5000 ביום. חריגה מהן מחזירה את השגיאה QUERY_LIMIT_EXCEEDED. לדוגמה, לקוח—רשת סוכנויות רכב—החזיק מחשבון עלות משלוח שייצר עד 50 בקשות בדקה. שליחה ישירה הובילה לאובדן של 10% מהלידים. עם ניסיון של 10+ שנים בפיתוח Bitrix, פיתחנו תוכנית אמינה עם תור וניסיונות חוזרים אוטומטיים. להלן פירוט מלא של היישום. עלות פיתוח טיפוסית נעה בין 500 ל-2000 דולר בהתאם למורכבות. עם מערכת תור, אתם נמנעים מאובדן של 10% מהלידים, וחוסכים פוטנציאלית אלפים בחודש—לדוגמה, לקוח טיפוסי חוסך 1,500 דולר בחודש. צרו קשר לייעוץ—נעריך את הפרויקט שלכם.

איך זה עובד

העברת נתונים מהמחשבון ל-CRM באמצעות REST API

האתר על 1C-Bitrix ו-Bitrix24 הם שני מוצרים עם API שונים. כדי להעביר נתונים מטופס ל-CRM, נעשה שימוש ב-REST API של Bitrix24:

• crm.lead.add — יצירת ליד
• crm.deal.add — יצירת עסקה ללא ליד
• crm.contact.add + crm.deal.add — איש קשר + עסקה

אימות: webhook נכנס (פשוט) או אפליקציית OAuth (לפורטלים מרובים). לפי התיעוד, המגבלות הן 2 בקשות בשנייה ו-5000 ביום לתעריפים ענניים. דוגמה ליצירת ליד:

$webhookUrl = 'https://your-portal.bitrix24.ru/rest/1/WEBHOOK_TOKEN/';
$fields = [
    'TITLE' => 'Заявка с калькулятора: ' . $calculatorName,
    'NAME' => $clientName,
    'PHONE' => [['VALUE' => $clientPhone, 'VALUE_TYPE' => 'WORK']],
    'EMAIL' => [['VALUE' => $clientEmail, 'VALUE_TYPE' => 'WORK']],
    'COMMENTS' => $calcResultText,
    'SOURCE_ID' => 'WEB',
    'UF_CRM_CALCULATOR_PARAMS' => json_encode($calcParams),
    'UF_CRM_TOTAL_PRICE' => $totalPrice,
];
$response = file_get_contents(
    $webhookUrl . 'crm.lead.add.json?' . http_build_query(['fields' => $fields])
);
$result = json_decode($response, true);

יצירת שדות מותאמים אישית לפרמטרי חישוב

שדות מותאמים אישית $webhookUrl = 'https://your-portal.bitrix24.ru/rest/1/WEBHOOK_TOKEN/'; $fields = [ 'TITLE' => 'Заявка с калькулятора: ' . $calculatorName, 'NAME' => $clientName, 'PHONE' => [['VALUE' => $clientPhone, 'VALUE_TYPE' => 'WORK']], 'EMAIL' => [['VALUE' => $clientEmail, 'VALUE_TYPE' => 'WORK']], 'COMMENTS' => $calcResultText, 'SOURCE_ID' => 'WEB', 'UF_CRM_CALCULATOR_PARAMS' => json_encode($calcParams), 'UF_CRM_TOTAL_PRICE' => $totalPrice, ]; $response = file_get_contents( $webhookUrl . 'crm.lead.add.json?' . http_build_query(['fields' => $fields]) ); $result = json_decode($response, true); מאחסנים את כל פרטי החישוב—אפשרויות נבחרות, סכום כולל, תצורה. המנהל פותח את הליד ומיד רואה את ההקשר. השדות נוצרים מראש: UF_CRM_*. הסוג תלוי בנתונים.

איך להתמודד עם מגבלות API ושגיאות?

Bitrix24 הענני מגביל בקשות REST: 2 בקשות בשנייה, 5000 ביום (תלוי בתעריף). בחריגה, התשובה: UF_CRM_PARAMS_JSON. יישום טיפוסי ללא תור מאבד 5–10% מהלידים בעומס של 50 בקשות/דקה.

הפתרון הנכון:

1. שמירת נתוני המחשבון בטבלת תור (highload-block או טבלה נפרדת)
2. סוכן Bitrix השולח רשומות בקבוצות כל 30 שניות, תוך כיבוד המגבלות
3. ניסיון חוזר בשגיאה עם השהיה אקספוננציאלית (1 שנייה, 2 שניות, 4 שניות, 8 שניות)
4. דגל {error: "QUERY_LIMIT_EXCEEDED"} לשליטה בסטטוס

function sendPendingLeadsToCRM(): string {
    $pendingLeads = getUnsentLeads(limit: 10);
    foreach ($pendingLeads as $lead) {
        $result = sendLeadToB24($lead);
        if ($result['result']) {
            markLeadAsSent($lead['id'], $result['result']);
        } else {
            incrementRetryCount($lead['id']);
        }
        usleep(600000); // 0.6 сек между запросами
    }
    return __FUNCTION__ . '();';
}

\CAgent::AddAgent( 'sendPendingLeadsToCRM();', '', 'N', 30, '', 'Y', '', 100 );