До 30% лидов теряются из-за того, что данные из заявок не попадают в CRM. Менеджеры тратят часы на ручной ввод. Интеграция сайта с Salesforce через REST API решает эту проблему. REST API поддерживает до 5000 запросов в сутки (Salesforce REST API Developer Guide) и в 10 раз гибче, чем Web-to-Lead. Platform Events обеспечивает двунаправленную синхронизацию в реальном времени, хотя требует более сложной настройки. Наши инженеры сертифицированы по Salesforce (PD I, App Builder) — более 5 лет опыта, 50+ проектов в ритейле и услугах.
Каждый лид, автоматически созданный в Salesforce, экономит существенную сумму на ручном вводе. Для 500 лидов в месяц экономия превышает 80 000 рублей, а время обработки заявки сокращается с 10 минут до 30 секунд.
Сравнение методов интеграции Salesforce с сайтом
| Метод | Сложность | Гибкость | Производительность | Подходит для |
|---|---|---|---|---|
| REST API (OAuth 2.0) | Средняя | Высокая | 5000 запросов/сутки* | Лендинги, интернет-магазины с кастомизацией |
| Web-to-Lead | Низкая | Низкая | Без лимита | Простые формы обратной связи |
| Platform Events | Высокая | Высокая | Ограничено лицензией | Двунаправленная синхронизация в реальном времени |
*Лимит можно увеличить, запросив у Salesforce.
Как настроить Connected App для OAuth 2.0?
- В Salesforce: Setup → App Manager → New Connected App
- Включить OAuth settings, добавить callback URL
- Выбрать scopes:
api,refresh_token - Получить 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}" ] ]); Как выгружать заказы в Salesforce (Opportunities)?
Подтверждённый заказ на сайте → Opportunity в 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 проверить наличие записи с тем же email через SOQL запросы Salesforce.
$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 для отправки событий в реальном времени. Они позволяют организовать двунаправленную синхронизацию: изменение объекта в Salesforce автоматически отправляет событие, которое сайт может получить через CometD или gRPC. Platform Events в 3 раза быстрее, чем Outbound Messages, но требуют настройки подписки на события на стороне сайта.
Двунаправленная синхронизация
Изменения в Salesforce (статус сделки, контактные данные) должны отражаться на сайте. Реализация через Outbound Messages или Platform Events: Salesforce отправляет webhook на сайт при изменении объекта. Альтернатива — периодический polling: раз в 15 минут запрашивать изменённые объекты через SELECT Id, ... FROM Lead WHERE LastModifiedDate > {timestamp} через SOQL.
Маппинг полей и типичные ошибки
Кастомные поля в Salesforce создаются через Setup → Object Manager. API-имя кастомного поля заканчивается на __c (например, UTM_Source__c). Маппинг полей сайта → поля Salesforce хранится в конфиге, чтобы не менять код при изменении структуры.
Пример маппинга полей для типового интернет-магазина
{ "site_field": "email", "sf_field": "Email", "type": "string" } | Ошибка | Причина | Решение |
|---|---|---|
| Дубликаты лидов | Нет проверки email перед созданием | SOQL-запрос перед insert |
| Ошибка 401 Unauthorized | Истёк или неверный refresh token | Обновлять токен в фоне, хранить в БД |
| Таймаут при большом числе запросов | Превышение API-лимита | Использовать очередь и дросселирование |
Обработка ошибок и очереди
Salesforce API имеет лимиты (24-часовые API call limits). Все запросы к Salesforce выполняются через очередь (Laravel Queue/Horizon), чтобы не блокировать ответ пользователю и повторять при временных ошибках. При 500 лидах ежемесячно экономия на ручном вводе превышает 80 000 рублей. Сокращаем время на обработку заявки с 10 минут до 30 секунд.
Что входит в интеграцию
- Аудит текущих форм и объектов Salesforce
- Создание Connected App и получение OAuth-токенов
- Маппинг полей: сайт → Salesforce (кастомные поля с суффиксом __c)
- Написание очереди задач (Laravel Horizon) для обработки API-запросов
- Тестирование синхронизации в обе стороны
- Документация по API и поддержка в течение 3 месяцев
- Обучение менеджеров работе с новыми данными
Срок разработки: 4–6 недель для полной двунаправленной интеграции с кастомными объектами и синхронизацией заказов.
Начните с аудита вашей CRM — это бесплатно и займет 1 день. Получите консультацию инженера по интеграции Salesforce — оценим вашу CRM за 1 день. Свяжитесь, чтобы обсудить вашу задачу.