סנכרון לידים של Salesforce באמצעות REST API ו-OAuth 2.0

שלבו את האתר שלכם עם Salesforce: REST API, OAuth 2.0, סנכרון לידים

עד 30% מהלידים אובדים כי הגשות טפסים לעולם לא מגיעות ל-CRM. מנהלים מבזבזים שעות על הזנת נתונים ידנית. שילוב האתר שלכם עם Salesforce דרך REST API פותר זאת. REST API תומך בעד 5,000 בקשות ביום (מדריך מפתחי REST API של Salesforce) והוא גמיש פי עשרה מ-Web-to-Lead. Platform Events מאפשר סנכרון דו-כיווני בזמן אמת, אם כי עם הגדרה מורכבת יותר. המהנדסים שלנו מוסמכים על ידי Salesforce (PD I, App Builder) עם ניסיון של למעלה מ-5 שנים ויותר מ-50 פרויקטים בתחום הקמעונאות והשירותים.

כל ליד שנוצר אוטומטית ב-Salesforce חוסך עלויות משמעותיות של הזנה ידנית. עבור 500 לידים בחודש, החיסכון עולה על $720–1k, וזמן העיבוד יורד מ-10 דקות ל-30 שניות – שיפור של פי 20. עלות השילוב מתחילה מ-$2.7k–3.9k, ורוב הלקוחות רואים החזר השקעה תוך 3 חודשים.

השוואת שיטות שילוב

*ניתן להגדיל את המגבלה לפי בקשה ל-Salesforce.

הגדרת Connected App עבור OAuth 2.0

1. ב-Salesforce: Setup → App Manager → New Connected App
2. הפעל הגדרות OAuth, הוסף כתובת URL להתקשרות חוזרת
3. בחר הרשאות: api, refresh_token
4. אחזר את Consumer Key ו-Consumer Secret

יצירת לידים מטפסי אתר

use Omniphx\Forrest\Providers\LaravelServiceProvider;

// composer require omniphx/forrest

// config/forrest.php
'credentials' => [
    'consumer_key' => env('SF_CONSUMER_KEY'),
    'consumer_secret' => env('SF_CONSUMER_SECRET'),
    'username' => env('SF_USERNAME'),
    'password' => env('SF_PASSWORD'),
]

// В контроллере
Forrest::authenticate();
$lead = Forrest::sobjects('Lead', 'post', [
    'body' => [
        'FirstName' => $request->first_name,
        'LastName' => $request->last_name,
        'Email' => $request->email,
        'Phone' => $request->phone,
        'Company' => $request->company ?? 'Физическое лицо',
        'LeadSource' => 'Website',
        'Description' => "UTM: {$request->utm_source}/{$request->utm_campaign}"
    ]
]);

העלאת הזמנות כ-Opportunities

הזמנות מאושרות באתר שלכם הופכות ל-Opportunities ב-Salesforce, המקושרות ל-Contact/Account. זה מאפשר למנהלים לראות היסטוריית רכישות ישירות ב-CRM.

Forrest::sobjects('Opportunity', 'post', [
    'body' => [
        'Name' => "Заказ #{$order->id}",
        'AccountId' => $salesforceAccountId,
        'Amount' => $order->total / 100,
        'CloseDate' => $order->created_at->format('Y-m-d'),
        'StageName' => 'Closed Won',
        'Order_ID__c' => $order->id // кастомное поле
    ]
]);

למה הסרת כפילויות אנשי קשר היא קריטית

Salesforce מכיל לעיתים קרובות כפילויות. אתם צריכים לוגיקה: לפני יצירת Lead או Contact חדש, בדקו אם קיימים רשומות עם אותו אימייל באמצעות שאילתות SOQL.

$existing = Forrest::query( "SELECT Id, Email FROM Lead WHERE Email = '{$email}' LIMIT 1" );
if ($existing['totalSize'] > 0) {
    // Обновить существующий лид
    Forrest::sobjects("Lead/{$existing['records'][0]['Id']}", 'patch', [...]);
} else {
    // Создать новый
}

Platform Events וסנכרון דו-כיווני

Platform Events הם מנגנון למסירת אירועים בזמן אמת. הם מאפשרים סנכרון דו-כיווני: שינויים ב-Salesforce שולחים אוטומטית אירועים שהאתר שלכם יכול לקבל דרך CometD או gRPC. Platform Events מהירים פי 3 מ-Outbound Messages אך דורשים הגדרת הרשמה לאירועים בצד האתר.

לסנכרון דו-כיווני, ניתן להשתמש ב-Outbound Messages או Platform Events: Salesforce שולח webhook לאתר שלכם כאשר אובייקט משתנה. לחלופין, בצעו בדיקה כל 15 דקות: use Omniphx\Forrest\Providers\LaravelServiceProvider; // composer require omniphx/forrest // config/forrest.php 'credentials' => [ 'consumer_key' => env('SF_CONSUMER_KEY'), 'consumer_secret' => env('SF_CONSUMER_SECRET'), 'username' => env('SF_USERNAME'), 'password' => env('SF_PASSWORD'), ] // В контроллере Forrest::authenticate(); $lead = Forrest::sobjects('Lead', 'post', [ 'body' => [ 'FirstName' => $request->first_name, 'LastName' => $request->last_name, 'Email' => $request->email, 'Phone' => $request->phone, 'Company' => $request->company ?? 'Физическое лицо', 'LeadSource' => 'Website', 'Description' => "UTM: {$request->utm_source}/{$request->utm_campaign}" ] ]); דרך SOQL.

מיפוי שדות ושגיאות נפוצות

שדות מותאמים אישית ב-Salesforce נוצרים דרך Setup → Object Manager. שם ה-API של שדה מותאם אישית מסתיים ב-Forrest::sobjects('Opportunity', 'post', [ 'body' => [ 'Name' => "Заказ #{$order->id}", 'AccountId' => $salesforceAccountId, 'Amount' => $order->total / 100, 'CloseDate' => $order->created_at->format('Y-m-d'), 'StageName' => 'Closed Won', 'Order_ID__c' => $order->id // кастомное поле ] ]); (לדוגמה, $existing = Forrest::query( "SELECT Id, Email FROM Lead WHERE Email = '{$email}' LIMIT 1" ); if ($existing['totalSize'] > 0) { // Обновить существующий лид Forrest::sobjects("Lead/{$existing['records'][0]['Id']}", 'patch', [...]); } else { // Создать новый } ). שמרו מיפויי שדות בקובץ תצורה כדי להימנע משינויי קוד כאשר המבנה משתנה.

{ "site_field": "email", "sf_field": "Email", "type": "string" } 

טיפול בשגיאות ותורים

ל-API של Salesforce יש מגבלות (מגבלות קריאות ל-24 שעות). כל הבקשות ל-Salesforce צריכות לעבור דרך תור (לדוגמה, Laravel Queue/Horizon) כדי למנוע חסימת תגובת המשתמש ולנסות שוב במקרה של כשלים זמניים. עבור 500 לידים בחודש, החיסכון בהזנה ידנית עולה על $720–1k. אנו מקצרים את זמן עיבוד הלידים מ-10 דקות ל-30 שניות – הפחתה של פי 20. שגיאות שילוב יורדות ב-90% עם הגדרת תור נכונה.

מה כלול בשילוב

• ביקורת של הטפסים הנוכחיים ואובייקטי Salesforce
• יצירת Connected App והשגת OAuth token
• מיפוי שדות: אתר → Salesforce (שדות מותאמים אישית עם סיומת __c)
• תור משימות (Laravel Horizon) לבקשות API
• בדיקת סנכרון דו-כיווני
• תיעוד API והדרכה (שעתיים)
• הקצאת אישורי גישה וגישה
• 3 חודשי תמיכה
• הדרכת מנהלים על שימוש בנתונים חדשים

לוח זמנים: 4–6 שבועות לשילוב דו-כיווני מלא עם אובייקטים מותאמים אישית וסנכרון הזמנות.

התחילו עם ביקורת CRM חינמית – זה לוקח יום אחד. קבלו ייעוץ ממהנדס שילוב Salesforce שלנו – נעריך את ה-CRM שלכם ביום אחד. צרו קשר כדי לדון בפרויקט שלכם.