eSputnik — CDP (Customer Data Platform) с фокусом на ecommerce: омниканальные цепочки, динамические рекомендации, abandoned cart. Интеграция с Битриксом через REST API требует понимания событийной модели eSputnik — без чёткой схемы данных синхронизация быстро превращается в хаос. За 5 лет мы провели 20+ таких интеграций и наработали проверенные решения. Типичный кейс: магазин с 50 000 товаров, где ручная сегментация отнимала по 10 часов в неделю. После интеграции — автоматические триггеры и персонализация в реальном времени.
Особенности API eSputnik
eSputnik предоставляет REST API v1 с Basic Auth (логин/пароль от аккаунта). Базовый URL: https://esputnik.com/api/v1/. Ключевое отличие от других ESP — события как основной механизм триггеров. Вместо прямого управления рассылками мы отправляем события (order placed, cart updated, page viewed) — eSputnik сам строит автоматизации на их основе. Это похоже на вебхуки, но с собственной очередью и ретраями. Сравните: ручная настройка триггеров по сегментам в MailChimp занимает часы, в eSputnik — минуты.
Как синхронизировать контакты через REST API?
Первый шаг — API-клиент для upsert контактов. В нашем коде мы заворачиваем вызов в класс ESputnikClient и передаём channels (email) и fields (кастомные поля). Номера полей (id: 1, 2, 3) берутся из настроек аккаунта eSputnik — раздел «Контакты → Дополнительные поля». Важно: если поле не заполнено, не передавайте его вовсе — eSputnik перезаписывает существующее значение пустотой.
class ESputnikClient { private string $login; private string $password; private string $baseUrl = 'https://esputnik.com/api/v1/'; public function upsertContact(array $contactData): array { $http = new \Bitrix\Main\Web\HttpClient(); $auth = base64_encode($this->login . ':' . $this->password); $http->setHeader('Authorization', 'Basic ' . $auth); $http->setHeader('Content-Type', 'application/json'); $http->setHeader('Accept', 'application/json'); $payload = [ 'contacts' => [[ 'channels' => [ ['type' => 'email', 'value' => $contactData['email']], ], 'fields' => [ ['id' => 1, 'value' => $contactData['first_name'] ?? ''], ['id' => 2, 'value' => $contactData['last_name'] ?? ''], ['id' => 3, 'value' => $contactData['phone'] ?? ''], ], ]], ]; return json_decode($http->post($this->baseUrl . 'contact', json_encode($payload)), true); } } Почему события eSputnik эффективнее стандартных email-триггеров?
Обычные ESP заставляют вас вручную собирать сегменты и привязывать рассылки. eSputnik использует событийную шину: вы просто отправляете событие с параметрами, а платформа решает, кому и когда доставить письмо. Это позволяет строить цепочки вроде «Если пользователь не кликнул в письме с рекомендациями через 3 дня, отправить SMS с купоном» без написания кода на стороне Битрикса. Кроме того, eSputnik автоматически дедуплицирует контакты и управляет частотой отправки, снижая риск попадания в спам.
Вот как мы отправляем события ecommerce:
public function sendEvent(string $email, string $eventTypeKey, array $params): void { $http = new \Bitrix\Main\Web\HttpClient(); // ... auth headers $payload = [ 'eventTypeKey' => $eventTypeKey, 'keyValue' => $email, 'params' => array_map(fn($k, $v) => ['name'=>$k,'value'=>$v], array_keys($params), $params), ]; $http->post($this->baseUrl . 'event', json_encode($payload)); } // Событие: заказ оформлен $esp->sendEvent($email, 'OrderCreated', [ 'orderId' => $orderId, 'orderTotal' => $orderTotal, 'currency' => 'USD', 'items' => json_encode($orderItems), // JSON-строка с товарами ]); // Событие: товар добавлен в корзину $esp->sendEvent($email, 'CartUpdated', [ 'cartTotal' => $cartTotal, 'items' => json_encode($cartItems), ]); Кейс из нашей практики: динамические рекомендации в письмах
Ситуация. Магазин спортивного питания, 15 000 активных покупателей. Задача: персонализированные письма с рекомендациями на основе истории покупок.
Реализация. Мы сгенерировали товарный фид в формате XML/Google Shopping из каталога Битрикса и опубликовали по защищённому URL. eSputnik принимает фид и использует collaborative filtering для отбора товаров. В редакторе писем блок «Рекомендации» автоматически подставляет подборку для каждого получателя на момент открытия (real-time рендеринг).
// /bitrix/components/custom/esputnik.feed/component.php $products = CIBlockElement::GetList( ['SORT' => 'ASC'], ['IBLOCK_ID' => CATALOG_IBLOCK_ID, 'ACTIVE' => 'Y', 'CATALOG_AVAILABLE' => 'Y'], false, ['nTopCount' => 10000], ['ID', 'NAME', 'DETAIL_PAGE_URL', 'PREVIEW_PICTURE', 'PROPERTY_PRICE_RRP', 'PROPERTY_BRAND'] ); header('Content-Type: application/xml'); // ... Результат: CTR вырос с 2.1% до 6.8% за 3 месяца. ROI составил 5:1 за счёт автоматизации и сегментации. Средний показатель открываемости увеличился на 15%.
Как настроить товарный фид для eSputnik?
Товарный фид — это XML-файл, который eSputnik периодически загружает для построения рекомендаций. Мы генерируем его на лету через компонент Битрикса, фильтруя только активные и доступные товары. В фид включаем идентификатор, название, ссылку, изображение, цену и бренд. Пример структуры:
<feed> <entry> <id>12345</id> <name>Протеин Whey Gold</name> <url>https://example.com/product/12345</url> <image>https://example.com/upload/iblock/abc.jpg</image> <price currency="RUR">1990.00</price> <brand>Optimum Nutrition</brand> </entry> </feed> Фид обновляется каждые 60 минут через агент Битрикса. eSputnik поддерживает до 100 000 товаров в фиде — для больших каталогов используем инкрементальную загрузку через API.
Группы контактов и сегментация
eSputnik поддерживает сегментацию по полям контакта и событиям. Из Битрикса мы передаём поля: дата последнего заказа (для реактивации), общая сумма покупок (VIP-сегмент), категории купленных товаров (тематические рассылки). Пример сегмента: «пользователи, совершившие более 3 покупок на сумму > $90–130. за последние 90 дней».
| Задача | Трудозатраты |
|---|---|
| API-клиент + синхронизация контактов | 4–5 ч |
| События ecommerce (заказ, корзина, просмотр) | 6–8 ч |
| Товарный фид для рекомендаций | 4–6 ч |
| Настройка триггерных цепочек в eSputnik | 4–8 ч |
Пример обработки ошибок при синхронизации
При сетевых сбоях используем ретраи с экспоненциальной задержкой (максимум 3 попытки). Логируем неудачные вызовы в таблицу b_esputnik_log для последующего анализа.
public function upsertContactWithRetry(array $data, int $retries = 3): array { for ($i = 0; $i < $retries; $i++) { try { return $this->upsertContact($data); } catch (\Exception $e) { if ($i === $retries - 1) throw $e; sleep(pow(2, $i)); } } } Что входит в работу
- Разработка API-клиента с поддержкой рекурсивной синхронизации (обработка ошибок, ретраи, логирование).
- Настройка событий ecommerce: оформление заказа, корзина, просмотр товара, регистрация.
- Генерация товарного фида с кастомными полями (бренд, категория, цена).
- Создание сегментов в eSputnik и привязка к цепочкам.
- Тестирование сценариев и мониторинг доставки.
- Документация по администрированию системы.
Мы гарантируем правильную передачу данных и корректную обработку всех состояний (отмена заказа, возврат). После завершения передачи мы остаёмся на поддержке — чиним ошибки, обновляем под новые версии API.
Свяжитесь с нами — оценим ваш магазин за 1 день и предложим оптимальную архитектуру интеграции. Закажите пилот: мы подключим отправку одного события и покажем, как это работает в вашем контуре.
eSputnik API Documentation: https://esputnik.com/api/v1/docs